Loading...
Loading...
Guidelines for creating well-structured AI agent skills. Use when building a new skill, reviewing skill quality, or unsure how to organize a skill.
npx skill4agent add bonkey/skills skills-manualreferences/skill-builder-guide.mdyour-skill-name/ # kebab-case, no spaces, no capitals, no underscores
SKILL.md # Required — must be exactly this name (case-sensitive)
references/ # Optional — supporting docs loaded on demand
scripts/ # Optional — executable code
assets/ # Optional — templates, iconsSKILL.mdskill.mdSKILL.MDREADME.mdnotion-project-setup---
name: your-skill-name # Required — kebab-case, must match folder name
description: "What and when." # Required — max 1024 chars, no < > brackets
license: MIT # Optional
allowed-tools: "Bash(python:*) WebFetch" # Optional — restrict tool access
metadata: # Optional
author: Name
version: 1.0.0
---<>description: "Manages Linear project workflows including sprint planning,
task creation, and status tracking. Use when user mentions 'sprint',
'Linear tasks', 'project planning', or asks to 'create tickets'."description: "Helps with projects."---
name: your-skill
description: [...]
---
# Skill Name
## Instructions
Step-by-step workflow with clear actions.
## Examples
Common scenarios with expected inputs/outputs.
## Troubleshooting
Common errors, causes, and fixes.references/api-guide.mdreferences/| Signal | Meaning | Fix |
|---|---|---|
| Skill doesn't load when it should | Undertriggering | Add more trigger phrases and keywords to description |
| Skill loads for unrelated queries | Overtriggering | Add negative triggers, narrow scope |
| Claude doesn't follow instructions | Too verbose or ambiguous | Use bullet points, be explicit, move detail to references |
| Inconsistent results | Missing examples or validation | Add examples, error handling, quality checks |