chore: scaffold ai-coding-skills repository structure

README.md

@@ -0,0 +1,53 @@
+# 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`.