diff --git a/README.md b/README.md index c101023..acf616b 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,8 @@ # Claude Code Skills & Plugins -**177 production-ready skills and plugins for Claude Code, OpenAI Codex, Gemini CLI, and OpenClaw** — reusable expertise bundles that transform AI coding agents into specialized professionals across engineering, product, marketing, compliance, and more. +**177 production-ready skills and plugins for 11 AI coding tools** — reusable expertise bundles that transform AI coding agents into specialized professionals across engineering, product, marketing, compliance, and more. + +**Works with:** Claude Code · OpenAI Codex · Gemini CLI · OpenClaw · Cursor · Aider · Windsurf · Kilo Code · OpenCode · Augment · Antigravity [![License: MIT](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](https://opensource.org/licenses/MIT) [![Skills](https://img.shields.io/badge/Skills-177-brightgreen?style=for-the-badge)](#skills-overview) @@ -17,7 +19,7 @@ Skills are modular instruction packages (plugins) that give AI coding agents domain expertise they don't have out of the box. Each skill includes a `SKILL.md` (instructions + workflows), Python CLI tools, and reference documentation — everything the agent needs to perform like a specialist. -**One repo, four platforms:** Works natively as Claude Code plugins, OpenAI Codex CLI and agents, Gemini CLI skills, and OpenClaw skills. All 254 Python tools are stdlib-only and verified working. +**One repo, eleven platforms:** Works natively with Claude Code, OpenAI Codex, Gemini CLI, OpenClaw, Cursor, Aider, Windsurf, Kilo Code, OpenCode, Augment, and Antigravity. All 254 Python tools are stdlib-only and verified working. --- @@ -268,8 +270,8 @@ python3 product-team/landing-page-generator/scripts/landing_page_scaffolder.py c **How do I install Claude Code plugins?** Add the marketplace with `/plugin marketplace add alirezarezvani/claude-skills`, then install any skill bundle with `/plugin install @claude-code-skills`. -**Do these skills work with OpenAI Codex?** -Yes. Skills work natively with Claude Code, OpenAI Codex, Gemini CLI, and OpenClaw. See Quick Install above. +**Do these skills work with OpenAI Codex / Cursor / Windsurf / Aider?** +Yes. Skills work natively with 11 tools: Claude Code, OpenAI Codex, Gemini CLI, OpenClaw, Cursor, Aider, Windsurf, Kilo Code, OpenCode, Augment, and Antigravity. Run `./scripts/convert.sh --tool all` to convert for all tools, then install with `./scripts/install.sh --tool `. See [Multi-Tool Integrations](https://alirezarezvani.github.io/claude-skills/integrations/) for details. **Will updating break my installation?** No. We follow semantic versioning and maintain backward compatibility within patch releases. Existing script arguments, plugin source paths, and SKILL.md structures are never changed in patch versions. See the [CHANGELOG](CHANGELOG.md) for details on each release. diff --git a/docs/getting-started.md b/docs/getting-started.md index 302e66d..1b6532d 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -57,6 +57,69 @@ Choose your platform and follow the steps: bash <(curl -s https://raw.githubusercontent.com/alirezarezvani/claude-skills/main/scripts/openclaw-install.sh) ``` +=== "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 @@ -64,6 +127,13 @@ Choose your platform and follow the steps: # Copy any skill folder to ~/.claude/skills/ ``` +!!! tip "All 7 tools at once" + Convert for every supported tool in one command: + ```bash + ./scripts/convert.sh --tool all + ``` + See the [Multi-Tool Integrations](integrations.md) page for detailed per-tool documentation. +
## Available Bundles @@ -182,3 +252,6 @@ See the [Skills & Agents Factory](https://github.com/alirezarezvani/claude-code- ??? 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 156 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 `. See [Multi-Tool Integrations](integrations.md) for details. diff --git a/docs/index.md b/docs/index.md index b9f52a9..cfad8f8 100644 --- a/docs/index.md +++ b/docs/index.md @@ -17,7 +17,7 @@ hide: 177 production-ready skills that transform AI coding agents into specialized professionals. { .hero-subtitle } -**Claude Code** | **OpenAI Codex** | **Gemini CLI** | **OpenClaw** +**Claude Code** | **OpenAI Codex** | **Gemini CLI** | **OpenClaw** | **Cursor** | **Aider** | **Windsurf** | **Kilo Code** | **OpenCode** | **Augment** | **Antigravity** { .hero-platforms } [Get Started](getting-started.md){ .md-button .md-button--primary } @@ -173,7 +173,7 @@ hide: --- - Works natively with Claude Code, OpenAI Codex, and OpenClaw — same skills, any agent. + Works natively with 11 tools: Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Aider, Windsurf, Kilo Code, OpenCode, Augment, and Antigravity. - :material-check-decagram:{ .lg .middle } **Production-grade** @@ -196,4 +196,5 @@ hide: ``` [Full Install Guide](getting-started.md){ .md-button .md-button--primary } +[Multi-Tool Setup](integrations.md){ .md-button } [View on GitHub :fontawesome-brands-github:](https://github.com/alirezarezvani/claude-skills){ .md-button } diff --git a/docs/integrations.md b/docs/integrations.md new file mode 100644 index 0000000..9c7a9ce --- /dev/null +++ b/docs/integrations.md @@ -0,0 +1,607 @@ +--- +title: Multi-Tool Integrations +description: "Use Claude Code Skills with Cursor, Aider, Kilo Code, Windsurf, OpenCode, Augment, and Antigravity. Convert and install all 156 skills in seconds." +--- + +# Multi-Tool Integrations + +All 156 skills in this repository can be converted to work natively with **7 AI coding tools** beyond Claude Code, Codex, and Gemini CLI. The conversion preserves skill instructions, workflows, and supporting files — adapting only the format each tool expects. + +
+ +- :material-cursor-default-click:{ .lg .middle } **Cursor** + + --- + + `.mdc` rule files in `.cursor/rules/` + + [:octicons-arrow-right-24: Jump to Cursor](#cursor) + +- :material-code-braces:{ .lg .middle } **Aider** + + --- + + Single `CONVENTIONS.md` file + + [:octicons-arrow-right-24: Jump to Aider](#aider) + +- :material-alpha-k-box:{ .lg .middle } **Kilo Code** + + --- + + Markdown rules in `.kilocode/rules/` + + [:octicons-arrow-right-24: Jump to Kilo Code](#kilo-code) + +- :material-surfing:{ .lg .middle } **Windsurf** + + --- + + `SKILL.md` bundles in `.windsurf/skills/` + + [:octicons-arrow-right-24: Jump to Windsurf](#windsurf) + +- :material-console:{ .lg .middle } **OpenCode** + + --- + + `SKILL.md` bundles in `.opencode/skills/` + + [:octicons-arrow-right-24: Jump to OpenCode](#opencode) + +- :material-auto-fix:{ .lg .middle } **Augment** + + --- + + Rule files in `.augment/rules/` + + [:octicons-arrow-right-24: Jump to Augment](#augment) + +- :material-google:{ .lg .middle } **Antigravity** + + --- + + `SKILL.md` bundles in `~/.gemini/antigravity/skills/` + + [:octicons-arrow-right-24: Jump to Antigravity](#antigravity) + +
+ +
+ +## Quick Start + +### 1. Convert + +```bash +git clone https://github.com/alirezarezvani/claude-skills.git +cd claude-skills + +# Convert all skills for all tools (~15 seconds) +./scripts/convert.sh --tool all + +# Or convert for a specific tool only +./scripts/convert.sh --tool cursor +``` + +### 2. Install + +```bash +# Install into your project directory +./scripts/install.sh --tool cursor --target /path/to/project + +# Or install globally (Antigravity) +./scripts/install.sh --tool antigravity + +# Skip confirmation prompts +./scripts/install.sh --tool aider --target . --force +``` + +### 3. Verify + +Each tool section below includes a verification step to confirm skills are loaded. + +!!! tip "Regenerate after updates" + When you pull new skills from the repository, re-run `./scripts/convert.sh` and `./scripts/install.sh` to update your local installation. + +
+ +## How Conversion Works + +The converter reads each skill's `SKILL.md` frontmatter (`name` and `description`) and markdown body, then outputs the format each tool expects: + +| Source | Target | What Changes | +|--------|--------|--------------| +| YAML frontmatter | Tool-specific frontmatter | Field names/values adapted per tool | +| Markdown body | Passed through | Instructions preserved as-is | +| `scripts/` dir | Copied (where supported) | Antigravity, Windsurf, OpenCode | +| `references/` dir | Copied (where supported) | Antigravity, Windsurf, OpenCode | +| `templates/` dir | Copied (where supported) | Antigravity, Windsurf, OpenCode | + +Tools that use flat files (Cursor, Aider, Kilo Code, Augment) get the SKILL.md body only — supporting directories are not copied since those tools don't support subdirectories per rule. + +
+ +## Cursor + +[Cursor](https://cursor.com) uses `.mdc` rule files in `.cursor/rules/` with frontmatter for description, glob patterns, and auto-apply settings. + +### Format + +Each skill becomes a single `.mdc` file: + +```yaml +--- +description: "What this skill does and when to activate it" +globs: +alwaysApply: false +--- + +# Skill instructions here... +``` + +- **`alwaysApply: false`** — skills are available on-demand, not always loaded +- **`globs:`** — empty by default; add file patterns to auto-activate for specific files (e.g., `*.test.ts`) + +### Install + +=== "Script" + + ```bash + ./scripts/convert.sh --tool cursor + ./scripts/install.sh --tool cursor --target /path/to/project + ``` + +=== "Manual" + + ```bash + mkdir -p /path/to/project/.cursor/rules + cp integrations/cursor/rules/*.mdc /path/to/project/.cursor/rules/ + ``` + +### Verify + +```bash +find .cursor/rules -name "*.mdc" | wc -l +# Expected: 156 +``` + +Open the Cursor rules panel to see all available skills listed. + +### Customization + +After installation, you can: + +- Set `alwaysApply: true` on skills you want active in every conversation +- Add `globs: "*.py"` to auto-activate Python-related skills for `.py` files +- Remove skills you don't need to keep your rules panel clean + +
+ +## Aider + +[Aider](https://aider.chat) reads a `CONVENTIONS.md` file from your project root. All skills are concatenated into this single file with section headers. + +### Format + +```markdown +# Claude Skills — Aider Conventions +> Auto-generated from claude-skills. Do not edit manually. +> Generated: 2026-03-11 + +--- + +## copywriting +> When the user wants to write, rewrite, or improve marketing copy... + +# Copywriting + +You are an expert conversion copywriter... + +--- + +## senior-architect +> Deep expertise in system architecture... + +# Senior Architect +... +``` + +### Install + +=== "Script" + + ```bash + ./scripts/convert.sh --tool aider + ./scripts/install.sh --tool aider --target /path/to/project + ``` + +=== "Manual" + + ```bash + cp integrations/aider/CONVENTIONS.md /path/to/project/ + ``` + +### Usage + +```bash +# Aider automatically reads CONVENTIONS.md from the project root +aider + +# Or explicitly point to it +aider --read CONVENTIONS.md +``` + +### Verify + +```bash +wc -l CONVENTIONS.md +# Expected: ~41,000 lines (all 156 skills) + +grep -c "^## " CONVENTIONS.md +# Expected: 156 (one section per skill) +``` + +!!! note "Large file" + The combined `CONVENTIONS.md` is ~41K lines. Aider handles this well, but if you prefer a smaller file, you can edit it to keep only the skills relevant to your project. + +
+ +## Kilo Code + +[Kilo Code](https://kilo.ai) reads plain markdown rules from `.kilocode/rules/`. No special frontmatter required. + +### Format + +Each skill becomes a clean markdown file: + +```markdown +# copywriting +> When the user wants to write, rewrite, or improve marketing copy... + +# Copywriting + +You are an expert conversion copywriter... +``` + +### Install + +=== "Script" + + ```bash + ./scripts/convert.sh --tool kilocode + ./scripts/install.sh --tool kilocode --target /path/to/project + ``` + +=== "Manual" + + ```bash + mkdir -p /path/to/project/.kilocode/rules + cp integrations/kilocode/rules/*.md /path/to/project/.kilocode/rules/ + ``` + +### Verify + +```bash +find .kilocode/rules -name "*.md" | wc -l +# Expected: 156 +``` + +Open Kilo Code's rules panel (click the ⚖ icon) to see all rules loaded. + +### Mode-Specific Rules + +Kilo Code supports mode-specific rules. To assign skills to specific modes: + +```bash +# Move architecture skills to "architect" mode +mkdir -p .kilocode/rules-architect/ +mv .kilocode/rules/senior-architect.md .kilocode/rules-architect/ +mv .kilocode/rules/database-designer.md .kilocode/rules-architect/ +``` + +
+ +## Windsurf + +[Windsurf](https://windsurf.com) uses the same `SKILL.md` format as Claude Code — skills convert with minimal changes. + +### Format + +Each skill becomes a directory with `SKILL.md` plus optional supporting files: + +``` +.windsurf/skills/copywriting/ +├── SKILL.md # Instructions with name/description frontmatter +├── scripts/ # Python tools (if present in source) +├── references/ # Domain knowledge (if present) +└── templates/ # Code templates (if present) +``` + +```yaml +--- +name: "copywriting" +description: "When the user wants to write, rewrite, or improve marketing copy..." +--- + +# Copywriting +... +``` + +### Install + +=== "Script" + + ```bash + ./scripts/convert.sh --tool windsurf + ./scripts/install.sh --tool windsurf --target /path/to/project + ``` + +=== "Manual" + + ```bash + cp -R integrations/windsurf/skills/* /path/to/project/.windsurf/skills/ + ``` + +### Verify + +```bash +find .windsurf/skills -name "SKILL.md" | wc -l +# Expected: 156 +``` + +Skills appear automatically in Windsurf's skill list. You can also invoke them with `@skill-name`. + +### Progressive Disclosure + +Windsurf uses progressive disclosure — only the skill name and description are shown by default. The full `SKILL.md` content loads only when Windsurf decides the skill is relevant to your request, keeping your context window lean. + +
+ +## OpenCode + +[OpenCode](https://opencode.ai) supports skills in `.opencode/skills/` with `SKILL.md` files. It also reads Claude Code's `.claude/skills/` as a fallback. + +### Format + +Each skill becomes a directory with `SKILL.md`: + +```yaml +--- +name: "copywriting" +description: "When the user wants to write, rewrite, or improve marketing copy..." +compatibility: opencode +--- + +# Copywriting +... +``` + +The `compatibility: opencode` field is added to help OpenCode identify these as native skills. + +### Install + +=== "Script" + + ```bash + ./scripts/convert.sh --tool opencode + ./scripts/install.sh --tool opencode --target /path/to/project + ``` + +=== "Manual" + + ```bash + cp -R integrations/opencode/skills/* /path/to/project/.opencode/skills/ + ``` + +=== "Global" + + ```bash + # Install globally for all projects + cp -R integrations/opencode/skills/* ~/.config/opencode/skills/ + ``` + +### Verify + +```bash +find .opencode/skills -name "SKILL.md" | wc -l +# Expected: 156 +``` + +### Claude Code Compatibility + +OpenCode also reads `.claude/skills/` directories. If you already have skills installed for Claude Code, OpenCode will discover them automatically — no conversion needed. + +To disable this fallback: + +```bash +export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 +``` + +
+ +## Augment + +[Augment](https://augmentcode.com) reads rule files from `.augment/rules/` with frontmatter specifying activation type. + +### Format + +Each skill becomes a markdown rule file: + +```yaml +--- +type: auto +description: "When the user wants to write, rewrite, or improve marketing copy..." +--- + +# Copywriting +... +``` + +- **`type: auto`** — Augment automatically activates the rule when it matches your request +- Other types: `always` (always loaded), `manual` (user-invoked only) + +### Install + +=== "Script" + + ```bash + ./scripts/convert.sh --tool augment + ./scripts/install.sh --tool augment --target /path/to/project + ``` + +=== "Manual" + + ```bash + mkdir -p /path/to/project/.augment/rules + cp integrations/augment/rules/*.md /path/to/project/.augment/rules/ + ``` + +### Verify + +```bash +find .augment/rules -name "*.md" | wc -l +# Expected: 156 +``` + +### Customization + +Change `type: auto` to `type: always` for skills you want loaded in every conversation: + +```bash +# Make coding standards always active +sed -i 's/type: auto/type: always/' .augment/rules/senior-architect.md +``` + +
+ +## Antigravity + +[Antigravity](https://idx.google.com/) (Google) uses `SKILL.md` files in `~/.gemini/antigravity/skills/` with additional metadata fields. + +### Format + +```yaml +--- +name: "copywriting" +description: "When the user wants to write, rewrite, or improve marketing copy..." +risk: low +source: community +date_added: '2026-03-11' +--- + +# Copywriting +... +``` + +Additional fields: + +- **`risk: low`** — all skills are instruction-only, no dangerous operations +- **`source: community`** — identifies these as community-contributed skills +- **`date_added`** — conversion date for tracking freshness + +### Install + +=== "Script" + + ```bash + ./scripts/convert.sh --tool antigravity + ./scripts/install.sh --tool antigravity + # Installs to ~/.gemini/antigravity/skills/ by default + ``` + +=== "Manual" + + ```bash + cp -R integrations/antigravity/* ~/.gemini/antigravity/skills/ + ``` + +### Verify + +```bash +find ~/.gemini/antigravity/skills -name "SKILL.md" | wc -l +# Expected: 156 +``` + +
+ +## Script Reference + +### convert.sh + +``` +Usage: + ./scripts/convert.sh [--tool ] [--out ] [--help] + +Tools: + antigravity, cursor, aider, kilocode, windsurf, opencode, augment, all + +Options: + --tool Convert for a specific tool (default: all) + --out Output directory (default: integrations/) + --help Show usage +``` + +**Examples:** + +```bash +# Convert all skills for all tools +./scripts/convert.sh + +# Convert only for Cursor +./scripts/convert.sh --tool cursor + +# Custom output directory +./scripts/convert.sh --tool windsurf --out /tmp/my-skills +``` + +### install.sh + +``` +Usage: + ./scripts/install.sh --tool [--target ] [--force] [--help] + +Options: + --tool Required. Which tool to install for. + --target Project directory (default: current dir, except antigravity) + --force Skip overwrite confirmation + --help Show usage +``` + +**Default install locations:** + +| Tool | Default Target | +|------|---------------| +| Antigravity | `~/.gemini/antigravity/skills/` | +| Cursor | `/.cursor/rules/` | +| Aider | `/CONVENTIONS.md` | +| Kilo Code | `/.kilocode/rules/` | +| Windsurf | `/.windsurf/skills/` | +| OpenCode | `/.opencode/skills/` | +| Augment | `/.augment/rules/` | + +
+ +## Troubleshooting + +??? question "I get 'No skills found' when running convert.sh" + Make sure you're running the script from the repository root where the skill directories are located. + +??? question "Some skills show garbled descriptions" + This can happen with skills using complex YAML multi-line descriptions. Re-run `convert.sh` — the parser handles folded (`>`) and literal (`|`) YAML scalars. + +??? question "Can I use skills from multiple tools at once?" + Yes! You can install skills for Cursor and Windsurf in the same project — they use different directories and won't conflict. + +??? question "How do I update when new skills are added?" + ```bash + git pull origin main + ./scripts/convert.sh --tool all + ./scripts/install.sh --tool --target . --force + ``` + +??? question "Can I convert only specific skills?" + Not yet via CLI flags, but you can run `convert.sh` and then copy only the skills you want from `integrations//`. + +??? question "Do supporting files (scripts, references) work in all tools?" + Only tools that support subdirectories per skill (Antigravity, Windsurf, OpenCode) get the full bundle. Flat-file tools (Cursor, Aider, Kilo Code, Augment) get the SKILL.md content only. diff --git a/mkdocs.yml b/mkdocs.yml index ea0451e..2181f73 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1,6 +1,6 @@ site_name: Claude Code Skills & Plugins site_url: https://alirezarezvani.github.io/claude-skills/ -site_description: "177 production-ready skills, 16 agents, and 17 commands for Claude Code, OpenAI Codex, Gemini CLI, and OpenClaw. Reusable expertise for engineering, product, marketing, compliance, and more." +site_description: "177 production-ready skills for Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Aider, Windsurf, Kilo Code, OpenCode, Augment, and Antigravity. Reusable expertise for engineering, product, marketing, compliance, and more." site_author: Alireza Rezvani repo_url: https://github.com/alirezarezvani/claude-skills repo_name: alirezarezvani/claude-skills @@ -115,6 +115,7 @@ markdown_extensions: nav: - Home: index.md - Getting Started: getting-started.md + - Multi-Tool Integrations: integrations.md - Skills: - Overview: skills/index.md - Engineering - Core: