Q: How do I uninstall or update a skill?

To uninstall, run `npx skills remove / `. To update a skill to the latest version, run `npx skills update / `. You can also update all installed skills at once with `npx skills update --all`. Skills are versioned based on the GitHub repo's main branch — updates pull the latest reference files. Check `npx skills list` to see current versions.

Q: Can I install multiple skills from the same repo?

Yes. When you install a repo with `npx skills add / `, all skills in that repo are loaded. For example, `npx skills add antfu/skills` installs Vite, Vue, Vitest, and any other skills in that repo. If you only want specific skills from a repo, check if the repo supports granular installation — some repos let you install individual skills with `npx skills add / / `.

Question 1

What are AI agent skills and how do they work?

Accepted Answer

AI agent skills are reusable knowledge packages that give your coding agent domain-specific expertise. When you install a skill, your agent loads structured reference files — API docs, best practices, code patterns, and troubleshooting guides — into its context. Instead of guessing or hallucinating, your agent answers from bundled reference material. Skills are installed via the skills.sh CLI with `npx skills add /`, and your agent picks them up on the next interaction.

Question 2

How do I install skills for Claude Code, Cursor, or Codex?

Accepted Answer

Installation is the same across all agents. Run `npx skills add /` in your terminal. For example: `npx skills add confident-ai/deepeval` installs the DeepEval evaluation skill. `npx skills add antfu/skills` installs the entire set of frontend skills (Vite, Vue, Vitest). No restart needed — your agent picks up the new skills on the next prompt. You can verify installation by running `npx skills list` to see what's currently loaded.

Question 3

Which AI agent versions support skills?

Accepted Answer

Skills work with any agent that supports the skills.sh protocol. As of mid-2026, the confirmed-compatible agents are: Claude Code (latest), Cursor (0.45+), Codex (all versions), GitHub Copilot (1.200+), Windsurf (all versions), Cline (all versions), Gemini Code Assist, AMP, Antigravity, ClawdBot, Goose, Kilo, Kiro CLI, Nous Research, OpenCode, Roo, Trae, VS Code (with appropriate extensions), and Zed. If your agent can run `npx` commands, it likely works.

Question 4

How do I uninstall or update a skill?

Accepted Answer

To uninstall, run `npx skills remove /`. To update a skill to the latest version, run `npx skills update /`. You can also update all installed skills at once with `npx skills update --all`. Skills are versioned based on the GitHub repo's main branch — updates pull the latest reference files. Check `npx skills list` to see current versions.

Question 5

What's the difference between a skill and a plugin?

Accepted Answer

Skills are knowledge packages — they add documentation, best practices, and reference code to your agent's context. They don't execute code or modify your editor. Plugins (or extensions) are executable code that add new features to your editor or CLI. Skills work alongside plugins: the plugin provides the interface, the skill provides the domain knowledge. On skills.sh, all packages are skills that follow the Agent Skills Specification.

Question 6

Can I create my own skill for my team?

Accepted Answer

Yes. The Agent Skills Specification is open. Create a GitHub repo with a `skills/` directory containing markdown or JSON reference files. Add a `skill.json` manifest in the root describing the skill's metadata, compatibility, and entry points. Then install it with `npx skills add your-org/your-repo`. Teams use this to bundle internal API docs, coding standards, and deployment guides into skills all team members can share.

Question 7

Why isn't my skill showing up after installation?

Accepted Answer

This usually happens for one of three reasons: (1) the repo doesn't follow the Agent Skills Specification (missing `skill.json` or incorrect directory structure), (2) your agent needs a new session to pick up the skill (try restarting the agent or starting a new conversation), or (3) the skill is installed but your agent isn't triggering on the right keywords (try being explicit: 'using the [skill name] skill, how do I...'). Run `npx skills list` to confirm the skill is installed, then check the repo has a valid `skill.json` file.

Question 8

Do skills work offline?

Accepted Answer

It depends on the skill. Most skills store reference files locally after installation, so the knowledge is available offline. However, skills that reference live docs (like Mastra's remote docs fallback) may need an internet connection. Skills installed from GitHub repos are cached locally and don't require internet to read — only to install or update. For fully offline setups, check each skill's documentation for local-first support.

Question 9

How do I find the right skill for my use case?

Accepted Answer

Browse the skills.sh directory at skills.sh — it has 9,500+ skills categorized by topic (React, Next.js, Design, Mobile, Agent Workflows, Databases, Testing, Marketing, and more). You can filter by agent type and sort by installs. For curated recommendations, check topaiskills.com for skill intros and tutorials with real-world testing results.

Question 10

Can I install multiple skills from the same repo?

Accepted Answer

Yes. When you install a repo with `npx skills add /`, all skills in that repo are loaded. For example, `npx skills add antfu/skills` installs Vite, Vue, Vitest, and any other skills in that repo. If you only want specific skills from a repo, check if the repo supports granular installation — some repos let you install individual skills with `npx skills add //`.

Installation on Top AI Skills

AI Agent Skills FAQ: Installation, Compatibility, and Troubleshooting Guide

Frequently Asked Questions

Getting Started with AI Agent Skills

FAQ: Installing AI Agent Skills in Claude Code and Cursor

What This FAQ Covers

Q&A

What exactly is an AI agent skill?