Stefano Fiorini
141 lines
6.9 KiB
Markdown
141 lines
6.9 KiB
Markdown
# 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).
|