# Skills Documentation

This directory contains user-facing docs for all skills, agents, and tooling
in the `ai-coding-skills` repository.

## Reading Order

Work through the sections below in order on a first read. Return to individual
sections as needed.

### 1. Getting Started

- [INSTALLER.md](./INSTALLER.md) — Guided install/update/remove wizard
  (`./scripts/manage-skills.sh`). **Start here** if you want the fastest path
  to installed skills.

### 2. Per-Agent Manual Install

Use these guides to install specific skills manually for a single agent:

- [CODEX.md](./CODEX.md) — Manual install for Codex variants.
- [CLAUDE-CODE.md](./CLAUDE-CODE.md) — Manual install for Claude Code variants.
- [CURSOR.md](./CURSOR.md) — Manual install for Cursor variants.
- [OPENCODE.md](./OPENCODE.md) — Manual install for OpenCode variants.
- [PI.md](./PI.md) — Pi overview, source-vs-package layout, and manual install.

### 3. Skill Guides

Reference docs for each skill family:

- [ATLASSIAN.md](./ATLASSIAN.md) — Jira/Confluence CLI: requirements, generated
  bundle sync, install, auth, safety rules, and usage examples.
- [CREATE-PLAN.md](./CREATE-PLAN.md) — Structured planning with milestones,
  cross-model review, and reviewer CLI requirements.
- [DO-TASK.md](./DO-TASK.md) — Single-prompt end-to-end execution with dual
  reviewer loops, TDD-first, single task commit.
- [IMPLEMENT-PLAN.md](./IMPLEMENT-PLAN.md) — Worktree-isolated plan execution
  with iterative cross-model milestone review.
- [WEB-AUTOMATION.md](./WEB-AUTOMATION.md) — CloakBrowser-backed browsing,
  scraping, auth, and flow automation.

### 4. Pi-Specific Docs

- [PI-RESEARCH.md](./PI-RESEARCH.md) — Source-backed Pi findings that inform
  repo Pi variants and packaging choices.
- [PI-SUPERPOWERS.md](./PI-SUPERPOWERS.md) — How to install or verify Obra
  Superpowers for Pi.
- [PI-COMMON-REVIEWER.md](./PI-COMMON-REVIEWER.md) — Shared reviewer-runtime
  helpers for Pi workflow skills; canonical Pi reviewer flag contract.

### 5. Telegram Notifications

- [TELEGRAM-NOTIFICATIONS.md](./TELEGRAM-NOTIFICATIONS.md) — Shared Telegram
  notification setup for Codex, Claude Code, OpenCode, Cursor, and Pi.

### 6. Reviewer Matrix

- [REVIEWERS.md](./REVIEWERS.md) — Canonical reviewer CLI support matrix;
  single source of truth for all workflow variants.

### 7. Development

- [DEVELOPMENT.md](./DEVELOPMENT.md) — Prerequisites, `pnpm run check`,
  workspace policy, cross-platform shell support, and the transitional quality
  contract.
- [CLEANUP-BASELINE.md](./CLEANUP-BASELINE.md) — As-is quality baseline
  captured at M1, updated through subsequent milestones.

## Repo Setup

Clone the repo first:

```bash
git clone https://git.fiorinis.com/Home/ai-coding-skills.git
cd ai-coding-skills
```