Agent skill
example-skill
Demonstrates all available skill frontmatter fields. Use when you need a reference for skill configuration, when learning about skill capabilities, or when creating new skills from scratch.
Install this agent skill to your Project
npx add-skill https://github.com/Jamie-BitFlight/claude_skills/tree/main/plugins/plugin-creator/examples/skills/example-skill
SKILL.md
Example Skill
This skill demonstrates all available frontmatter fields for Claude Code skills.
Purpose
Use this as a reference when creating new skills. All fields shown above are valid skill frontmatter options.
Field Descriptions
| Field | Type | Purpose | Constraints | Default |
|---|---|---|---|---|
name |
string | Display name | kebab-case, lowercase | directory name |
description |
string | When to load this skill | Must include trigger keywords | first paragraph |
argument-hint |
string | Autocomplete hint for / menu |
Brief hint text | none |
allowed-tools |
string | Tools without permission prompts | Comma-separated tool names | none |
model |
string | Model when skill is active | sonnet, opus, haiku, or inherit | inherit |
user-invocable |
boolean | Show in / menu |
true or false | true |
disable-model-invocation |
boolean | Prevent Claude auto-loading | true or false | false |
hooks |
object | Scoped hooks for skill lifecycle | Valid hook configuration object | none |
Note: The fields context and agent are deprecated and not documented in the official Skills reference as of January 2026.
Validation
Validate your skill using:
# Frontmatter and structure validation (checks token complexity, links, references)
uvx skilllint@latest check ./path/to/skill/SKILL.md
# Plugin validation (if skill is part of a plugin)
claude plugin validate ./path/to/plugin/
Common Validation Errors
| Error | Cause | Fix |
|---|---|---|
allowed-tools must be string |
Used YAML array format | Change to comma-separated string |
model must be sonnet/opus/haiku |
Invalid model name | Use valid model identifier |
YAML array detected |
Used - Tool1 format |
Change to Tool1, Tool2 format |
Skill body exceeds 500 lines |
Skill is too large | Split into multiple skills |
Internal link points to missing file |
Referenced file doesn't exist | Create file or fix path |
Description too short |
Less than 20 characters | Add trigger keywords and context |
Usage
This skill is for demonstration purposes only. When creating real skills, include only the fields you need.
Skill Location
Skills can be located in:
- User-level:
~/.claude/skills/skill-name/SKILL.md- Available across all projects - Project-level:
.claude/skills/skill-name/SKILL.md- Version controlled, team shared - Plugin:
plugins/plugin-name/skills/skill-name/SKILL.md- Bundled in a plugin
Sources
- Skills Reference (accessed 2026-01-28)
- Skills Overview - Complete reference
- Plugin Creator Validation Scripts
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
ccc
This skill should be used when code search is needed (whether explicitly requested or as part of completing a task), when indexing the codebase after changes, or when the user asks about ccc, cocoindex-code, or the codebase index. Trigger phrases include 'search the codebase', 'find code related to', 'update the index', 'ccc', 'cocoindex-code'.
agent-browser
Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.
delegate
Quick delegation template for sub-agent prompts. Use when assigning work to a sub-agent, before invoking the Agent tool, or when preparing prompts for specialized agents. Provides the WHERE-WHAT-WHY framework. For comprehensive delegation guidance, activate the agent-orchestration how-to-delegate skill.
swarm-spawning
Spawn agents and teammates in Claude Code swarms. Use when choosing between subagents vs teammates, selecting agent types (Explore, Plan, general-purpose, plugin agents), configuring spawn backends (in-process, tmux, iterm2), or setting environment variables for spawned agents.
knowledge-explorer
Manage the research/ knowledge base (KB) of tool and library research entries. Use when browsing KB topics, adding new research entries, updating existing entries with dated revisions, fetching GitHub repo metadata into a draft KB entry, or migrating old-format entries to skill-spec frontmatter. Triggers on tasks like "what do we have on X", "add this to the KB", "update the KB entry for Y", "fetch github info for owner/repo", or "migrate old entries".
design-anti-patterns
Enforce anti-AI UI design rules based on the Uncodixfy methodology. Use when generating HTML, CSS, React, Vue, Svelte, or any frontend UI code. Prevents "Codex UI" — the generic AI aesthetic of soft gradients, floating panels, oversized rounded corners, glassmorphism, hero sections in dashboards, and decorative copy. Applies constraints from Linear/Raycast/Stripe/GitHub design philosophy: functional, honest, human-designed interfaces. Triggers on: UI generation, dashboard building, frontend component creation, CSS styling, landing page design, or any task producing visual interface code.
Didn't find tool you were looking for?