Stefano Fiorini
9853d4937b
docs/DO-TASK.md covers: - Purpose, Requirements (variant-specific prereqs + dependency- missing messages per variant), Reviewer CLI Requirements table (4 CLIs including opencode with fresh-call default). - Install (4 subsections: Codex, Claude Code, OpenCode, Cursor). - Per-variant Verify Installation subsections checking CLI binary, SKILL.md, run-review.sh, notify-telegram.sh, Superpowers sub-skills, and variant extras (Codex symlink, Cursor jq, OpenCode Superpowers ls, Cursor repo-vs-global lookup). - Key Behavior, Dual Review Loops, Subroutine Steps, Reviewer Output Contract, Runtime Artifacts, Persistent Artifact Status enum (10 values), Failure Handling. - Secret Scan (subroutine step 1a; per-payload; no caching) with canonical 10-pattern regex list and redaction contract. - Supported Reviewer CLIs table (4 rows, including opencode). - Notifications, Template Guardrails (14 core sections + Runtime State keys), Variant Hardening Notes (4 subsections), Execution Workflow Rules. docs/README.md adds DO-TASK.md entry. README.md: - Skills table adds 4 do-task rows (codex, claude-code, opencode, cursor). - Docs links add "Do-task guide" entry. - Repository Layout adds do-task/ subdirectory. Reviewer: codex / gpt-5.4. Approved round 2: - Round 1: 2 P2 (prereqs inaccurate, Verify Installation incomplete) + 1 P3 -> REVISE. - Round 2: 0 P0/P1/P2/P3 -> APPROVED. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
ai-coding-skills
Cross-agent skill collection for Codex, Claude Code, OpenCode, and Cursor.
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
ai-coding-skills/
├── README.md
├── docs/
│ ├── README.md
│ ├── ATLASSIAN.md
│ ├── CREATE-PLAN.md
│ ├── IMPLEMENT-PLAN.md
│ └── WEB-AUTOMATION.md
├── skills/
│ ├── _template/
│ │ └── SKILL.md
│ ├── atlassian/
│ │ ├── codex/
│ │ ├── claude-code/
│ │ ├── cursor/
│ │ ├── opencode/
│ │ └── shared/
│ ├── create-plan/
│ │ ├── codex/
│ │ ├── claude-code/
│ │ ├── opencode/
│ │ └── cursor/
│ ├── do-task/
│ │ ├── codex/
│ │ ├── claude-code/
│ │ ├── opencode/
│ │ └── cursor/
│ ├── implement-plan/
│ │ ├── codex/
│ │ ├── claude-code/
│ │ ├── opencode/
│ │ └── cursor/
│ └── web-automation/
│ ├── codex/
│ ├── claude-code/
│ └── opencode/
├── .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 |
| atlassian | claude-code | Portable Jira and Confluence workflows through a shared Cloud-first CLI | Ready | ATLASSIAN |
| atlassian | opencode | Portable Jira and Confluence workflows through a shared Cloud-first CLI | Ready | ATLASSIAN |
| atlassian | cursor | Portable Jira and Confluence workflows through a shared Cloud-first CLI | Ready | ATLASSIAN |
| create-plan | codex | Structured planning with milestones, iterative cross-model review, and runbook-first execution workflow | Ready | CREATE-PLAN |
| create-plan | claude-code | Structured planning with milestones, iterative cross-model review, and runbook-first execution workflow | Ready | CREATE-PLAN |
| create-plan | opencode | Structured planning with milestones, iterative cross-model review, and runbook-first execution workflow | Ready | CREATE-PLAN |
| create-plan | cursor | Structured planning with milestones, iterative cross-model review, and runbook-first execution workflow | Ready | CREATE-PLAN |
| do-task | codex | Single-prompt end-to-end execution with dual reviewer loops (plan + implementation), TDD-first, single task commit | Ready | DO-TASK |
| do-task | claude-code | Single-prompt end-to-end execution with dual reviewer loops (plan + implementation), TDD-first, single task commit | Ready | DO-TASK |
| do-task | opencode | Single-prompt end-to-end execution with dual reviewer loops (plan + implementation), TDD-first, single task commit | Ready | DO-TASK |
| do-task | cursor | Single-prompt end-to-end execution with dual reviewer loops (plan + implementation), TDD-first, single task commit | Ready | DO-TASK |
| implement-plan | codex | Worktree-isolated plan execution with iterative cross-model milestone review | Ready | IMPLEMENT-PLAN |
| implement-plan | claude-code | Worktree-isolated plan execution with iterative cross-model milestone review | Ready | IMPLEMENT-PLAN |
| implement-plan | opencode | Worktree-isolated plan execution with iterative cross-model milestone review | Ready | IMPLEMENT-PLAN |
| implement-plan | cursor | Worktree-isolated plan execution with iterative cross-model milestone review | Ready | IMPLEMENT-PLAN |
| web-automation | codex | CloakBrowser-backed browsing, scraping, auth, flow automation, and install validation | Ready | WEB-AUTOMATION |
| web-automation | claude-code | CloakBrowser-backed browsing, scraping, auth, flow automation, and install validation | Ready | WEB-AUTOMATION |
| web-automation | opencode | CloakBrowser-backed browsing, scraping, auth, flow automation, and install validation | Ready | WEB-AUTOMATION |
- 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.