bm-skill-builder

Turns a repeatable process into a well-built agent skill: instructions in plain markdown and folders, portable across any agent harness. Works for brand-new skills and for restructuring existing ones that have outgrown a single SKILL.md.

The process

1. Understand the process — steps/understand.md: ask the user to describe the process the skill is for, then infer what you can — job, inputs, artifact, raw material.
2. Interview the user — steps/interview.md: design the skill with the user — description, name, inputs (if any), its own interview (if any), realistic examples (if applicable), and the step plan. Recommend-then-confirm format throughout.
3. Design the shape — steps/design.md: simple or structured, per the conventions.
4. Build it — steps/build.md: write the files against the conventions checklist.
5. Save it — steps/save.md: ask where the skill should live — this repo's .agents/skills/, global ~/.agents/skills/, or a .claude alternate — and place it there.
6. Verify & hand off — steps/verify.md: run it from its saved location, then teach the user the improvement loop.

Hard rules