Files

T

Stefano Fiorini 9853d4937b docs(do-task): add DO-TASK.md + README updates (M6)

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>

2026-04-22 14:40:49 -05:00

5.1 KiB

Raw Blame History

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.