{"_id":"@dgruzd/skills","name":"@dgruzd/skills","dist-tags":{"latest":"1.4.3"},"versions":{"1.4.3":{"name":"@dgruzd/skills","version":"1.4.3","description":"The open agent skills ecosystem (fork with GitLab update support)","type":"module","bin":{"skills":"bin/cli.mjs","add-skill":"bin/cli.mjs"},"scripts":{"build":"npx tsx scripts/generate-licenses.ts && obuild","generate-licenses":"npx tsx scripts/generate-licenses.ts","dev":"node src/cli.ts","exec:test":"node scripts/execute-tests.ts","prepublishOnly":"npm run build","format":"prettier --write 'src/**/*.ts' 'scripts/**/*.ts'","format:check":"prettier --check 'src/**/*.ts' 'scripts/**/*.ts'","prepare":"husky","test":"vitest","type-check":"tsc --noEmit","publish:snapshot":"npm version prerelease --preid=snapshot --no-git-tag-version && npm publish --tag snapshot"},"lint-staged":{"src/**/*.ts":"prettier --write","scripts/**/*.ts":"prettier --write","tests/**/*.ts":"prettier --write"},"keywords":["cli","agent-skills","skills","ai-agents","amp","antigravity","augment","claude-code","openclaw","cline","codebuddy","codex","command-code","continue","cortex","crush","cursor","droid","gemini-cli","github-copilot","goose","junie","iflow-cli","kilo","kimi-cli","kiro-cli","kode","mcpjam","mistral-vibe","mux","opencode","openhands","pi","qoder","qwen-code","replit","roo","trae","trae-cn","windsurf","zencoder","neovate","pochi","adal","universal"],"repository":{"type":"git","url":"git+https://github.com/dgruzd/skills.git"},"homepage":"https://github.com/dgruzd/skills#readme","bugs":{"url":"https://github.com/dgruzd/skills/issues"},"author":"","license":"MIT","publishConfig":{"access":"public"},"devDependencies":{"@clack/prompts":"^0.11.0","@types/bun":"latest","@types/node":"^22.10.0","gray-matter":"^4.0.3","husky":"^9.1.7","lint-staged":"^16.2.7","obuild":"^0.4.22","picocolors":"^1.1.1","prettier":"^3.8.1","simple-git":"^3.27.0","typescript":"^5.9.3","vitest":"^4.0.17","xdg-basedir":"^5.1.0"},"engines":{"node":">=18"},"packageManager":"pnpm@10.17.1","_id":"@dgruzd/skills@1.4.3","gitHead":"145ded06c3494391d16b427b7532d11e79c76282","_nodeVersion":"22.13.1","_npmVersion":"10.9.2","dist":{"integrity":"sha512-MdbIncNQLxLCq6ctQQHlEboo9o83fbXONcYaPxozVm2Pp0ekuPiy/E+1nvKQqIS4NLQ3KxumNRZ8A6Fh+OIEHw==","shasum":"b2f90af7d6b9ad03cd828b1929dea325c406f9c6","tarball":"https://registry.npmjs.org/@dgruzd/skills/-/skills-1.4.3.tgz","fileCount":17,"unpackedSize":741884,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCevh/+msHPfpR/ITV6CHbjnqDx4IatMhEVzv0U5BRbNQIgMnUy+fSsjqsJtBniQC5KETmXaJhwWqvqwhGKzGwdRps="}]},"_npmUser":{"name":"dgruzd","email":"dgruzd@gitlab.com"},"directories":{},"maintainers":[{"name":"dgruzd","email":"dgruzd@gitlab.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/skills_1.4.3_1772440293092_0.6315710528927083"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-02T08:31:33.002Z","1.4.3":"2026-03-02T08:31:33.279Z","modified":"2026-03-02T08:31:33.473Z"},"maintainers":[{"name":"dgruzd","email":"dgruzd@gitlab.com"}],"description":"The open agent skills ecosystem (fork with GitLab update support)","homepage":"https://github.com/dgruzd/skills#readme","keywords":["cli","agent-skills","skills","ai-agents","amp","antigravity","augment","claude-code","openclaw","cline","codebuddy","codex","command-code","continue","cortex","crush","cursor","droid","gemini-cli","github-copilot","goose","junie","iflow-cli","kilo","kimi-cli","kiro-cli","kode","mcpjam","mistral-vibe","mux","opencode","openhands","pi","qoder","qwen-code","replit","roo","trae","trae-cn","windsurf","zencoder","neovate","pochi","adal","universal"],"repository":{"type":"git","url":"git+https://github.com/dgruzd/skills.git"},"bugs":{"url":"https://github.com/dgruzd/skills/issues"},"license":"MIT","readme":"# skills\n\nThe CLI for the open agent skills ecosystem.\n\n<!-- agent-list:start -->\nSupports **OpenCode**, **Claude Code**, **Codex**, **Cursor**, and [37 more](#available-agents).\n<!-- agent-list:end -->\n\n## Install a Skill\n\n```bash\nnpx skills add vercel-labs/agent-skills\n```\n\n### Source Formats\n\n```bash\n# GitHub shorthand (owner/repo)\nnpx skills add vercel-labs/agent-skills\n\n# Full GitHub URL\nnpx skills add https://github.com/vercel-labs/agent-skills\n\n# Direct path to a skill in a repo\nnpx skills add https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines\n\n# GitLab URL\nnpx skills add https://gitlab.com/org/repo\n\n# Any git URL\nnpx skills add git@github.com:vercel-labs/agent-skills.git\n\n# Local path\nnpx skills add ./my-local-skills\n```\n\n### Options\n\n| Option                    | Description                                                                                                                                        |\n| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `-g, --global`            | Install to user directory instead of project                                                                                                       |\n| `-a, --agent <agents...>` | <!-- agent-names:start -->Target specific agents (e.g., `claude-code`, `codex`). See [Available Agents](#available-agents)<!-- agent-names:end -->                  |\n| `-s, --skill <skills...>` | Install specific skills by name (use `'*'` for all skills)                                                                                         |\n| `-l, --list`              | List available skills without installing                                                                                                           |\n| `--copy`                  | Copy files instead of symlinking to agent directories                                                                                              |\n| `-y, --yes`               | Skip all confirmation prompts                                                                                                                      |\n| `--all`                   | Install all skills to all agents without prompts                                                                                                   |\n\n### Examples\n\n```bash\n# List skills in a repository\nnpx skills add vercel-labs/agent-skills --list\n\n# Install specific skills\nnpx skills add vercel-labs/agent-skills --skill frontend-design --skill skill-creator\n\n# Install a skill with spaces in the name (must be quoted)\nnpx skills add owner/repo --skill \"Convex Best Practices\"\n\n# Install to specific agents\nnpx skills add vercel-labs/agent-skills -a claude-code -a opencode\n\n# Non-interactive installation (CI/CD friendly)\nnpx skills add vercel-labs/agent-skills --skill frontend-design -g -a claude-code -y\n\n# Install all skills from a repo to all agents\nnpx skills add vercel-labs/agent-skills --all\n\n# Install all skills to specific agents\nnpx skills add vercel-labs/agent-skills --skill '*' -a claude-code\n\n# Install specific skills to all agents\nnpx skills add vercel-labs/agent-skills --agent '*' --skill frontend-design\n```\n\n### Installation Scope\n\n| Scope       | Flag      | Location            | Use Case                                      |\n| ----------- | --------- | ------------------- | --------------------------------------------- |\n| **Project** | (default) | `./<agent>/skills/` | Committed with your project, shared with team |\n| **Global**  | `-g`      | `~/<agent>/skills/` | Available across all projects                 |\n\n### Installation Methods\n\nWhen installing interactively, you can choose:\n\n| Method                    | Description                                                                                 |\n| ------------------------- | ------------------------------------------------------------------------------------------- |\n| **Symlink** (Recommended) | Creates symlinks from each agent to a canonical copy. Single source of truth, easy updates. |\n| **Copy**                  | Creates independent copies for each agent. Use when symlinks aren't supported.              |\n\n## Other Commands\n\n| Command                      | Description                                    |\n| ---------------------------- | ---------------------------------------------- |\n| `npx skills list`            | List installed skills (alias: `ls`)            |\n| `npx skills find [query]`    | Search for skills interactively or by keyword  |\n| `npx skills remove [skills]` | Remove installed skills from agents            |\n| `npx skills check`           | Check for available skill updates              |\n| `npx skills update`          | Update all installed skills to latest versions |\n| `npx skills init [name]`     | Create a new SKILL.md template                 |\n\n### `skills list`\n\nList all installed skills. Similar to `npm ls`.\n\n```bash\n# List all installed skills (project and global)\nnpx skills list\n\n# List only global skills\nnpx skills ls -g\n\n# Filter by specific agents\nnpx skills ls -a claude-code -a cursor\n```\n\n### `skills find`\n\nSearch for skills interactively or by keyword.\n\n```bash\n# Interactive search (fzf-style)\nnpx skills find\n\n# Search by keyword\nnpx skills find typescript\n```\n\n### `skills check` / `skills update`\n\n```bash\n# Check if any installed skills have updates\nnpx skills check\n\n# Update all skills to latest versions\nnpx skills update\n```\n\n### `skills init`\n\n```bash\n# Create SKILL.md in current directory\nnpx skills init\n\n# Create a new skill in a subdirectory\nnpx skills init my-skill\n```\n\n### `skills remove`\n\nRemove installed skills from agents.\n\n```bash\n# Remove interactively (select from installed skills)\nnpx skills remove\n\n# Remove specific skill by name\nnpx skills remove web-design-guidelines\n\n# Remove multiple skills\nnpx skills remove frontend-design web-design-guidelines\n\n# Remove from global scope\nnpx skills remove --global web-design-guidelines\n\n# Remove from specific agents only\nnpx skills remove --agent claude-code cursor my-skill\n\n# Remove all installed skills without confirmation\nnpx skills remove --all\n\n# Remove all skills from a specific agent\nnpx skills remove --skill '*' -a cursor\n\n# Remove a specific skill from all agents\nnpx skills remove my-skill --agent '*'\n\n# Use 'rm' alias\nnpx skills rm my-skill\n```\n\n| Option         | Description                                      |\n| -------------- | ------------------------------------------------ |\n| `-g, --global` | Remove from global scope (~/) instead of project |\n| `-a, --agent`  | Remove from specific agents (use `'*'` for all)  |\n| `-s, --skill`  | Specify skills to remove (use `'*'` for all)     |\n| `-y, --yes`    | Skip confirmation prompts                        |\n| `--all`        | Shorthand for `--skill '*' --agent '*' -y`       |\n\n## What are Agent Skills?\n\nAgent skills are reusable instruction sets that extend your coding agent's capabilities. They're defined in `SKILL.md`\nfiles with YAML frontmatter containing a `name` and `description`.\n\nSkills let agents perform specialized tasks like:\n\n- Generating release notes from git history\n- Creating PRs following your team's conventions\n- Integrating with external tools (Linear, Notion, etc.)\n\nDiscover skills at **[skills.sh](https://skills.sh)**\n\n## Supported Agents\n\nSkills can be installed to any of these agents:\n\n<!-- supported-agents:start -->\n| Agent | `--agent` | Project Path | Global Path |\n|-------|-----------|--------------|-------------|\n| Amp, Kimi Code CLI, Replit, Universal | `amp`, `kimi-cli`, `replit`, `universal` | `.agents/skills/` | `~/.config/agents/skills/` |\n| Antigravity | `antigravity` | `.agent/skills/` | `~/.gemini/antigravity/skills/` |\n| Augment | `augment` | `.augment/skills/` | `~/.augment/skills/` |\n| Claude Code | `claude-code` | `.claude/skills/` | `~/.claude/skills/` |\n| OpenClaw | `openclaw` | `skills/` | `~/.openclaw/skills/` |\n| Cline | `cline` | `.agents/skills/` | `~/.agents/skills/` |\n| CodeBuddy | `codebuddy` | `.codebuddy/skills/` | `~/.codebuddy/skills/` |\n| Codex | `codex` | `.agents/skills/` | `~/.codex/skills/` |\n| Command Code | `command-code` | `.commandcode/skills/` | `~/.commandcode/skills/` |\n| Continue | `continue` | `.continue/skills/` | `~/.continue/skills/` |\n| Cortex Code | `cortex` | `.cortex/skills/` | `~/.snowflake/cortex/skills/` |\n| Crush | `crush` | `.crush/skills/` | `~/.config/crush/skills/` |\n| Cursor | `cursor` | `.agents/skills/` | `~/.cursor/skills/` |\n| Droid | `droid` | `.factory/skills/` | `~/.factory/skills/` |\n| Gemini CLI | `gemini-cli` | `.agents/skills/` | `~/.gemini/skills/` |\n| GitHub Copilot | `github-copilot` | `.agents/skills/` | `~/.copilot/skills/` |\n| Goose | `goose` | `.goose/skills/` | `~/.config/goose/skills/` |\n| Junie | `junie` | `.junie/skills/` | `~/.junie/skills/` |\n| iFlow CLI | `iflow-cli` | `.iflow/skills/` | `~/.iflow/skills/` |\n| Kilo Code | `kilo` | `.kilocode/skills/` | `~/.kilocode/skills/` |\n| Kiro CLI | `kiro-cli` | `.kiro/skills/` | `~/.kiro/skills/` |\n| Kode | `kode` | `.kode/skills/` | `~/.kode/skills/` |\n| MCPJam | `mcpjam` | `.mcpjam/skills/` | `~/.mcpjam/skills/` |\n| Mistral Vibe | `mistral-vibe` | `.vibe/skills/` | `~/.vibe/skills/` |\n| Mux | `mux` | `.mux/skills/` | `~/.mux/skills/` |\n| OpenCode | `opencode` | `.agents/skills/` | `~/.config/opencode/skills/` |\n| OpenHands | `openhands` | `.openhands/skills/` | `~/.openhands/skills/` |\n| Pi | `pi` | `.pi/skills/` | `~/.pi/agent/skills/` |\n| Qoder | `qoder` | `.qoder/skills/` | `~/.qoder/skills/` |\n| Qwen Code | `qwen-code` | `.qwen/skills/` | `~/.qwen/skills/` |\n| Roo Code | `roo` | `.roo/skills/` | `~/.roo/skills/` |\n| Trae | `trae` | `.trae/skills/` | `~/.trae/skills/` |\n| Trae CN | `trae-cn` | `.trae/skills/` | `~/.trae-cn/skills/` |\n| Windsurf | `windsurf` | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |\n| Zencoder | `zencoder` | `.zencoder/skills/` | `~/.zencoder/skills/` |\n| Neovate | `neovate` | `.neovate/skills/` | `~/.neovate/skills/` |\n| Pochi | `pochi` | `.pochi/skills/` | `~/.pochi/skills/` |\n| AdaL | `adal` | `.adal/skills/` | `~/.adal/skills/` |\n<!-- supported-agents:end -->\n\n> [!NOTE]\n> **Kiro CLI users:** After installing skills, manually add them to your custom agent's `resources` in\n> `.kiro/agents/<agent>.json`:\n>\n> ```json\n> {\n>   \"resources\": [\"skill://.kiro/skills/**/SKILL.md\"]\n> }\n> ```\n\nThe CLI automatically detects which coding agents you have installed. If none are detected, you'll be prompted to select\nwhich agents to install to.\n\n## Creating Skills\n\nSkills are directories containing a `SKILL.md` file with YAML frontmatter:\n\n```markdown\n---\nname: my-skill\ndescription: What this skill does and when to use it\n---\n\n# My Skill\n\nInstructions for the agent to follow when this skill is activated.\n\n## When to Use\n\nDescribe the scenarios where this skill should be used.\n\n## Steps\n\n1. First, do this\n2. Then, do that\n```\n\n### Required Fields\n\n- `name`: Unique identifier (lowercase, hyphens allowed)\n- `description`: Brief explanation of what the skill does\n\n### Optional Fields\n\n- `metadata.internal`: Set to `true` to hide the skill from normal discovery. Internal skills are only visible and\n  installable when `INSTALL_INTERNAL_SKILLS=1` is set. Useful for work-in-progress skills or skills meant only for\n  internal tooling.\n\n```markdown\n---\nname: my-internal-skill\ndescription: An internal skill not shown by default\nmetadata:\n  internal: true\n---\n```\n\n### Skill Discovery\n\nThe CLI searches for skills in these locations within a repository:\n\n<!-- skill-discovery:start -->\n- Root directory (if it contains `SKILL.md`)\n- `skills/`\n- `skills/.curated/`\n- `skills/.experimental/`\n- `skills/.system/`\n- `.agents/skills/`\n- `.agent/skills/`\n- `.augment/skills/`\n- `.claude/skills/`\n- `./skills/`\n- `.codebuddy/skills/`\n- `.commandcode/skills/`\n- `.continue/skills/`\n- `.cortex/skills/`\n- `.crush/skills/`\n- `.factory/skills/`\n- `.goose/skills/`\n- `.junie/skills/`\n- `.iflow/skills/`\n- `.kilocode/skills/`\n- `.kiro/skills/`\n- `.kode/skills/`\n- `.mcpjam/skills/`\n- `.vibe/skills/`\n- `.mux/skills/`\n- `.openhands/skills/`\n- `.pi/skills/`\n- `.qoder/skills/`\n- `.qwen/skills/`\n- `.roo/skills/`\n- `.trae/skills/`\n- `.windsurf/skills/`\n- `.zencoder/skills/`\n- `.neovate/skills/`\n- `.pochi/skills/`\n- `.adal/skills/`\n<!-- skill-discovery:end -->\n\n### Plugin Manifest Discovery\n\nIf `.claude-plugin/marketplace.json` or `.claude-plugin/plugin.json` exists, skills declared in those files are also discovered:\n\n```json\n// .claude-plugin/marketplace.json\n{\n  \"metadata\": { \"pluginRoot\": \"./plugins\" },\n  \"plugins\": [\n    {\n      \"name\": \"my-plugin\",\n      \"source\": \"my-plugin\",\n      \"skills\": [\"./skills/review\", \"./skills/test\"]\n    }\n  ]\n}\n```\n\nThis enables compatibility with the [Claude Code plugin marketplace](https://code.claude.com/docs/en/plugin-marketplaces) ecosystem.\n\nIf no skills are found in standard locations, a recursive search is performed.\n\n## Compatibility\n\nSkills are generally compatible across agents since they follow a\nshared [Agent Skills specification](https://agentskills.io). However, some features may be agent-specific:\n\n| Feature         | OpenCode | OpenHands | Claude Code | Cline | CodeBuddy | Codex | Command Code | Kiro CLI | Cursor | Antigravity | Roo Code | Github Copilot | Amp | OpenClaw | Neovate | Pi  | Qoder | Zencoder |\n| --------------- | -------- | --------- | ----------- | ----- | --------- | ----- | ------------ | -------- | ------ | ----------- | -------- | -------------- | --- | -------- | ------- | --- | ----- | -------- |\n| Basic skills    | Yes      | Yes       | Yes         | Yes   | Yes       | Yes   | Yes          | Yes      | Yes    | Yes         | Yes      | Yes            | Yes | Yes      | Yes     | Yes | Yes   | Yes      |\n| `allowed-tools` | Yes      | Yes       | Yes         | Yes   | Yes       | Yes   | Yes          | No       | Yes    | Yes         | Yes      | Yes            | Yes | Yes      | Yes     | Yes | Yes   | No       |\n| `context: fork` | No       | No        | Yes         | No    | No        | No    | No           | No       | No     | No          | No       | No             | No  | No       | No      | No  | No    | No       |\n| Hooks           | No       | No        | Yes         | Yes   | No        | No    | No           | No       | No     | No          | No       | No             | No  | No       | No      | No  | No    | No       |\n\n## Troubleshooting\n\n### \"No skills found\"\n\nEnsure the repository contains valid `SKILL.md` files with both `name` and `description` in the frontmatter.\n\n### Skill not loading in agent\n\n- Verify the skill was installed to the correct path\n- Check the agent's documentation for skill loading requirements\n- Ensure the `SKILL.md` frontmatter is valid YAML\n\n### Permission errors\n\nEnsure you have write access to the target directory.\n\n## Environment Variables\n\n| Variable                  | Description                                                                |\n| ------------------------- | -------------------------------------------------------------------------- |\n| `INSTALL_INTERNAL_SKILLS` | Set to `1` or `true` to show and install skills marked as `internal: true` |\n| `DISABLE_TELEMETRY`       | Set to disable anonymous usage telemetry                                   |\n| `DO_NOT_TRACK`            | Alternative way to disable telemetry                                       |\n\n```bash\n# Install internal skills\nINSTALL_INTERNAL_SKILLS=1 npx skills add vercel-labs/agent-skills --list\n```\n\n## Telemetry\n\nThis CLI collects anonymous usage data to help improve the tool. No personal information is collected.\n\nTelemetry is automatically disabled in CI environments.\n\n## Related Links\n\n- [Agent Skills Specification](https://agentskills.io)\n- [Skills Directory](https://skills.sh)\n- [Amp Skills Documentation](https://ampcode.com/manual#agent-skills)\n- [Antigravity Skills Documentation](https://antigravity.google/docs/skills)\n- [Factory AI / Droid Skills Documentation](https://docs.factory.ai/cli/configuration/skills)\n- [Claude Code Skills Documentation](https://code.claude.com/docs/en/skills)\n- [OpenClaw Skills Documentation](https://docs.openclaw.ai/tools/skills)\n- [Cline Skills Documentation](https://docs.cline.bot/features/skills)\n- [CodeBuddy Skills Documentation](https://www.codebuddy.ai/docs/ide/Features/Skills)\n- [Codex Skills Documentation](https://developers.openai.com/codex/skills)\n- [Command Code Skills Documentation](https://commandcode.ai/docs/skills)\n- [Crush Skills Documentation](https://github.com/charmbracelet/crush?tab=readme-ov-file#agent-skills)\n- [Cursor Skills Documentation](https://cursor.com/docs/context/skills)\n- [Gemini CLI Skills Documentation](https://geminicli.com/docs/cli/skills/)\n- [GitHub Copilot Agent Skills](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills)\n- [iFlow CLI Skills Documentation](https://platform.iflow.cn/en/cli/examples/skill)\n- [Kimi Code CLI Skills Documentation](https://moonshotai.github.io/kimi-cli/en/customization/skills.html)\n- [Kiro CLI Skills Documentation](https://kiro.dev/docs/cli/custom-agents/configuration-reference/#skill-resources)\n- [Kode Skills Documentation](https://github.com/shareAI-lab/kode/blob/main/docs/skills.md)\n- [OpenCode Skills Documentation](https://opencode.ai/docs/skills)\n- [Qwen Code Skills Documentation](https://qwenlm.github.io/qwen-code-docs/en/users/features/skills/)\n- [OpenHands Skills Documentation](https://docs.openhands.ai/modules/usage/how-to/using-skills)\n- [Pi Skills Documentation](https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/skills.md)\n- [Qoder Skills Documentation](https://docs.qoder.com/cli/Skills)\n- [Replit Skills Documentation](https://docs.replit.com/replitai/skills)\n- [Roo Code Skills Documentation](https://docs.roocode.com/features/skills)\n- [Trae Skills Documentation](https://docs.trae.ai/ide/skills)\n- [Vercel Agent Skills Repository](https://github.com/vercel-labs/agent-skills)\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-fa27bd820825101965583d0509cd5827"}