# dev-setup-skills

OpenCode agent skills for development environment setup — compatible with **50+** AI coding agents.

One skill, all agents. Install once, works everywhere.

## Supported Agents

Claude Code, OpenCode, Codex, Cursor, Windsurf, Gemini CLI, GitHub Copilot, Cline, Roo Code, AiderDesk, Antigravity, Augment, IBM Bob, CodeBuddy, Continue, Devin, Goose, Kilo Code, Kiro CLI, Kode, OpenHands, Pi, Qoder, Qwen Code, Trae, Zencoder, and more.

## Install

```bash
npm install dev-setup-skills
```

On install, skills are automatically deployed to all detected AI agents in your project. You can also use the CLI:

```bash
npx dev-setup-skills init
```

## Available Skills

| Skill | Description |
|-------|-------------|
| `shell-completion` | Install and configure shell auto-completion for common CLI tools on macOS (zsh/bash) |
| `npm-publish` | Publish a Node.js package to npm/npx — setup, login, versioning, and troubleshooting |
| `ssh-setup` | Generate SSH keys and configure passwordless auth for GitHub, GitLab, and more |
| `git-setup` | Configure git identity, GPG signing, aliases, and multi-account support |
| `github-cli` | Install and use GitHub CLI (gh) — repos, PRs, issues, releases, actions |
| `cocoapods-setup` | Install and configure CocoaPods for iOS/macOS dependency management |

## Usage

### Auto-detect and install

```bash
npx dev-setup-skills init
```

This detects which AI coding agents you use and installs skills to all of them.

### Target specific agents

```bash
npx dev-setup-skills init -a claude-code -a cursor
```

### Global install (available across all projects)

```bash
npx dev-setup-skills init -g
```

### Install all skills to all agents

```bash
npx dev-setup-skills init --all
```

### Install a specific skill

```bash
npx dev-setup-skills install shell-completion -a opencode
```

### Use symlink mode

```bash
npx dev-setup-skills init --symlink
```

One canonical copy, symlinked to each agent. Update once, all agents get the change.

### List available skills

```bash
npx dev-setup-skills list
```

### Check agent status

```bash
npx dev-setup-skills status
```

## How It Works

Each AI coding agent has its own skills directory:

```
Agent         → Project path            → Global path
─────────────────────────────────────────────────────────
Claude Code   → .claude/skills/         → ~/.claude/skills/
OpenCode      → .opencode/skills/       → ~/.config/opencode/skills/
Cursor        → .agents/skills/         → ~/.cursor/skills/
Codex         → .agents/skills/         → ~/.codex/skills/
Windsurf      → .windsurf/skills/       → ~/.codeium/windsurf/skills/
...
```

All agents read the same `SKILL.md` format (YAML frontmatter + markdown), only the directory differs. This CLI handles the placement for you.

## Add Your Own Skills

Create `skills/<name>/SKILL.md`:

```markdown
---
name: my-skill
description: What this skill does and when to use it
license: MIT
compatibility: opencode
---

## What I do

Instructions for the agent...
```

## License

MIT