skill-builder

name	skill-builder
description	Create a metadata-complete AgentOps skill source package, regenerate its derived projections, and check or repair structural hygiene in skill packages. Triggers: "create a skill", "scaffold skill", "absorb external skill", "new skill", "heal skill", "repair skill hygiene", "audit skill structure", "check skill package".
practices	["pragmatic-programmer","refactoring"]
hexagonal_role	supporting
consumes	[]
produces	["skill-source-package","skill-hygiene-report"]
context_rel	[]
skill_api_version	1
context	{"window":"fork","intent":{"mode":"questions"},"sections":{"exclude":["HISTORY"]},"intel_scope":"topic"}
metadata	{"capabilities":["skill_builder","heal_skill"],"effects":["write_skill_source","write_build_report","regenerate_skill_projections","repair_skill_projections"],"canonical_status":"canonical","disposition":"keep_specialist","tier":"meta","dependencies":[],"stability":"experimental"}
output_contract	skills/skill-builder/schemas/build-report.json (create/build) or skills/skill-builder/schemas/audit-report.json (audit)

Skill Builder — Create, heal, and audit skill packages

skill-builder owns the full structural lifecycle of one skills/<slug>/ source package: create it, verify its structure, repair owned projections, and audit its content discipline. It does not schedule work, allocate writers, operate Git, validate a software candidate, promote learnings, or decide what happens after a failure.

Before creating a new root, search skills/*/SKILL.md for an existing owner. Extend an existing skill when it already owns the requested behavior.

Modes

Trigger phrases	Mode	Entry point
"create a skill", "scaffold skill", "new skill"	create (build)	scripts/build.sh
"absorb external skill"	create (absorb-external)	scripts/build.sh
"check skill package"	check	scripts/heal.sh --check [--strict]
"heal skill", "repair skill hygiene"	heal	scripts/heal.sh --fix
"audit skill structure"	audit	scripts/audit.sh

Constraints

• Create exactly one source package because metadata must have one canonical owner.
• Treat external skills as structural signals only because clean-room output must not copy names, prose, prompts, scripts, or examples.
• Regenerate projections once and stop because validation, revision, Git, and delivery remain caller-owned.
• Check and audit modes never mutate files; fix mode changes only an explicit source target and its owned projections, because source behavior remains human-authored.

Create mode

Choose exactly one build input:

• from-scratch <slug> creates a blank source package.
• from-template <slug> --like <existing-slug> uses the existing skill only for metadata defaults; it does not copy its prose.
• absorb-external <slug> --from <path> verifies the source exists, then creates a clean-room blank package without copying names, prose, prompts, scripts, or examples.

The caller may set SKILL_TIER, SKILL_DEPENDENCIES, SKILL_CAPABILITIES, and SKILL_EFFECTS. Values that represent lists must be JSON arrays.