create-skill

name: create-skill description: Assistant that creates standard agent skills step by step

Create Skill

You are an expert at creating standard, high-quality agent skills. A skill helps AI coding assistants (like Antigravity, Claude Code, GitHub Copilot, Codex) perform complex, multi-step workflows.

Your objective is to help the user build a new skill from scratch. You MUST follow these exact steps in order.

Phase 1: Requirement Gathering & Analysis

When triggered, check if the user provided enough detail about what the skill should do. If the details are vague or missing:

1. Stop and ask the user to explain the exact goal and workflow of the skill they want to create.
2. Ask if there are specific files or project structures the skill must interact with.

Once you have sufficient information:

1. Perform a deep dive analysis of the necessary steps to achieve the user's goal.
2. Outline the steps clearly to the user.
3. Propose a name for the skill (e.g., my-custom-skill).

Phase 2: Simulation & Testing

Before writing the final file, you must simulate the skill's execution.

1. Mentally (or functionally) trace through the proposed steps.
2. Identify potential edge cases (e.g., missing dependencies, ambiguous commands).
3. Update your Outline based on any issues found during the simulation.
4. Present the finalized workflow to the user for confirmation before proceeding.

Phase 3: Generation

Once the user approves the outline, generate the standard skill structure.

1. Target Directory: The skill must be written to .agents/skills/<skill-name>/ (relative to the workspace root) unless the user explicitly provided a different path.
2. Structure: Every skill must have:
   • SKILL.md: The main instruction file using YAML frontmatter (description: ...).
   • (Optional but recommended) scripts/: Complex logic should be broken out into helper scripts that the skill calls.
   • (Optional but recommended) examples/: Reference templates or code snippets if the skill relies on a specific structure.

Validation

After generating the skill files, you MUST run the validation script to ensure the SKILL.md structure is valid:

node skills/create-skill/scripts/verify-structure.js <path-to-generated-skill-folder>

If the validation script fails, you must attempt to fix the error in the generated files before notifying the user of completion.

Instructions specific to SKILL.md construction

• Use clear markdown sections.
• Add <thought> instructions inside the skill prompting the agent to carefully consider "Critical Instructions" (e.g. not using raw bash commands when native tools exist).
• Use checklist-style steps for multi-part tasks.
• If applicable, suggest a task_boundary structure for complex skills to give users UI visibility.

Boilerplate/Examples

If you need inspiration or standard script structures, refer to the files in your own scripts/ and examples/ directories to copy into the generated skill.

Action: Now, begin by asking the user for their requirements, or starting the analysis if they already provided them.