# Repository Structure

This repository follows a superpowers-style organization for long-term maintainability.

## Top-level directories

- `skills/` → All installable skills.
- `docs/` → Repository-level guidance.
- `.codex/` → Codex-specific integration/config notes.
- `.claude-plugin/` → Claude Code plugin metadata/integration notes.
- `.opencode/plugins/` → OpenCode plugin metadata/integration notes.
- `commands/` → Optional command wrappers.
- `hooks/` → Optional pre/post hooks.
- `tests/` → Regression tests for triggering/behavior.

## Skill Folder Contract

Each skill folder should contain at minimum:

- `SKILL.md` (required)

Optional:

- `scripts/` (deterministic execution)
- `references/` (detailed docs)
- `assets/` (templates/resources)

## Naming

- lowercase + hyphen only
- one skill per folder