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.

Stars 33
Forks 4

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:

bash
# 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

Expand your agent's capabilities with these related and highly-rated skills.

Jamie-BitFlight/claude_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'.

33 4
Explore
Jamie-BitFlight/claude_skills

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.

33 4
Explore
Jamie-BitFlight/claude_skills

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.

33 4
Explore
Jamie-BitFlight/claude_skills

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.

33 4
Explore
Jamie-BitFlight/claude_skills

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".

33 4
Explore
Jamie-BitFlight/claude_skills

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.

33 4
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results