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 — 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 — Manual install for Codex variants.
- CLAUDE-CODE.md — Manual install for Claude Code variants.
- CURSOR.md — Manual install for Cursor variants.
- OPENCODE.md — Manual install for OpenCode variants.
- PI.md — Pi overview, source-vs-package layout, and manual install.
3. Skill Guides
Reference docs for each skill family:
- ATLASSIAN.md — Jira/Confluence CLI: requirements, generated bundle sync, install, auth, safety rules, and usage examples.
- CREATE-PLAN.md — Structured planning with milestones, cross-model review, and reviewer CLI requirements.
- DO-TASK.md — Single-prompt end-to-end execution with dual reviewer loops, TDD-first, single task commit.
- IMPLEMENT-PLAN.md — Worktree-isolated plan execution with iterative cross-model milestone review.
- WEB-AUTOMATION.md — CloakBrowser-backed browsing, scraping, auth, and flow automation.
4. Pi-Specific Docs
- PI-RESEARCH.md — Source-backed Pi findings that inform repo Pi variants and packaging choices.
- PI-SUPERPOWERS.md — How to install or verify Obra Superpowers for Pi.
- PI-COMMON-REVIEWER.md — Shared reviewer-runtime helpers for Pi workflow skills; canonical Pi reviewer flag contract.
5. Telegram Notifications
- TELEGRAM-NOTIFICATIONS.md — Shared Telegram notification setup for Codex, Claude Code, OpenCode, Cursor, and Pi.
6. Reviewer Matrix
- REVIEWERS.md — Canonical reviewer CLI support matrix; single source of truth for all workflow variants.
7. Development
- DEVELOPMENT.md — Prerequisites,
pnpm run check, workspace policy, cross-platform shell support, and the transitional quality contract. - CLEANUP-BASELINE.md — As-is quality baseline captured at M1, updated through subsequent milestones.
Repo Setup
Clone the repo first:
git clone https://git.fiorinis.com/Home/ai-coding-skills.git
cd ai-coding-skills