Skill Scaffold Generator
Purpose
Ensures that every new skill in the Antigravity ecosystem starts with a high-quality, standardized structure. This skill prevents "thin" or "vague" skills from entering the codebase.
When to use this skill
- •Immediately after a
skill-evolution-proposalis approved - •When manually adding a new capability to the system
- •When refactoring a large skill into smaller, focused ones
Scaffolding Steps
- •Create Directory: Establish the folder in either
global_skills/or.agent/skills/. - •Generate frontmatter: Include
name,description,triggers,outputs, anddepends_on. - •Draft SKILL.md: Use the standard sections: Purpose, When to Use, Instructions (Steps), Decision Tree, Review Checklist, and Feedback Guidelines.
- •Register for Audit: Trigger
orchestrator-self-auditorto update the controller.
Decision Tree
mermaid
flowchart TD
A[Start Generation] --> B{Approved Proposal?}
B -->|No| C[Abort - Need Proposal]
B -->|Yes| D{Skill Scope?}
D -->|Global| E[Create in global_skills/]
D -->|Workspace| F[Create in .agent/skills/]
E --> G[Generate SKILL.md with decision tree]
F --> G
G --> H[Encourage --help for scripts]
H --> I[Final Review]
Review Checklist
- •Focus: Does the new skill do exactly one thing?
- •Completeness: Are all 6 standard sections present in the
SKILL.md? - •Logic: Is there a Mermaid decision tree for complex paths?
- •Black Box Compliance: If scripts exist, is the
--helpinstruction included?
How to provide feedback
- •Be specific: "The generated skill is missing the 'How to provide feedback' section."
- •Explain why: "Standardized feedback ensures the Agent provides actionable advice during development."
- •Suggest alternatives: "Recommend re-running the generator with the '--template-v2' flag."
Generated skills must follow antigravity standards.