Skill Creator

Create Agent Skills following the official specification.

Skill Structure

skill-name/
├── SKILL.md              # Required
└── [optional]
    ├── scripts/          # Executable code
    ├── references/       # Documentation
    └── assets/           # Templates, resources

SKILL.md Template

---
name: skill-name
description: What the skill does and when to use it (max 1024 chars). Include specific use cases and triggers.
---

# Skill Title

Brief introduction to the skill.

## Section 1

Content with code examples...

```language
code example

Best Practices

1. Keep clear and focused
2. Include practical examples
3. Reference official docs

Resources

• Link to docs

## Frontmatter Rules

### Required Fields

```yaml
name: skill-name          # Max 64 chars, lowercase, hyphens only
description: Complete description of what skill does and when to use it

Optional Fields

license: MIT              # License identifier
metadata:
  author: team-name
  version: "1.0.0"
  tags: [angular, typescript]

Name Requirements

• Max 64 characters
• Lowercase letters, numbers, hyphens
• Cannot start/end with hyphen
• Examples: angular-component, docker-basics

Description Requirements

• Max 1024 characters
• Non-empty
• Describe WHAT and WHEN
• Include specific triggers
• Example: “Create standalone Angular components with signal inputs/outputs. Use when creating components, refactoring to standalone, or implementing OnPush change detection.”

Content Guidelines

1. Keep focused – One topic per skill
2. Under 500 lines – Move details to references/
3. Include examples – Practical, working code
4. Add resources – Link to official docs
5. Use clear sections – Organize logically

Validation

# Install validator
npm install -g @agentskills/skills-ref

# Validate skill
skills-ref validate path/to/skill

# Generate prompt XML
skills-ref generate path/to/skill

Best Practices

1. Start with examples – Understand use cases
2. Be concise – Claude is smart, avoid over-explaining
3. Focus on procedural knowledge – Not general facts
4. Progressive disclosure – Core in SKILL.md, details in references/
5. Test the skill – Use it with Claude/agent
6. Iterate based on usage – Improve from real use

Common Mistakes to Avoid

❌ Name with uppercase: Angular-Component ✅ Correct: angular-component

❌ Description too short: “Angular components” ✅ Good: “Create standalone Angular components with signal inputs. Use when…”

❌ Too long (>500 lines) ✅ Split into references/

❌ Missing examples ✅ Include working code

Resources

• Agent Skills Spec: https://agentskills.io/specification
• GitHub: https://github.com/agentskills/agentskills
• Examples: https://github.com/analogjs/angular-skills