Documentation

Everything you need to know about installing and using Claude Code skills.

Quick Start

Get a skill running in under 60 seconds: 

# 1. Download the skill (you'll get a .zip after purchase)

# 2. Extract to your skills directory
unzip transcript-agent.zip -d ~/.claude/skills/

# 3. That's it. Use Claude Code normally.
claude "analyze this YouTube video: https://..."

✓ Skill loaded: transcript-agent

Installation

Prerequisites

  • ✓ Claude Code installed and working
  • ✓ Access to your terminal / command line

Skills work with any Claude Code installation — free tier or Pro.

Step-by-step

1

Create the skills directory (if it doesn't exist)

mkdir -p ~/.claude/skills
2

Download and extract your skill

After purchase, you'll receive a .zip file. Extract it to the skills directory:

unzip skill-name.zip -d ~/.claude/skills/
3

Verify the structure

Your skills directory should look like this:

~/.claude/skills/
├── transcript-agent/
│   └── SKILL.md
├── x-tweet-generator/
│   └── SKILL.md
└── ... (other skills)
4

Start using Claude Code

That's it! Claude Code automatically detects and loads skills when they're relevant to your task.

How Skills Work

Skills are instruction files that teach Claude Code how to handle specific tasks. When you ask Claude to do something, it checks your skills directory and automatically loads relevant skills based on:

  • → Trigger keywords — Words in your prompt that match the skill's defined triggers
  • → Skill name — If you mention a skill by name
  • → Context — The type of task you're describing

You'll see ✓ Skill loaded: skill-name in the output when a skill activates.

Skill Structure

Each skill is a folder containing at minimum a SKILL.md file: 

skill-name/
├── SKILL.md        ← Required: The "brain" of the skill
├── scripts/        ← Optional: Python/Bash helpers
│   └── helper.py
├── references/     ← Optional: Additional docs
│   └── api-docs.md
└── assets/         ← Optional: Templates, images
    └── template.md

The SKILL.md file

This is where all the magic happens. It contains:

  • • Frontmatter — Name, description, and trigger keywords
  • • Instructions — How Claude should handle the task
  • • Examples — Sample inputs/outputs
  • • Scripts — Commands to run, APIs to call

Troubleshooting

Skill not loading?

  • • Check the skill is in ~/.claude/skills/skill-name/
  • • Verify SKILL.md exists inside the folder
  • • Try mentioning the skill name explicitly: "use transcript-agent to..."
  • • Restart Claude Code if you just installed a new skill

Script permission errors?

Some skills include scripts that need execute permissions:

chmod +x ~/.claude/skills/skill-name/scripts/*.sh

Still having issues?

Email [email protected] with:

  • • Which skill you're trying to use
  • • Your Claude Code version (claude --version)
  • • The error message (if any)

FAQ

Do skills work offline? +

Skills themselves are local files and work offline. However, some skills call external APIs (like YouTube transcripts) which require internet.

Can I modify skills? +

Yes! Skills are just markdown files. Feel free to customize them for your workflow. We recommend keeping a backup of the original.

How do I get skill updates? +

Individual purchases include 12 months of updates. All-Access members get lifetime updates. When we release an update, you'll receive an email with download links.

Can I create my own skills? +

Absolutely! Check out the skill-creator-plus skill which teaches you how to build effective skills with a philosophy-first framework.

Ready to get started?

Browse our skills and supercharge your Claude Code workflow.

Browse Skills →