62 lines
1.8 KiB
Markdown
62 lines
1.8 KiB
Markdown
# ai-coding-skills
|
|
|
|
Cross-agent skill collection for **Codex**, **Claude Code**, and **OpenCode**.
|
|
|
|
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>/SKILL.md` + optional resources).
|
|
- Enforce requirement checks for skills that depend on Superpower skills.
|
|
|
|
## Repository Layout
|
|
|
|
```text
|
|
ai-coding-skills/
|
|
├── README.md
|
|
├── docs/
|
|
│ ├── repository-structure.md
|
|
│ └── requirements-gate.md
|
|
├── skills/
|
|
│ ├── _template/
|
|
│ │ └── SKILL.md
|
|
│ └── create-plan/
|
|
│ ├── codex/
|
|
│ ├── claude-code/
|
|
│ └── opencode/
|
|
├── .codex/
|
|
├── .claude-plugin/
|
|
├── .opencode/
|
|
│ └── plugins/
|
|
├── commands/
|
|
├── hooks/
|
|
└── tests/
|
|
```
|
|
|
|
## Skills
|
|
|
|
| Skill | Agent Variant | Purpose | Status |
|
|
|---|---|---|---|
|
|
| create-plan | codex | Structured planning with milestones + runbook-first execution workflow | Ready |
|
|
| create-plan | claude-code | Structured planning with milestones + runbook-first execution workflow | Ready |
|
|
| create-plan | opencode | Structured planning with milestones + runbook-first execution workflow | Ready |
|
|
|
|
See install instructions: `docs/install.md`
|
|
|
|
## Requirement Gate (Superpowers dependency)
|
|
|
|
If a skill depends on Superpower skills (`https://github.com/obra/superpowers`), it must include an explicit prerequisite block in `SKILL.md` and fail fast with clear instructions when requirements are missing.
|
|
|
|
See: `docs/requirements-gate.md`
|
|
|
|
## Compatibility Policy
|
|
|
|
Each skill added to this repo should specify support status for:
|
|
|
|
- Codex
|
|
- Claude Code
|
|
- OpenCode
|
|
|
|
Use the template at `skills/_template/SKILL.md`.
|