AgentSkillsCN

skill-scaffold-generator

依据获批的演进方案,自动生成新的技能文件夹与 SKILL.md 草稿,并严格执行项目标准。

SKILL.md
--- frontmatter
name: skill-scaffold-generator
description: Generates new skill folders and SKILL.md drafts from approved evolution proposals, enforcing project standards.
triggers: [skill-proposal-approved, manual-skill-creation]
outputs: [new-skill-directory, standardized-skill-md]

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-proposal is approved
  • When manually adding a new capability to the system
  • When refactoring a large skill into smaller, focused ones

Scaffolding Steps

  1. Create Directory: Establish the folder in either global_skills/ or .agent/skills/.
  2. Generate frontmatter: Include name, description, triggers, outputs, and depends_on.
  3. Draft SKILL.md: Use the standard sections: Purpose, When to Use, Instructions (Steps), Decision Tree, Review Checklist, and Feedback Guidelines.
  4. Register for Audit: Trigger orchestrator-self-auditor to 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

  1. Focus: Does the new skill do exactly one thing?
  2. Completeness: Are all 6 standard sections present in the SKILL.md?
  3. Logic: Is there a Mermaid decision tree for complex paths?
  4. Black Box Compliance: If scripts exist, is the --help instruction 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.