* fix(plugins): bump all plugins to 2.14.1 and gate unbumped changes Claude Code caches plugins by version. 70 of 104 plugins changed between v2.12.0 and v2.14.0 without a bump, so claude plugin update reported "already at the latest version" and existing installs never received the v2.13/v2.14 fixes. Every plugin moves to 2.14.1 so stale caches refresh once. check_plugin_versions.py (G11, blocking in ci-quality-gate) fails when a plugin's payload, including symlinked vendor files, changes without a higher version, and when marketplace.json and plugin.json disagree. bump_plugin_versions.py sets both together. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016uNBQ6tRS5P1dRsgNfK4Wh * fix(codex): stop installing all skills by default With the full library (~380 skills) Codex drops every skill description from its prompt budget, so it cannot pick skills. codex-install.sh now asks for --category (comma-separated), --skill or an explicit --all, lists categories when run without arguments, and warns when more than ~100 skills are installed. The Windows installer and install docs follow. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016uNBQ6tRS5P1dRsgNfK4Wh * fix(gemini): link whole skill folders and drop duplicate mirror entries Each .gemini/skills entry held only a SKILL.md symlink, so the relative scripts/ and references/ a skill points to were missing. Entries are now directory symlinks (Gemini CLI 0.65 discovers them). Dual-published copies with identical SKILL.md are listed once, commands and agents that share a skill's name are skipped, fixtures under assets/ and vendor/ re-exports are excluded, discovery is sorted so reruns are stable, and stale generated entries are pruned. gemini skills list: 20 conflicts -> 1 (handoff, fixed next). GEMINI.md documents folder trust and fixes a dead example path. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016uNBQ6tRS5P1dRsgNfK4Wh * fix(handoff): rename the productivity skill to session-handoff engineering/handoff and productivity/handoff both shipped a skill named handoff. Claude Code namespaces them, but Codex, Gemini CLI, Vibe and Hermes key skills by name and silently kept one. The productivity skill is now session-handoff (handoff-productivity:session-handoff); its folder, plugin manifest, hook script paths, command paths, mirrors, harness manifest and docs page follow. /cs-handoff, /cs-handoff-setup and ~/.config/handoff are unchanged; the plugin README carries a migration note. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016uNBQ6tRS5P1dRsgNfK4Wh * fix(convert): include plugins whose SKILL.md is at the plugin root convert.sh searched at -mindepth 4, which skipped boost-asio-pro, deepread, hivemind, loop-library, minimalist, strict-api and swedish-mentor for every converted tool (opencode, Cursor, Windsurf, Kilo, Augment, Aider, Antigravity). It now searches from depth 2 and skips assets/ fixtures. opencode conversion: 375 -> 382 skills. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016uNBQ6tRS5P1dRsgNfK4Wh * fix(codex): keep skill-tester's sample fixture from loading as a skill Codex scans installed skill folders recursively and picked up skill-tester/assets/sample-skill/SKILL.md as 'sample-text-processor'. The installer renames SKILL.md files under assets/ in the installed copy. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016uNBQ6tRS5P1dRsgNfK4Wh * fix(plugins): address scripts via ${CLAUDE_PLUGIN_ROOT} in commands and agents 343 script invocations in 90 command/agent files across 36 plugins used repo-relative or ../ paths. Plugin commands and agents run from the user's project, so those paths only resolved inside a clone of this repo; in the v2.14.0 evals the agent fell back to find / to locate scripts. Every one now uses ${CLAUDE_PLUGIN_ROOT}/. Two cross-plugin calls (write-a-skill -> karpathy-coder, c-level-agents cpo -> product-manager-toolkit) go through vendor/ symlinks, per the repo's install-cache lesson. check_paths.py (G1) now fails a plugin command or agent that invokes a script without ${CLAUDE_PLUGIN_ROOT}; on the v2.14.0 tree it reports 279. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016uNBQ6tRS5P1dRsgNfK4Wh * fix(month-end-close): treat opening-balance rows as balances and pair transpositions On a bank and GL export that each begin with an 'Opening balance' row, the matcher returned RECONCILED_WITH_ITEMS and told the user to book a 25,000.00 journal entry for the opening balance, and it reported a 7,980/7,890 transposition as two unrelated items. Opening rows are now balances: a difference between them is reported as carried in from the prior period (R5, blocks sign-off, never booked). Same-date digit transpositions pair into one correcting entry. The GL file's 'memo' column is read as description. The v2.14.0 eval fixture now proves 1,405.00 = 150 opening + 90 transposition + 1,200 outstanding check - 35 bank fee. Bundled copy synced. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016uNBQ6tRS5P1dRsgNfK4Wh * fix(coding-agent-rollout): flag connection-URL passwords and production MCP servers On a committed .claude/settings.json holding env.DATABASE_URL=postgresql://admin:<password>@prod-db... and enabledMcpjsonServers: ["postgres-prod"], the linter flagged neither: the env check only matched token formats and KEY/TOKEN/SECRET names. S11 now catches a password embedded in any connection URL (BLOCKER in shared files), and new S13 warns when a shared file pre-approves an MCP server whose name marks it as production. Bundled copy synced; --sample output unchanged. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016uNBQ6tRS5P1dRsgNfK4Wh * docs: changelog and lessons for the v2.14.0 audit fixes Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016uNBQ6tRS5P1dRsgNfK4Wh --------- Co-authored-by: Claude <noreply@anthropic.com>
11 KiB
| title | description |
|---|---|
| Install Agent Skills — Claude Code, Codex, Gemini CLI Setup | How to install 345 agent skills and 78 plugins in any of 13 AI coding tools. Step-by-step setup for Claude Code, OpenAI Codex, Gemini CLI, Hermes Agent, Mistral Vibe, OpenClaw, Cursor, Aider, Windsurf, and more — most take under two minutes. |
Getting Started
Installing agent skills takes under two minutes on most platforms. There's nothing to configure: no API keys, no dependencies, no build step. Pick your tool below, run the commands, and the skills are live.
New here? Read What is an Agent Skill? first, or jump straight to a tool-specific guide: Claude Code, OpenAI Codex, Gemini CLI, Cursor, or OpenClaw.
Installation
Choose your platform and follow the steps:
=== "Claude Code"
<ol class="install-steps">
<li>
<strong>Add the marketplace</strong>
<pre><code>/plugin marketplace add alirezarezvani/claude-skills</code></pre>
</li>
<li>
<strong>Install the skills you need</strong>
<pre><code>/plugin install engineering-skills@claude-code-skills</code></pre>
</li>
<li>
<strong>Use them immediately</strong> — skills activate as slash commands or contextual expertise.
</li>
</ol>
=== "OpenAI Codex"
```bash
npx agent-skills-cli add alirezarezvani/claude-skills --agent codex
```
Or clone and install manually:
```bash
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
./scripts/codex-install.sh --category engineering # no arguments lists the categories
```
=== "Gemini CLI"
```bash
git clone https://github.com/alirezarezvani/claude-skills.git
./scripts/gemini-install.sh
```
Or use the sync script to generate the skills index:
```bash
python3 scripts/sync-gemini-skills.py
```
=== "OpenClaw"
```bash
bash <(curl -s https://raw.githubusercontent.com/alirezarezvani/claude-skills/main/scripts/openclaw-install.sh)
```
=== "Hermes Agent"
[Hermes Agent](https://github.com/NousResearch/hermes-agent) uses the same agentskills.io SKILL.md standard — no format conversion needed.
```bash
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
python scripts/sync-hermes-skills.py --verbose
```
Skills install to `~/.hermes/skills/claude-skills/` and are automatically discovered by Hermes via `/skills` or `/<skill-name>`.
Sync options:
```bash
python scripts/sync-hermes-skills.py --domain engineering # one domain only
python scripts/sync-hermes-skills.py --copy # copy instead of symlink
python scripts/sync-hermes-skills.py --dry-run # preview
```
=== "Mistral Vibe"
[Mistral Vibe](https://github.com/mistralai/mistral-vibe) is Mistral AI's open-source Apache-2.0 CLI coding agent. It uses the same agentskills.io SKILL.md standard — no format conversion needed.
```bash
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
./scripts/vibe-install.sh
```
Skills install to `~/.vibe/skills/claude-skills/` (345 skills across 17 domains) and are automatically discovered by Vibe via `/skills` or `/<skill-name>`. See the [official Vibe docs](https://docs.mistral.ai/mistral-vibe/agents-skills) for details on the skills format.
Sync options:
```bash
python scripts/sync-vibe-skills.py --domain engineering # one domain only
python scripts/sync-vibe-skills.py --copy # copy instead of symlink
python scripts/sync-vibe-skills.py --dry-run # preview
python scripts/sync-vibe-skills.py --target /opt/team/ # custom location
```
=== "Cursor"
```bash
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
./scripts/convert.sh --tool cursor
./scripts/install.sh --tool cursor --target /path/to/project
```
=== "Aider"
```bash
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
./scripts/convert.sh --tool aider
./scripts/install.sh --tool aider --target /path/to/project
```
=== "Windsurf"
```bash
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
./scripts/convert.sh --tool windsurf
./scripts/install.sh --tool windsurf --target /path/to/project
```
=== "Kilo Code"
```bash
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
./scripts/convert.sh --tool kilocode
./scripts/install.sh --tool kilocode --target /path/to/project
```
=== "OpenCode"
```bash
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
./scripts/convert.sh --tool opencode
./scripts/install.sh --tool opencode --target /path/to/project
```
=== "Augment"
```bash
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
./scripts/convert.sh --tool augment
./scripts/install.sh --tool augment --target /path/to/project
```
=== "Antigravity"
```bash
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
./scripts/convert.sh --tool antigravity
./scripts/install.sh --tool antigravity
```
=== "Manual"
```bash
git clone https://github.com/alirezarezvani/claude-skills.git
# Copy any skill folder to ~/.claude/skills/
```
!!! tip "All conversion-based tools at once"
Convert for every supported tool in one command:
bash ./scripts/convert.sh --tool all
See the Multi-Tool Integrations page for detailed per-tool documentation.
Available Bundles
Domain bundles install a whole team of skills at once:
| Bundle | Install Command | Skills |
|---|---|---|
| Engineering — Core | /plugin install engineering-skills@claude-code-skills |
51 |
| Engineering — Advanced | /plugin install engineering-advanced-skills@claude-code-skills |
74 |
| Product | /plugin install product-skills@claude-code-skills |
17 |
| Marketing | /plugin install marketing-skills@claude-code-skills |
47 |
| Regulatory & Quality | /plugin install ra-qm-skills@claude-code-skills |
18 |
| Compliance OS | /plugin install compliance-os@claude-code-skills |
9 |
| Project Management | /plugin install pm-skills@claude-code-skills |
9 |
| C-Level Advisory | /plugin install c-level-skills@claude-code-skills |
61 |
| Business & Growth | /plugin install business-growth-skills@claude-code-skills |
5 |
| Business Operations | /plugin install business-operations-skills@claude-code-skills |
7 |
| Commercial | /plugin install commercial-skills@claude-code-skills |
8 |
| Finance | /plugin install finance-skills@claude-code-skills |
4 |
| Research Operations | /plugin install research-ops-skills@claude-code-skills |
5 |
| Markdown to HTML | /plugin install markdown-html-skills@claude-code-skills |
5 |
Productivity and research skills ship as standalone plugins (for example capture-skill, pulse, litreview, grants). Browse the plugin marketplace for the full list, or install any individual skill: /plugin install skill-name@claude-code-skills
Usage
Slash Commands
/pw:generate Generate Playwright tests
/pw:fix Fix flaky test failures
/si:review Review auto-memory health
/si:promote Graduate a learning to CLAUDE.md
/board-meeting Trigger a C-suite board meeting
Contextual Prompts
Using the senior-architect skill, review our microservices
architecture and identify the top 3 scalability risks.
Using the content-creator skill, write a blog post about
AI-augmented development. Optimize for SEO.
Python Tools
Every skill's bundled tools use the Python standard library only — over 550 scripts, zero pip installs, all verified with --help smoke tests.
# Security audit a skill before installing
python3 engineering/skill-security-auditor/scripts/skill_security_auditor.py /path/to/skill/
# Analyze brand voice
python3 marketing-skill/content-production/scripts/brand_voice_analyzer.py article.txt
# RICE prioritization
python3 product-team/product-manager-toolkit/scripts/rice_prioritizer.py features.csv
# Generate landing page (TSX + Tailwind)
python3 product-team/landing-page-generator/scripts/landing_page_scaffolder.py config.json --format tsx
# Tech debt scoring
python3 c-level-advisor/cto-advisor/scripts/tech_debt_analyzer.py /path/to/codebase
Security
!!! warning "Always audit untrusted skills"
Before installing skills from third-party sources, run the security auditor:
```bash
python3 engineering/skill-security-auditor/scripts/skill_security_auditor.py /path/to/skill/
```
Returns **PASS** / **WARN** / **FAIL** with remediation guidance. Scans for command injection, data exfiltration, prompt injection, and supply chain risks.
Creating Your Own
Each skill is a folder:
my-skill/
SKILL.md # Instructions + workflows
scripts/ # Python CLI tools (optional)
references/ # Domain knowledge (optional)
assets/ # Templates (optional)
See the Skills & Agents Factory for a complete guide.
FAQ
??? question "Do I need API keys?" No. Skills work locally with no external API calls. All Python tools use stdlib only.
??? question "Can I install individual skills instead of bundles?"
Yes. Use /plugin install skill-name@claude-code-skills for any single skill.
??? question "Do skills conflict with each other?" No. Each skill is self-contained with no cross-dependencies.
??? question "How do I update installed skills?" Re-run the install command. The plugin system fetches the latest version from the marketplace.
??? question "Will upgrading break my setup?" No. Releases are backward compatible — existing SKILL.md files, scripts, and references keep working. New skills and domains are additive only.
??? question "Does this work with Gemini CLI?"
Yes. Run ./scripts/gemini-install.sh to set up skills for Gemini CLI. A sync script (scripts/sync-gemini-skills.py) generates the skills index automatically.
??? question "Does this work with Cursor, Windsurf, Aider, or other tools?"
Yes. All 345 skills can be converted to native formats for Cursor, Aider, Kilo Code, Windsurf, OpenCode, Augment, and Antigravity. Run ./scripts/convert.sh --tool all and then install with ./scripts/install.sh --tool <name>. See Multi-Tool Integrations for details.
??? question "Can I use Agent Skills in ChatGPT?" Yes. We have 6 Custom GPTs that bring Agent Skills directly into ChatGPT — no installation needed. Just click and start chatting.