claude-skills/docs/getting-started.md
Alireza Rezvani ebbf6b0872
Some checks failed
Sync Codex Skills Symlinks / sync (push) Has been cancelled
fix: v2.14.0 audit P0/P1 fixes (plugin updates, Codex, mirrors, script paths, two script bugs) (#1048)
* 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>
2026-10-22 09:50:05 +02:00

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.