ag-kit: Skill for Claude Code

Skillify — Auto-Create Skills from Workflows

Turn repetitive patterns into reusable skills. If you've done it three times, it should be a skill.

When to Skillify

✅ Good candidates:

• You've seen the user ask for the same type of work 3+ times
• A workflow involves 5+ consistent steps
• The pattern works across different projects
• Other agents could benefit from this knowledge

❌ Bad candidates:

• One-off tasks (just do them)
• Project-specific hacks (use memory instead)
• Already covered by existing skills (check first)

---

Skill Creation Protocol

Step 1: Identify the Pattern

What triggers this workflow? (user says X, file type Y, domain Z)
What steps are always the same?
What parts vary between uses?
What's the expected output?

Step 2: Generate SKILL.md

Use this template:

---
name: [kebab-case-name]
description: [One sentence describing what this skill does]
when_to_use: "[When the user asks X, works with Y files, or Z domain. NOT for A.]"
allowed-tools: [Read, Write, Edit, Grep, Glob, Bash — only what's needed]
effort: [low | medium | high]
---

# [Skill Name] — [Short Subtitle]

> [One-line philosophy or principle]

## Overview
[2-3 sentences explaining what this skill enables]

## When to Use
✅ Good for: [list]
❌ Not for: [list]

## Protocol
### Step 1: [First Action]
[Instructions]

### Step 2: [Second Action]
[Instructions]

### Step N: [Verification]
[How to verify the skill worked correctly]

## Best Practices
[3-5 key rules]

Step 3: Place the Skill

.agents/skills/[skill-name]/SKILL.md

Step 4: Verify

• Frontmatter has all required fields (name, description, when_to_use)
• when_to_use clearly defines triggers AND exclusions
• Steps are actionable, not vague
• Skill doesn't duplicate an existing one

---

Naming Conventions

Pattern	Skill Name	Example
Action-based	[verb]-[noun]	verify-changes, batch-operations
Domain-based	[domain]-[aspect]	database-design, api-patterns
Tool-based	[tool]-patterns	tailwind-patterns, prisma-expert