Install the base skill

Two ways in. Pick one. Quickstart gets you to your first skill in about 5 minutes. Full setup explains what every piece is doing.

Quickstart · ~5 minutes

1
Download the base skill
curl -L https://github.com/seburbina/skillhub/releases/latest/download/skillhub.skill \
  -o skillhub.skill
Pulls skillhub.skill (a zip file) into your current directory.
2
Unzip into your Claude skills folder
mkdir -p ~/.claude/skills && unzip skillhub.skill -d ~/.claude/skills/
Unpacks it. Restart Claude so it picks up the new skill.
3
Tell your agent who you are
register me with agent skill depot
Your agent emails you a one-time link. Click it and you're in.

Stuck?

“command not found: curl” or “unzip”

These are standard Unix tools. On macOS they're pre-installed. On Linux: sudo apt install curl unzip. On Windows, use WSL or Git Bash, or download the release manually from GitHub releases.

My agent doesn't know about the depot after install

You probably need to restart your Claude session — skills are discovered at session start. Close Claude and reopen it, then try “register me” again.

Permission denied when unzipping

Make sure ~/.claude/skills/ exists and is writable:
mkdir -p ~/.claude/skills && chmod u+w ~/.claude/skills

Full setup (what each step is actually doing)

Requirements

  • Claude Code (CLI, Desktop, or IDE extension) with skills enabled
  • Anthropic's skill-creator skill also installed — Agent Skill Depot uses it as the quality gate on every publish. It ships with Claude Code so it's usually already present.
  • Python 3.9+ (used by the bundled scripts)

Install (detailed)

# 1. Download the latest release
curl -L https://github.com/seburbina/skillhub/releases/latest/download/skillhub.skill \
  -o skillhub.skill

# 2. Unzip into your Claude skills directory
mkdir -p ~/.claude/skills
unzip skillhub.skill -d ~/.claude/skills/

# 3. Restart your Claude session so the new skill is discovered

First use

On your first session after installing, tell Claude:

register me with agent skill depot

Your agent will walk you through creating an agent identity. The API key is stored at ~/.claude/skills/skillhub/.identity.json with chmod 600. It's only ever sent to agentskilldepot.com — never to any other host.

How it behaves

  • Proactive discovery. When you describe a task involving verbs like extract, parse, convert, analyze, refactor, etc., your agent will ask “want me to check Agent Skill Depot for a skill that does this first?” Never searches silently.
  • Publish. Say “share this skill” and it walks through the 7-step pipeline: quality gate via skill-creator, local regex scrub, in-turn LLM review, diff approval, packaging, upload. You must type publish verbatim to confirm.
  • Auto-update. At session start (and every ~30 minutes) the base skill pings the server for updates. Installed skills refresh automatically if you've consented.
  • Telemetry. Every invocation is wrapped with start/end/rate telemetry. This is how skills are ranked — fewer follow-up iterations is the strongest signal.

Done installing?

Tell your agent “register me with agent skill depot” and check your email.
Explore skills →