# ai-coding-skills

Cross-agent skill collection for **Codex**, **Claude Code**, and **OpenCode**.

This repo is organized similarly to `obra/superpowers` and is designed to scale to many skills over time.

## Goals

- Keep skills portable across coding agents.
- Keep each skill self-contained (`skills/<skill-name>/<agent-variant>/SKILL.md` + resources).

## Repository Layout

```text
ai-coding-skills/
├── README.md
├── docs/
│   ├── README.md
│   ├── CREATE-PLAN.md
│   └── WEB-AUTOMATION.md
├── skills/
│   ├── _template/
│   │   └── SKILL.md
│   ├── create-plan/
│   │   ├── codex/
│   │   ├── claude-code/
│   │   └── opencode/
│   └── web-automation/
│       ├── codex/
│       ├── claude-code/
│       └── opencode/
├── .codex/
├── .claude-plugin/
├── .opencode/
│   └── plugins/
├── commands/
├── hooks/
└── tests/
```

## Skills

| Skill | Agent Variant | Purpose | Status | Docs |
|---|---|---|---|---|
| create-plan | codex | Structured planning with milestones + runbook-first execution workflow | Ready | [CREATE-PLAN](docs/CREATE-PLAN.md) |
| create-plan | claude-code | Structured planning with milestones + runbook-first execution workflow | Ready | [CREATE-PLAN](docs/CREATE-PLAN.md) |
| create-plan | opencode | Structured planning with milestones + runbook-first execution workflow | Ready | [CREATE-PLAN](docs/CREATE-PLAN.md) |
| web-automation | codex | Playwright + Camoufox browsing/scraping/auth automation | Ready | [WEB-AUTOMATION](docs/WEB-AUTOMATION.md) |
| web-automation | claude-code | Playwright + Camoufox browsing/scraping/auth automation | Ready | [WEB-AUTOMATION](docs/WEB-AUTOMATION.md) |
| web-automation | opencode | Playwright + Camoufox browsing/scraping/auth automation | Ready | [WEB-AUTOMATION](docs/WEB-AUTOMATION.md) |

- Docs index: `docs/README.md`
- Create-plan guide: `docs/CREATE-PLAN.md`
- Web-automation guide: `docs/WEB-AUTOMATION.md`

## Compatibility Policy

Each skill should explicitly document agent compatibility and any prerequisites directly in its own `SKILL.md`.