# ai-coding-skills

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

Pi package support is also included for the pi-native variants in this repo.

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
│   ├── ATLASSIAN.md
│   ├── CREATE-PLAN.md
│   ├── DO-TASK.md
│   ├── IMPLEMENT-PLAN.md
│   ├── PI.md
│   ├── PI-RESEARCH.md
│   ├── PI-SUPERPOWERS.md
│   ├── TELEGRAM-NOTIFICATIONS.md
│   └── WEB-AUTOMATION.md
├── skills/
│   ├── _template/
│   │   └── SKILL.md
│   ├── atlassian/
│   │   ├── codex/
│   │   ├── claude-code/
│   │   ├── cursor/
│   │   ├── opencode/
│   │   ├── pi/
│   │   └── shared/
│   ├── create-plan/
│   │   ├── codex/
│   │   ├── claude-code/
│   │   ├── opencode/
│   │   ├── cursor/
│   │   └── pi/
│   ├── do-task/
│   │   ├── codex/
│   │   ├── claude-code/
│   │   ├── opencode/
│   │   ├── cursor/
│   │   └── pi/
│   ├── implement-plan/
│   │   ├── codex/
│   │   ├── claude-code/
│   │   ├── opencode/
│   │   ├── cursor/
│   │   └── pi/
│   ├── reviewer-runtime/
│   │   ├── pi/
│   │   └── tests/
│   └── web-automation/
│       ├── codex/
│       ├── claude-code/
│       ├── opencode/
│       └── pi/
├── .codex/
├── .claude-plugin/
├── .opencode/
│   └── plugins/
├── commands/
├── hooks/
└── tests/
```

## Skills

| Skill | Agent Variant | Purpose | Status | Docs |
|---|---|---|---|---|
| atlassian | codex | Portable Jira and Confluence workflows through a shared Cloud-first CLI | Ready | [ATLASSIAN](docs/ATLASSIAN.md) |
| atlassian | claude-code | Portable Jira and Confluence workflows through a shared Cloud-first CLI | Ready | [ATLASSIAN](docs/ATLASSIAN.md) |
| atlassian | opencode | Portable Jira and Confluence workflows through a shared Cloud-first CLI | Ready | [ATLASSIAN](docs/ATLASSIAN.md) |
| atlassian | cursor | Portable Jira and Confluence workflows through a shared Cloud-first CLI | Ready | [ATLASSIAN](docs/ATLASSIAN.md) |
| atlassian | pi | Portable Jira and Confluence workflows through a shared Cloud-first CLI | Ready | [ATLASSIAN](docs/ATLASSIAN.md) |
| create-plan | codex | Structured planning with milestones, iterative cross-model review, and runbook-first execution workflow | Ready | [CREATE-PLAN](docs/CREATE-PLAN.md) |
| create-plan | claude-code | Structured planning with milestones, iterative cross-model review, and runbook-first execution workflow | Ready | [CREATE-PLAN](docs/CREATE-PLAN.md) |
| create-plan | opencode | Structured planning with milestones, iterative cross-model review, and runbook-first execution workflow | Ready | [CREATE-PLAN](docs/CREATE-PLAN.md) |
| create-plan | cursor | Structured planning with milestones, iterative cross-model review, and runbook-first execution workflow | Ready | [CREATE-PLAN](docs/CREATE-PLAN.md) |
| create-plan | pi | Structured planning with milestones, iterative cross-model review, and runbook-first execution workflow | Ready | [CREATE-PLAN](docs/CREATE-PLAN.md) |
| do-task | codex | Single-prompt end-to-end execution with dual reviewer loops (plan + implementation), TDD-first, single task commit | Ready | [DO-TASK](docs/DO-TASK.md) |
| do-task | claude-code | Single-prompt end-to-end execution with dual reviewer loops (plan + implementation), TDD-first, single task commit | Ready | [DO-TASK](docs/DO-TASK.md) |
| do-task | opencode | Single-prompt end-to-end execution with dual reviewer loops (plan + implementation), TDD-first, single task commit | Ready | [DO-TASK](docs/DO-TASK.md) |
| do-task | cursor | Single-prompt end-to-end execution with dual reviewer loops (plan + implementation), TDD-first, single task commit | Ready | [DO-TASK](docs/DO-TASK.md) |
| do-task | pi | Single-prompt end-to-end execution with dual reviewer loops (plan + implementation), TDD-first, single task commit | Ready | [DO-TASK](docs/DO-TASK.md) |
| implement-plan | codex | Worktree-isolated plan execution with iterative cross-model milestone review | Ready | [IMPLEMENT-PLAN](docs/IMPLEMENT-PLAN.md) |
| implement-plan | claude-code | Worktree-isolated plan execution with iterative cross-model milestone review | Ready | [IMPLEMENT-PLAN](docs/IMPLEMENT-PLAN.md) |
| implement-plan | opencode | Worktree-isolated plan execution with iterative cross-model milestone review | Ready | [IMPLEMENT-PLAN](docs/IMPLEMENT-PLAN.md) |
| implement-plan | cursor | Worktree-isolated plan execution with iterative cross-model milestone review | Ready | [IMPLEMENT-PLAN](docs/IMPLEMENT-PLAN.md) |
| implement-plan | pi | Worktree-isolated plan execution with iterative cross-model milestone review | Ready | [IMPLEMENT-PLAN](docs/IMPLEMENT-PLAN.md) |
| web-automation | codex | CloakBrowser-backed browsing, scraping, auth, flow automation, and install validation | Ready | [WEB-AUTOMATION](docs/WEB-AUTOMATION.md) |
| web-automation | claude-code | CloakBrowser-backed browsing, scraping, auth, flow automation, and install validation | Ready | [WEB-AUTOMATION](docs/WEB-AUTOMATION.md) |
| web-automation | opencode | CloakBrowser-backed browsing, scraping, auth, flow automation, and install validation | Ready | [WEB-AUTOMATION](docs/WEB-AUTOMATION.md) |
| web-automation | pi | CloakBrowser-backed browsing, scraping, auth, flow automation, and install validation | Ready | [WEB-AUTOMATION](docs/WEB-AUTOMATION.md) |

- Docs index: `docs/README.md`
- Atlassian guide: `docs/ATLASSIAN.md`
- Create-plan guide: `docs/CREATE-PLAN.md`
- Do-task guide: `docs/DO-TASK.md`
- Implement-plan guide: `docs/IMPLEMENT-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`.

## Pi Package

The repo root now includes a pi package manifest that ships only the pi-specific surface:

- `pi-package/skills/*/` for the five packaged Pi skills
- `skills/reviewer-runtime/pi/`
- `docs/PI*.md`
- `scripts/sync-pi-package-skills.sh`
- `scripts/verify-pi-resources.sh`

Install it into project-local pi settings from this checkout with:

```bash
pi install -l "$(pwd)"
pi list
```

Before publishing or sharing a tarball, run:

```bash
./scripts/sync-pi-package-skills.sh
./scripts/verify-pi-resources.sh
npm pack --dry-run --json
```

Additional pi-specific guidance lives in [docs/PI.md](docs/PI.md).