skill-generator
Use when asked to create, generate, author, or bootstrap a NEW skill from a natural-language description. Turns "make me a skill that does X" into a stored SKILL.md by drafting valid frontmatter + body and writing it with the existing write_skill tool — dogfooding the skill system.
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 4
- Forks
- 0
01 前言 Front Matter
- name
- skill-generator
- description
- Use when asked to create, generate, author, or bootstrap a NEW skill from a natural-language description. Turns "make me a skill that does X" into a stored SKILL.md by drafting valid frontmatter + body and writing it with the existing write_skill tool — dogfooding the skill system.
03 SKILL.md 正文
Skill Generator
Generate a new, reusable skill from a description and store it. The skill system
already owns storage (write_skill → ~/.vanta/skills/<slug>/SKILL.md); this
skill is the authoring discipline that feeds it. Do NOT hand-roll a file write.
When to use
The user describes a capability they want captured as a skill: "create a skill that summarizes PRs", "make a skill for our deploy checklist", "bootstrap a skill from this description".
Steps
- Read the description. Extract the skill's purpose and WHEN it should fire.
- Draft three fields:
name— a short kebab-case slug (lowercase, hyphens, no spaces). This becomes the directory; keep it slug-safe (no/, no..).description— ONE sentence stating when to use the skill. This is whatrecallmatches against, so lead with the trigger ("Use when …").body— a Markdown how-to: a# Title, then concise numbered steps or rules. Write the procedure, not prose about it.
- Write it with the existing tool. Call
write_skillwith{ name, description, body }(and optionaltags). That persists and commits theSKILL.mdand wires it into the registry — it appears in/skillsand is recallable next session. Never write the file by hand. - Confirm. Report the stored slug and path from the tool result.
Rules
- One concern per skill. A description spanning several jobs → several skills.
- The
descriptionis the index entry — make it specific and trigger-first. - The
bodymust let an agent reproduce the behavior WITHOUT re-asking. No TODOs or placeholders. - Reuse existing skills before generating a near-duplicate (
recallfirst).
Reference
write_skilltool — the storage path (do not reimplement it).skills/skill-gen.ts— purebuildSkillFromDescription/parseSkillModelOutput(prompt builder + JSON→{name, description, body}validator, kebab-validated so the path can't escape) if generating programmatically rather than authoring inline.skills/store.tswriteSkill— preservescreated, bumpsupdated.
Verification
- After
write_skill, the new skill shows in/skillsandrecallfinds it by its description. - The stored frontmatter has
name,description,created,updated,tags.
04 同仓库更多 Skills
write-changelog
Turn a range of commits into a user-facing changelog
debug-flaky-test
Reproduce and isolate a flaky test before fixing it
triage-incident
First 10 minutes of an incident — stabilize, then diagnose
writing-plans
Write implementation plans: bite-sized tasks, paths, code.
vanta-port-adapter
暂无简介
test-driven-development
TDD: enforce RED-GREEN-REFACTOR, tests before code.