Stefano Fiorini
77 lines
2.8 KiB
Markdown
77 lines
2.8 KiB
Markdown
# 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
|
|
```
|