Teach your agent anything with /learn

Teach your agent anything with /learn

The /learn command gives your AI agent access to 40,000+ skills from agentskill.sh — right inside your editor or chat. Search, install, and manage skills mid-conversation. No restart needed.

Need your agent to handle SEO? Just type:

/learn seo

Your agent searches 40,000+ skills, suggests the best matches, and installs the one you pick — all in one conversation. Or install a specific skill directly:

/learn @anthropic/seo-content-optimizer

See more examples below

How to Install the /learn Command

Pick the method that matches your setup — from one-command plugin install to manual file copy.

If you're using Claude Code (version 1.0.33+), this is the fastest way. Run this inside Claude Code:

/plugin marketplace add https://agentskill.sh/marketplace.json
/plugin install learn@agentskill-sh

That's it. The /learn command is now available in all your projects.

What this does: It adds the agentskill.sh marketplace and installs the learn plugin, which bundles the /learn skill. Claude Code handles updates automatically.

Option 2: Claude Desktop / Claude Cowork (Plugin URL)

Claude Desktop and Claude Cowork have a Plugins button (bottom-left of the chat window) that lets you add marketplaces by URL.

  1. Open Claude Desktop or Claude Cowork
  2. Click the Plugins button (bottom-left corner)
  3. Click Add marketplace
  4. Enter this URL:
https://agentskill.sh/marketplace.json
  1. Browse the available plugins and install learn

The /learn command will be available in your next conversation.

Option 3: Settings > Skills (Upload ZIP)

If your platform supports uploading skill files:

  1. Download the skill ZIP from the learn skill page (click "Download skill" in the sidebar)
  2. Open your AI agent's Settings
  3. Navigate to Skills (or equivalent section)
  4. Upload the ZIP file or extract and copy the SKILL.md file

This works for any platform that supports skill files — Claude Desktop, Claude Code, Cursor, etc.

Option 4: Git Clone (Claude Code)

Clone the learn skill directly to your Claude Code global skills directory:

git clone https://github.com/agentskill-sh/learn.git ~/.claude/skills/learn

This installs /learn globally — available in every project you open with Claude Code.

To install it for a single project only, clone it inside the project:

git clone https://github.com/agentskill-sh/learn.git .claude/skills/learn

Option 5: OpenClaw

Copy the skill to your OpenClaw skills directory:

git clone https://github.com/agentskill-sh/learn.git ~/.openclaw/skills/learn

Or for a workspace-only install:

git clone https://github.com/agentskill-sh/learn.git ./skills/learn

OpenClaw loads skills from ~/.openclaw/skills (global) and ./skills (workspace). Workspace skills take priority.

Option 6: Git Clone (Cursor)

git clone https://github.com/agentskill-sh/learn.git ~/.cursor/skills/learn

Option 6: Git Clone (Other Platforms)

Copy the SKILL.md file to your platform's skill directory:

PlatformDirectory
Claude Code~/.claude/skills/learn/SKILL.md
Cursor~/.cursor/skills/learn/SKILL.md
GitHub Copilot.github/copilot/skills/learn/SKILL.md
Windsurf~/.windsurf/skills/learn/SKILL.md
Cline~/.cline/skills/learn/SKILL.md
Codex~/.codex/skills/learn/SKILL.md
Gemini CLI~/.gemini/skills/learn/SKILL.md
Amp~/.amp/skills/learn/SKILL.md
Goose~/.goose/skills/learn/SKILL.md
Roo Code~/.roo-code/skills/learn/SKILL.md
Aider~/.aider/skills/learn/SKILL.md
OpenClaw~/.openclaw/skills/learn/SKILL.md
OpenCode~/.opencode/skills/learn/SKILL.md
Trae~/.trae/skills/learn/SKILL.md

Use ~ (home directory) for global installation, or a relative path for per-project installation.

Using /learn

Once installed, try these commands:

Search for skills

/learn programmatic seo
/learn frontend react components
/learn marketing email sequences

Returns the top 5 matching skills with name, description, install count, and security score.

Install a specific skill

/learn @anthropic/seo-optimizer
/learn @vercel/nextjs-expert

Get context-aware recommendations

/learn

Run with no arguments — it analyzes your project (dependencies, file types, git branch) and suggests relevant skills.

/learn trending

Manage installed skills

/learn list              # Show all installed skills
/learn update            # Check for updates
/learn remove <slug>     # Uninstall a skill

Rate a skill after using it

/learn feedback seo-optimizer 5 "Excellent keyword clustering"

Your feedback helps other agents find the best skills.

How It Works

  1. Search — Queries the agentskill.sh API for matching skills
  2. Preview — Shows name, description, score, install count, and security score before installing
  3. Install — Writes the skill file with a version-tracking metadata header
  4. Track — Reports the install for usage analytics (platform and agent name only)
  5. Self-update — Before each run, checks if /learn itself is up to date via content SHA comparison

Every installed skill includes a metadata header for version tracking:

# --- agentskill.sh ---
# slug: seo-optimizer
# owner: anthropic
# contentSha: a3f8c2e
# installed: 2025-01-15T10:30:00Z
# source: https://agentskill.sh/seo-optimizer
# ---

/learn update compares the local contentSha against the API to detect changes — no timestamps or version numbers, just deterministic content hashing.

Security

  • Skills with a security score below 50 show a warning before install
  • Skills below 30 require explicit user confirmation
  • All security scores are computed by agentskill.sh static analysis
  • No API key required — the learn skill uses the public API

Troubleshooting

The /learn command is not recognized

Make sure the SKILL.md file is in the correct directory for your platform (see the table above). Restart your AI agent or open a new session after installing.

Permission denied when cloning

Use HTTPS instead of SSH if you don't have GitHub SSH keys set up:

git clone https://github.com/agentskill-sh/learn.git ~/.claude/skills/learn
Skills are not updating

Run /learn update to check for updates. If the command itself needs updating, it will self-update automatically before executing.

Search returns no results

Try broader keywords. You can also browse skills directly at agentskill.sh.

Next Steps