Creating Agent Skills
Expert guidance for creating, writing, and refining Claude Code Skills. Use when working with SKILL.md files, authoring new skills, improving existing skills, or understanding skill structure and best practices.
Install
npx skills add ratacat/claude-skills --skill creating-agent-skillsgit clone --depth 1 https://github.com/ratacat/claude-skills.git /tmp/claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills/skills/creating-agent-skills ~/.claude/skills/creating-agent-skillsPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Creating Agent Skills This skill teaches how to create effective Claude Code Skills following Anthropic's official specification. ## Core Principles ### 1. Skills Are Prompts All prompting best practices apply. Be clear, be direct. Assume Claude is smart - only add context Claude doesn't have. ### 2. Standard Markdown Format Use YAML frontmatter + markdown body. **No XML tags** - use standard markdown headings. ```markdown --- name: my-skill-name description: What it does and when to use it --- # My Skill Name ## Quick Start Immediate actionable guidance... ## Instructions Step-by-step procedures... ## Examples Concrete usage examples... ``` ### 3. Progressive Disclosure Keep SKILL.md under 500 lines. Split detailed content into reference files. Load only what's needed. ``` my-skill/ ├── SKILL.md # Entry point (required) ├── reference.md # Detailed docs (loaded when needed) ├── examples.md # Usage examples └── scripts/ # Utility scripts (executed, not loaded) ``` ### 4. Effective Descriptions The description field enables skill discovery. Include both what the skill does AND when to use it. Write in third person. **Good:** ```yaml description: Extracts text and tables from PDF files, fills forms, merges documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction. ``` **Bad:** ```yaml description: Helps with documents ``` ## Skill Structure ### Required Frontmatter
Details
- Skill name
creating-agent-skills- Repository
- ratacat/claude-skills
- Path
skills/creating-agent-skills/SKILL.md- Repo updated
- 11 February 2026
FAQ
What does the Creating Agent Skills skill do?
Expert guidance for creating, writing, and refining Claude Code Skills. Use when working with SKILL.md files, authoring new skills, improving existing skills, or understanding skill structure and best practices.
How do I install the Creating Agent Skills skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add ratacat/claude-skills --skill creating-agent-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Creating Agent Skills popular?
It lives in ratacat/claude-skills, which has 59 GitHub stars and 10 forks.
Related skills
Skill Creator
59ratacat/claude-skills
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations.
Skill Installer
59ratacat/claude-skills
Install Codex skills into $CODEX_HOME/skills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos).
Agent Browser
59ratacat/claude-skills
Browser automation using Vercel's agent-browser CLI. Use when you need to interact with web pages, fill forms, take screenshots, or scrape data. Alternative to Playwright MCP - uses Bash commands with ref-based element selection. Triggers on "browse website", "fill form", "click button", "take screenshot", "scrape page", "web automation".
Data Integrity Guardian
59ratacat/claude-skills
Use this agent when you need to review database migrations, data models, or any code that manipulates persistent data. This includes checking migration safety, validating data constraints, ensuring transaction boundaries are correct, and verifying that referential integrity and privacy requirements are maintained. <example>Context: The user has just written a database migration that adds a new column and updates existing records. user: "I've created a migration to add a status column to the orders table" assistant: "I'll use the data-integrity-guardian agent to review this migration for safety
Create Agent Skill
59ratacat/claude-skills
Create or edit Claude Code skills with expert guidance on structure and best practices
Data Migration Expert
59ratacat/claude-skills
Use this agent when reviewing PRs that touch database migrations, data backfills, or any code that transforms production data. This agent validates ID mappings against production reality, checks for swapped values, verifies rollback safety, and ensures data integrity during schema changes. Essential for any migration that involves ID mappings, column renames, or data transformations. <example>Context: The user has a PR with database migrations that involve ID mappings. user: "Review this PR that migrates from action_id to action_module_name" assistant: "I'll use the data-migration-expert agent
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.