leeway-skill-factory
Governed intake, normalization, deduplication, validation, promotion, and retirement workflow for skills, MCP tools, and adapters discovered across LeeWay repositories and authorized hosts. Use when b
SKILL.mdskills/leeway-skill-factory/SKILL.md
GitHubLeeWay Skill Factory
Purpose
The factory converts discovered capability material into canonical, portable, tested LeeWay assets. It does not bulk-copy directories and it does not call a package, configuration file, prompt, or generated stub a live MCP.
Intake states
Every candidate occupies exactly one state:
DISCOVERED → TRIAGED → NORMALIZED → VALIDATED → PROMOTED
Alternate terminal states are DUPLICATE, CONFLICTING, BLOCKED, QUARANTINED, DEPRECATED, and RETIRED.
Record separately:
- source path or repository and observed revision;
- content identity or hash when available;
- capability class:
SKILL | MCP_SERVER | MCP_TOOL | ADAPTER | CONTRACT | GENERATED_STUB; - authority conflicts and hard-coded host assumptions;
- dependency and secret requirements;
- validation command and result;
- runtime health evidence, if any.
Promotion workflow
- Verify the canonical repository and current authority before changes.
- Inventory sources read-only. Never infer live status from a filename or registry entry.
- Deduplicate by semantics and content identity, not only by folder name.
- Reject or repair instructions that claim higher authority than Creator/Human Authority or LeeWay Standards.
- Remove machine-specific paths from portable skills; place host bindings behind the Tool Gateway.
- Normalize skills to valid
SKILL.mdfrontmatter and concise procedural instructions. - Give MCP tools deterministic schemas, explicit evidence boundaries, input validation, and tests.
- Run the smallest relevant build, unit, protocol, and health checks.
- Commit to a review branch with receipts. Promote to
mainonly after required checks are trustworthy.
Truth law
Use these distinctions:
PRESENTmeans an artifact exists.CONFIGUREDmeans a registry or configuration names it.BUILTmeans compilation/package construction passed.PROTOCOL_VERIFIEDmeans an MCP handshake/list/call path passed.LIVEmeans a currently reachable executor returned fresh health evidence.VERIFIEDmeans the requested behavior passed an applicable test with inspectable evidence.
No lower state implies a higher one.
Capability-universe rule
The capability universe is a governed inventory, not a monolithic runtime. Keep all verified metadata eligible for routing through the Universal Capability Kernel, but activate only the smallest task-relevant execution weave.
Update config/leeway-capability-universe.json when a discovery or promotion materially changes the known inventory.
Receipts
A promotion receipt should bind source, destination, commit, validation commands, outcomes, unresolved risks, and whether the artifact is merely portable or actually live on a host.