ai-agents-skills

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="assets/logo-wordmark-dark.svg">
  <img src="assets/logo-wordmark.svg" alt="Agents Skills" width="200">
</picture>

**v1.6.3** - A modular CLI for distributing reusable AI agent skills across multiple coding assistants.

Install 68 curated skills for React, TypeScript, testing, architecture, and more — to 11 AI agents across two tiers. Features project presets, interactive setup, dependency resolution, version tracking, and seamless multi-model sync.

Browse the full skill catalog at **[joabgonzalez.github.io/ai-agents-skills](https://joabgonzalez.github.io/ai-agents-skills/)**

## Quick Start

```bash
# Interactive mode (recommended)
npx ai-agents-skills add

# Install a preset
npx ai-agents-skills add --preset astro-template

# Install specific skills
npx ai-agents-skills add --skill react --skill typescript
```

## Supported Models

11 agents across two tiers. Install once — all agents stay in sync automatically.

**Universal** — read from `.agents/skills/` natively, no extra setup:

Amp · Cline · Codex · Gemini · Gemini CLI · GitHub Copilot · Kimi Code CLI · OpenCode

**Dedicated** — also get a symlink in their own directory:

| Model       | Directory        | `--model` ID  |
| ----------- | ---------------- | ------------- |
| Claude Code | `.gemini/skills/`| `gemini`      |
| Antigravity | `.agent/skills/` | `antigravity` |
| OpenClaw    | `skills/`        | `openclaw`    |

## Commands

### `add` — Install skills

```bash
# Interactive (prompts for skills, models, and presets)
npx ai-agents-skills add

# Install a preset
npx ai-agents-skills add --preset astro-template

# Target specific models
npx ai-agents-skills add --model gemini --model gemini

# Install specific skills
npx ai-agents-skills add --skill react --skill typescript

# Preview without changes — shows exact paths that would be created
npx ai-agents-skills add --skill react --dry-run
```

**Options:**

| Flag                 | Des