How can we help?
Find answers to common questions about Agent Skills CLI, from installation to skill creation.
Getting Started
How do I install Agent Skills CLI?
Install globally using npm: `npm install -g agent-skills-cli`. After installation, you can use the `skills` command from any directory. Verify installation with `skills --version`.
How do I install my first skill?
Run `npx agent-skills-cli install @author/skill-name` to install any skill from the marketplace. For example: `npx agent-skills-cli install @anthropic/xlsx`. The CLI will auto-detect your installed AI agents and install the skill to all of them.
How do I search for skills?
Use `skills search <query>` to search the marketplace. For example: `skills search "react components"` or `skills search pdf`. Results show skill name, author, description, and star count.
Where are skills installed?
Skills are installed to agent-specific directories: `.cursor/skills/` for Cursor, `.claude/skills/` for Claude Code, `.github/skills/` for Copilot, `.codex/skills/` for Codex, and `.agent/workflows/` for Antigravity.
Supported Agents
What AI agents are supported?
Agent Skills CLI supports 29 AI coding agents including: Cursor, Claude Code, GitHub Copilot, OpenAI Codex, Gemini CLI, Windsurf, Cline, Antigravity, OpenCode, Amp, Continue, Trae, Qwen Code, and 16 more.
How do I install to a specific agent?
Use the `-t` or `--target` flag: `npx agent-skills-cli install @author/skill -t cursor` or `npx agent-skills-cli install @author/skill -t cursor,claude` for multiple agents.
Does the CLI auto-detect my agents?
Yes! The CLI automatically detects which AI agents are installed in your project by checking for their configuration directories. Run `skills info` to see detected agents.
Can I install to all agents at once?
Yes, use the `--all` flag: `npx agent-skills-cli install @author/skill --all`. This installs the skill to every supported agent directory.
Managing Skills
How do I list installed skills?
Run `skills list` to see all installed skills. Use `skills list --json` for JSON output or `skills list --table` for a formatted table view.
How do I check for skill updates?
Run `skills check` to see which installed skills have updates available. The command shows the current and available versions for each skill.
How do I update my skills?
Run `skills update` to update all installed skills, or `skills update skill-name` to update a specific skill.
How do I uninstall a skill?
Use `skills market-uninstall skill-name` to remove a skill that was installed from the marketplace.
Creating Skills
How do I create my own skill?
Run `skills init my-skill-name` to create a new skill from a template. This generates a SKILL.md file with the proper structure. Edit this file to add your instructions and examples.
What format should skills be in?
Skills are Markdown files (SKILL.md) with YAML frontmatter containing metadata (name, description, author) followed by the skill instructions. See existing skills in the marketplace for examples.
How do I publish my skill?
Skills are hosted on GitHub. Create a repository with your SKILL.md file, then submit it to the Agent Skills marketplace for inclusion.
Troubleshooting
The CLI is not finding my skills
Run `skills doctor` to diagnose issues. This checks your installation, agent detection, and skill directories. Use `skills doctor --fix` to automatically repair common problems.
Installation failed with permission error
Try installing with sudo: `sudo npm install -g agent-skills-cli`, or use a Node version manager like nvm which doesn't require elevated permissions.
Can I disable telemetry?
Yes, set the environment variable `DISABLE_TELEMETRY=1` or `DO_NOT_TRACK=1`. Telemetry is anonymous and only collects command usage statistics, never personal data.
Still have questions?
Check our documentation or open an issue on GitHub