JSPM – skillfish@1.0.15

Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (skillfish) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

The skill manager for AI coding agents.
Install, update, and sync skills across Claude Code, Cursor, Copilot + more.

Quick Start

# One-off skill installation
npx skillfish add owner/repo

# For skill management (list, update, remove), install globally
npm i -g skillfish

One command installs to all detected agents on your system.

What Are Agent Skills?

Agent Skills are portable packages of instructions, prompts, scripts, and resources that AI coding agents can discover and use. They give agents like Claude Code, Cursor, and Copilot domain expertise, reusable workflows, and team-specific context - loaded on demand to extend capabilities.

Each skill contains a SKILL.md file with structured prompts and instructions the agent can follow.

Learn more at agentskills.io.

Find Skills

skill.fish - Browse and discover community skills
MCP Market - Skills directory

Commands

Command	Description
`skillfish add <owner/repo>`	Install skills
`skillfish list`	View installed skills
`skillfish remove [name]`	Remove skills
`skillfish update`	Update installed skills

All commands support --json for automation.

Examples

skillfish add user/my-skill          # Install a skill
skillfish add owner/repo --all       # Install all skills from repo
skillfish list                       # See what's installed
skillfish update                     # Update all skills
skillfish remove old-skill           # Remove a skill

Supported Agents

Works with 17+ agents including:

Claude Code · Cursor · Windsurf · Codex · GitHub Copilot · Gemini CLI · OpenCode · Goose · Amp · Roo Code · Kiro CLI · Kilo Code · Trae · Cline · Antigravity · Droid · Clawdbot

All supported agents

Agent	Skills Directory
Claude Code	`~/.claude/skills/`
Cursor	`~/.cursor/skills/`
Windsurf	`~/.codeium/windsurf/skills/`
Codex	`~/.codex/skills/`
GitHub Copilot	`~/.github/skills/`
Gemini CLI	`~/.gemini/skills/`
OpenCode	`~/.opencode/skills/`
Goose	`~/.goose/skills/`
Amp	`~/.agents/skills/`
Roo Code	`~/.roo/skills/`
Kiro CLI	`~/.kiro/skills/`
Kilo Code	`~/.kilocode/skills/`
Trae	`~/.trae/skills/`
Cline	`~/.cline/skills/`
Antigravity	`~/.gemini/antigravity/skills/`
Droid	`~/.factory/skills/`
Clawdbot	`~/.clawdbot/skills/`

Command Reference

add

Install skills from a repository.

skillfish add owner/repo                    # Auto-discover SKILL.md
skillfish add owner/repo my-skill           # Install by skill name
skillfish add owner/repo/path/to/skill      # Full path syntax
skillfish add owner/repo --path skills/foo  # Explicit path
skillfish add owner/repo --all              # Install all skills
skillfish add owner/repo --force            # Overwrite existing
skillfish add owner/repo --yes              # Skip confirmation
skillfish add owner/repo --project          # Project only (./)
skillfish add owner/repo --global           # Global only (~/)

list

View installed skills.

skillfish list                       # List all installed skills
skillfish list --global              # Global skills only (~/)
skillfish list --project             # Project skills only (./)
skillfish list --agent "Claude Code" # Specific agent

remove

Remove installed skills.

skillfish remove                          # Interactive picker
skillfish remove my-skill                 # By name
skillfish remove --all                    # Remove all
skillfish remove my-skill --project       # Project only
skillfish remove my-skill --global        # Global only
skillfish remove my-skill --agent "Cursor" # Specific agent
skillfish remove my-skill --yes           # Skip confirmation

update

Update installed skills to latest version.

skillfish update                     # Check for updates interactively
skillfish update --yes               # Update all without prompting
skillfish update --json              # Check for updates (JSON output)

Exit Codes

Exit codes help agents and scripts understand command results without parsing error messages.

Code	Name	Meaning
0	Success	Command completed successfully
1	General Error	Unspecified error
2	Invalid Args	Invalid arguments or options provided
3	Network Error	Network failure (timeout, rate limit)
4	Not Found	Requested resource not found (skill, agent, repo)

JSON output includes exit_code for programmatic access:

skillfish add owner/repo --json
# Output includes: "exit_code": 0 (or error code)

Security

Skills are markdown files that provide instructions to AI agents. Always review skills before installing. skillfish does not vet third-party skills.

To report vulnerabilities, email security@skill.fish. See SECURITY.md.

Contributing

Contributions welcome! See CONTRIBUTING.md and our Code of Conduct.

Changelog

See CHANGELOG.md for release history.

Telemetry

Anonymous, aggregate install counts only. No PII collected.

To opt out: DO_NOT_TRACK=1 or CI=true.

License

AGPL-3.0 - Graeme Knox