dance-lessons-coach/.vibe/skills/skill-creator/SKILL.md

name, description, license, metadata

name	description	license	metadata
skill-creator	Creates and manages Mistral Vibe skills following the Agent Skills specification. Use when you need to create new skills, validate existing ones, or maintain skill consistency across projects.	MIT	author version dance-lessons-coach Team 1.0.0

Skill Creator

A skill for creating and managing Mistral Vibe skills that comply with the Agent Skills specification.

Commands

Create a new skill

skill_creator create <skill_name>

Creates a new skill scaffold with proper directory structure and SKILL.md file.

Arguments:

• skill_name: Name of the skill to create (required)

Validate a skill

skill_creator validate <skill_path>

Validates that a skill follows the Agent Skills specification.

Arguments:

• skill_path: Path to the skill directory (required)

Workflows

Complete skill creation workflow

1. Gather requirements: Determine skill name, description, and purpose
2. Scaffold structure: Create directory structure with SKILL.md
3. Generate templates: Create optional directories (scripts/, references/, assets/)
4. Validate structure: Ensure compliance with specification
5. Document skill: Add comprehensive instructions to SKILL.md

Usage Examples

Creating a BDD testing skill

# Create the skill
skill_creator create bdd-testing

# Navigate to the skill directory
cd .vibe/skills/bdd-testing

# Edit the SKILL.md file
# Add your BDD-specific instructions and workflows

Validating an existing skill

skill_creator validate .vibe/skills/skill-creator

Skill Structure

A properly structured skill should have:

skill-name/
├── SKILL.md          # Required: metadata + instructions
├── scripts/          # Optional: executable code
├── references/       # Optional: documentation
├── assets/           # Optional: templates, resources
└── ...               # Any additional files

Best Practices

Follow the Skill Creation Best Practices for creating high-quality skills:

1. Start from real expertise: Base skills on actual project knowledge
2. Refine with execution: Test and improve based on real usage
3. Spend context wisely: Focus on what the agent wouldn't know
4. Design coherent units: One skill = one class of problems
5. Use instruction patterns: Gotchas, templates, checklists, validation loops
6. Calibrate control: Match specificity to task fragility
7. Progressive disclosure: Keep SKILL.md < 500 lines, move details to references/

See BEST_PRACTICES.md for comprehensive guidelines.

Advanced Features

For advanced skill management, see ADVANCED_FEATURES.md:

• Skill Versioning: Semantic versioning and lifecycle management
• Dependencies: Manage skill dependencies and compatibility
• Composite Skills: Combine multiple skills for complex workflows
• Testing & Validation: Advanced validation levels and test automation
• Documentation Standards: Maturity levels and completeness checklists
• Governance: Ownership models and team collaboration
• Analytics: Usage tracking and impact measurement
• Publication: Release workflows and distribution channels

These advanced features transform skill_creator from a basic scaffolding tool to a comprehensive skill management platform.