Stefano Fiorini
c98f27f461
M7 final — adds CLI version checks (claude --version, codex --version) to the claude-code and codex Prerequisite Check sections so docs and skill requirements agree. This addresses the only P3 finding from the M7 review (non-blocking docs-to-skill mismatch). All 7 milestones delivered across 6 local commits: -437b202M1+M2: claude-code canonical + M1 canonical specs -d69da3aM3: codex variant -f404792M4: cursor variant -f5161f5M5: opencode variant -9853d49M6: docs/DO-TASK.md + README updates - this commit (M7): final gate + P3 fix do-task ships four runtime variants (claude-code, codex, cursor, opencode) that execute a single user-supplied prompt end-to-end with: - Plan review loop and implementation review loop, each against a reviewer CLI (codex, claude, cursor, or opencode) with up to MAX_ROUNDS=10 revisions until APPROVED. - Parameterized shared Review Loop subroutine (9 steps) invoked twice per run with loop-distinct session IDs so reviewer context never leaks across loops. - Per-payload secret scan (10 anchored regexes; no caching) with redacted-only user surfacing (`[REDACTED:<label>:<n>-chars]`). - TDD-first execution via superpowers:test-driven-development with strict auto-skip limited to pure-documentation and pure-comment-whitespace-rename. - Verification gate (lint/typecheck/tests) before the implementation review loop. - Single task commit after implementation APPROVED; explicit "yes" required to push. - Telegram notification on every terminal outcome. - Persistent ai_plan/YYYY-MM-DD-<slug>/task-plan.md with 10-value Status enum and resume semantics. Reviewer: codex / gpt-5.4. Total review rounds across the 7 milestones: 3+1+1+1+2+1 = 9. M7 smoke checks (all passing): - YAML frontmatter: 4/4 parse. - Core-section schema: 4/4 identical (14 sections, 10 Status enum values, 15 Runtime State keys). - docs/DO-TASK.md links resolve. - 4 variant Phase 1-10 dry-runs coherent; subroutine invoked from Phases 5 and 8 with distinct SESSION_ID_VAR per loop. - Opencode reviewer branch passes `bash -n` on rendered Round-1, Round-N (fresh-call), and Round-N (resume) templates. - Resume-state walk through Phase 4 reads all 6 session-id keys correctly. - Trigger audit: "implement this" only as exclusion; dropped phrases only under "Dropped defaults". 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.