01
What is a Skill?
A folder of instructions that teaches your agent one kind of job — like making a slide deck — with SKILL.md at its center.
Browse examplesLearn
Learn Agent Skills
Short, plain guides that take you from installing your first Skill to fixing one that won’t load — in Claude Code, Codex, or Cursor.
No account requiredWorks with leading agentsVerified packages
Platforms
Which agent do you use?
The same SKILL.md folder travels across agents — pick the runtime you use day to day.
Start here
New here? Read these three first
02
Getting started
Install one free Skill, run it in your agent, and check that it did the job before you customize anything.
Get a Skill running03
Install a Skill
Put the folder where Claude Code, Codex, or Cursor can find it — personal vs project paths differ by agent.
See install guidesGo deeper
Get more out of your Skills
How to use Skills
What to give a Skill, how to check the files it makes, and how to get a better second draft.
How Skills trigger
Why an agent picks one Skill over another, and how to write a description that gets chosen.
Skill files
Understand SKILL.md, scripts/, references/, and how deep the folder can go before an agent skips it.
Skill safety
Review scripts before you install, prefer verified packages, and avoid running untrusted code.
Troubleshooting
Skill not working? Pick what you’re seeing
It’s not in /skills
Wrong folder, or an extra level from a ZIP. Path must end in <name>/SKILL.md for that agent.
It never runs on its own
Call it by name first, then tighten the description so the agent recognizes your requests.
A different Skill runs
Overlapping descriptions or duplicate names. Make the intended Skill’s first sentence specific.
Works locally, not in the cloud
Personal folders stay on your machine. Commit project Skills, sync Cursor Skills, or enable on claude.ai.
Compare
How Skills compare to MCP, prompts, and rules
Use the right abstraction for the job — SkillsRadar helps you discover and combine them.
Skill
Reusable capability package for a specific outcome.
- Loaded when needed
- Portable across agents
- Best for repeatable work
MCP
Protocol that connects agents to tools and data sources.
- Live tool access
- Server-backed
- Complements skills
Prompt
One-off instructions you paste into a chat.
- Fast to try
- Hard to maintain
- Easy to drift
AGENTS.md / rules
Short guidance loaded at the start of every run.
- Always in context
- Keep it short
- Move procedures into Skills
Connect your tools
One account, every interface
Start in the library, continue in your terminal or agent, and use the API when you need a custom integration.
CLI
Search, inspect, install, update, and scan skills without leaving your terminal.
Best for local workflows
See install guidesMCP
Connect Cursor or Claude Desktop so your agent can search, recommend, and explain how to install Skills in chat.
Best for discovery inside the agent
MCP setup guideAPI & SDK
Bring semantic search and recommendations into products, scripts, and automations.
Best for custom integrations
Manage API keysHandy
Command cheat sheet
Slash commands, $ invokes, and SkillsRadar CLI installs.
/skillsList Skills in Claude Code or Codex
/skill-name …Run a Skill in Claude Code or Cursor
$skill-name …Run a Skill in Codex
npx @skillsradar/cli@latest install <slug>Default → ~/.agents/skills/ (Codex, Cursor, …)
npx @skillsradar/cli@latest install <slug> --agent claude-codeInstall into ~/.claude/skills/
npx @skillsradar/cli@latest loginBrowser login → OS keyring
skillsradar-mcpMCP stdio server — see /learn/mcp for Cursor setup
Locations
Where Skills live
Each agent reads a different set of folders. Put the Skill where your agent looks — or let SkillsRadar’s --agent flag choose for you.
~/.agents/skills/Shared default (Codex, Cursor, Gemini CLI, …)
~/.claude/skills/Claude Code (requires --agent claude-code)
~/.gemini/config/skills/Antigravity
Next step
Ready to explore verified Skills?
Browse the library, filter by agent, or open the install guide for Claude Code, Codex, or Cursor.