tomevault-io Skill Creator
Agent Workflow (MANDATORY)
Before ANY skill creation, use TeamCreate to spawn 3 agents:
- fuse-ai-pilot:explore-codebase - Check existing skills, analyze structure
- fuse-ai-pilot:research-expert - Fetch latest official documentation online
- mcp__context7__query-docs - Get code examples from official sources
After creation, run fuse-ai-pilot:sniper for validation.
Overview
| Action | When to Use |
|---|---|
| New Skill | Library/framework not yet documented |
| Restructure | Existing skill doesn't follow pattern |
| Improve | Missing references or outdated content |
| Adapt | Copy from similar skill (Next.js → React) |
Critical Rules
- ALL content in English - Never French or other languages
- SKILL.md is descriptive - Guides agent to references/templates
- References are conceptual - WHY + WHEN, max 150 lines
- Templates are complete - Copy-paste ready code
- Register in agent + marketplace.json - Or skill won't load
- Run sniper after creation - Validate all files
Architecture
skills/<skill-name>/
├── SKILL.md # Entry point (guides agent)
└── references/ # All documentation
├── installation.md # Setup, configuration (conceptual)
├── patterns.md # Core patterns (conceptual)
├── ... # Other references
└── templates/ # Complete code examples
├── basic-setup.md # Full project setup
└── feature-example.md # Feature implementation
→ See architecture.md for details
Reference Guide
Concepts
| Topic | Reference | When to Consult |
|---|---|---|
| Workflow | workflow.md | Creating/improving skills |
| Architecture | architecture.md | Understanding skill structure |
| Content Rules | content-rules.md | Writing references/templates |
| Registration | registration.md | Making skill available |
| Adaptation | adaptation.md | Converting between frameworks |
Templates
| Template | When to Use |
|---|---|
| SKILL-template.md | Creating new SKILL.md |
| reference-template.md | Creating reference files |
| template-template.md | Creating code templates |
Quick Reference
Create New Skill
# 1. Research documentation
→ research-expert + context7/exa
# 2. Create structure
mkdir -p plugins/<agent>/skills/<name>/references/templates
# 3. Create files
→ SKILL.md (from template)
→ references/*.md (conceptual)
→ references/templates/*.md (code)
# 4. Register
→ agent frontmatter + marketplace.json
# 5. Validate
→ sniper
Improve Existing Skill
# 1. Analyze
→ explore-codebase
# 2. Research updates
→ research-expert (latest docs)
# 3. Add missing files
→ references + templates
# 4. Validate
→ sniper
Validation Checklist
- ALL content in English
- SKILL.md has proper frontmatter
- All references listed in frontmatter
- Agent Workflow section present
- Reference Guide has Concepts + Templates tables
- References < 150 lines each
- Templates have complete, working code
- Registered in agent + marketplace.json
Best Practices
DO
- Research official docs before writing
- Use tables for organization
- Link references to templates
- Keep references conceptual
- Make templates copy-paste ready
DON'T
- Write in French (English only)
- Copy-paste raw documentation
- Exceed 150 lines in references
- Forget registration step
- Skip sniper validation
Converted and distributed by TomeVault — claim your Tome and manage your conversions.