claudeskills.page

Guides

Guides to Claude Code skills

From your first install to publishing a plugin for your team. Each guide answers one question thoroughly, with working examples.

  1. 01 Fundamentals

    What Are Claude Code Skills? A Practical Explainer

    Claude Code skills are folders of instructions that Claude loads only when needed. Learn how SKILL.md works and when a skill beats CLAUDE.md or a prompt.
  2. 02 Recommendations

    The Best Claude Code Skills in 2026, by Use Case

    The Claude Code skills worth installing first, grouped by job: debugging, code review, frontend, databases, security, DevOps, documents and AI apps.
  3. 03 Getting started

    How to Install Claude Code Skills (5 Ways)

    Install Claude Code skills with a one-line command, a zip, a git-committed project folder, a plugin marketplace, or a claude.ai upload. Verify with /skills.
  4. 04 Reference

    SKILL.md Format: Every Frontmatter Field Explained

    A complete SKILL.md reference: required fields, open-standard keys, Claude Code extras like context: fork and paths, arguments, variables, and examples.
  5. 05 Tutorial

    How to Write Your First Claude Code Skill, Step by Step

    Build a real migration-review skill for Claude Code from scratch: folder setup, a description that triggers, a checklist, a bundled script, and testing.
  6. 06 Examples

    Claude Code Skill Examples: 10 Real SKILL.md Files, Annotated

    Ten real SKILL.md files, annotated: trigger descriptions, checklists, decision tables, bundled scripts and references, gotchas, and a copyable template.
  7. 07 Concepts

    Skills vs Slash Commands, Subagents, Hooks, and MCP: Which to Use?

    Compare Claude Code skills, slash commands, subagents, hooks, MCP servers, CLAUDE.md, and plugins in one table, with clear rules for when to use each.
  8. 08 Troubleshooting

    Claude Code Skill Not Triggering? 9 Fixes That Work

    Fix a Claude Code skill that will not load or trigger: YAML errors, name and folder mismatches, vague descriptions, precedence collisions, and context budget.
  9. 09 Configuration

    Personal vs Project Skills: Where Claude Code Skills Live

    Where Claude Code loads skills from: personal, project, nested, --add-dir, plugin, and enterprise locations, how precedence works, and which to choose.
  10. 10 Teams

    How to Share Claude Code Skills With Your Team

    Share Claude Code skills with a team: commit project skills to git, package them as a plugin with a marketplace, version releases, and review changes safely.
  11. 11 Platforms

    Using Skills on claude.ai, the Claude API, and the Agent SDK

    How Agent Skills work outside Claude Code: zip uploads on claude.ai, the /v1/skills API with code execution, the Agent SDK, and what stays portable.
  12. 12 Best practices

    12 Best Practices for Writing Claude Code Skills

    Twelve rules for writing Claude Code skills that trigger reliably and work: concise bodies, trigger-ready descriptions, checklists, scripts, and real tests.
  13. 13 Security

    Are Claude Code Skills Safe? How to Audit a Skill Before Installing

    Claude Code skills can run scripts and shell commands with your permissions. Learn the red flags, how to audit a skill, and which settings limit the risk.
  14. 14 Plugins

    Claude Code Plugins: How They Bundle Skills, Commands, Agents, Hooks and MCP Servers

    What a Claude Code plugin is, how plugin.json and marketplace.json work, how to install with /plugin, and when a plain skill is the better choice.
  15. 15 Platforms

    Use Agent Skills Outside Claude Code: Codex, Cursor, Gemini CLI, GitHub Copilot, and OpenCode

    Which agents read SKILL.md under the Agent Skills open standard, the folders Codex, Cursor, Gemini CLI, Copilot, and OpenCode scan, and what stays portable.
esc