# 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
├── .codex/
├── .claude-plugin/
├── .opencode/
│   └── plugins/
├── commands/
├── hooks/
└── tests/
```

## Skills

| Skill | Purpose | Status |
|---|---|---|
| _TBD_ | Waiting for your custom skill content | Planned |

## 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`.