Guide for creating effective skills. Use when creating a new skill or updating an existing skill that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
Create modular, self-contained packages that extend AI capabilities with specialized knowledge and workflows.
Challenge each piece: "Does Claude really need this?" Prefer concise examples over verbose explanations.
skill-name/
├── SKILL.md (required)
│ ├── YAML frontmatter (name, description)
│ └── Markdown instructions
└── Bundled Resources (optional)
├── scripts/ - Executable code
├── references/ - Documentation
└── assets/ - Templates, icons
---
name: my-skill
description: What it does AND when to use it (critical for triggering)
---
# Title
[Core instructions - imperative form]
## Sections as needed
| Do | Don't | |----|-------| | Clear, comprehensive description | Vague one-liner | | Imperative form ("Create", "Run") | Passive voice | | Concise examples | Verbose explanations | | Reference files for details | Everything in SKILL.md | | Test scripts by running them | Assume they work |
Search for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Start voice calls via the OpenClaw voice-call plugin.
Notion API for creating and managing pages, databases, and blocks.
Gemini CLI for one-shot Q&A, summaries, and generation.
Category:developer