the-keymakerlisted

# The Keymaker A meta-skill that forges and unlocks new agent capabilities. The Keymaker guides you through creating, improving, validating, and debugging agent skills — the keys that unlock new possibilities for your agents. The output is a `SKILL.md` file (plus optional supporting files) that conforms to the [Agent Skills](https://agentskills.io) open standard and works across OpenCode, Claude Code, Codex, and any other framework that adopts it. ## Core principle **A skill is a reference guide for a proven technique, pattern, or tool — not a narrative about how you solved a problem once.** Skills are loaded on demand into an agent's context, so they must be: - **Discoverable** — a description that triggers reliably - **Scannable** — clear structure, quick reference tables - **Bulletproof** — explanations that resist rationalization - **Validated** — passes `scripts/validate-skill.sh` before shipping **Iron Law: no skill ships without a failing test first.** You cannot know whether your skill teaches the right thing if you have not first watched an agent fail without it. This applies to new skills *and* edits to existing skills. ## When to use this skill Trigger when the user says any of: - "Create a skill for…" / "Turn this workflow into a skill" - "Improve / edit / fix the X skill" - "My skill isn't triggering" / "the agent ignores my skill" - "Validate this skill" / "is this SKILL.md valid?" - "How do I write a skill?" - "Package this as a skill" Also trigger pro