skill-builder
Installation
SKILL.md
/skill-builder — Scaffold or absorb a new SKILL.md
Materializes a new skill against the unified template at references/skill-template.md (extracted from anthropics/financial-services). Runs skill-auditor on the new skill as a self-check before declaring success.
⚠️ Critical Constraints
- Template is canonical. All four modes produce SKILL.md files conforming to
references/skill-template.md. Do not invent ad-hoc structures. Why:skill-auditorvalidates against this template; drift creates auditor false-fails. - Self-audit is mandatory. After every successful build, the build script invokes
/skill-auditoragainst the new skill directory. A FAIL verdict aborts the build. Why: PR-002 (external validation gate) — the builder must not declare its own work complete. - Codex parity is day-1, not later.
from-scratch,from-template, andabsorb-externalmodes must produce bothskills/<name>/SKILL.mdANDskills-codex/<name>/SKILL.md+skills-codex/<name>/prompt.md. Why: finding2026-05-03-codex-skill-shape-is-dual-file— codex SKILL.md uses slim frontmatter (noskill_api_version); prompt.md is mandatory;audit-codex-parity.shis a content scanner that won't catch frontmatter drift. - 250-line ceiling on new SKILL.md. Use
references/for overflow. Why: findingf-2026-05-01-025— every Skill() invocation reloads 5-15KB; multi-lifecycle sessions compound to 150-200KB+ pure scaffolding.
Modes
| Mode | Status | Description |
|---|---|---|
from-scratch |
stable | Interactive scaffold from canonical template. Produces full skill skeleton + scripts/validate.sh + codex parity. |
from-template |
stable | --like <existing-skill> copies structure from a sibling skill, swaps domain-specific sections. |
absorb-external |
stable | Reads external SKILL.md (e.g., from ~/dev/financial-services/.../<skill>/SKILL.md), wraps in AgentOps frontmatter, invokes /converter for codex parity. |
from-pattern |
alpha (passthrough) | Delegates to ao flywheel close-loop. Outputs land at .agents/knowledge/promoted/ per flywheel rules — they are NOT yet shaped as SKILL.md drafts. v2 will add skill-specific synthesis. Use from-scratch or absorb-external for SKILL.md output today. |
Related skills