ai-agent-skills

# Wednesday Agent Skills

AI skills for Wednesday Solutions projects — git discipline, PR automation, terminal dashboard, greenfield planning, and brownfield codebase intelligence with real-time chat, drift detection, and test generation.

---

## 1. Installation

### Requirements
- Node.js ≥ 18
- npm ≥ 8

**Option 1 — npx (no setup)**
```bash
npx @wednesday-solutions-eng/ai-agent-skills install
```

**Option 2 — global**
```bash
npm install -g @wednesday-solutions-eng/ai-agent-skills
wednesday-skills install
```

**Option 3 — shell (no npm)**
```bash
bash install.sh
```

Run in your project root. The installer:
1. Copies skills into `.wednesday/skills/`
2. Writes agent config files (`CLAUDE.md`, `CLAUDE.md`, `.cursorrules`, `.github/cursor-instructions.md`)
3. Installs git hooks (`post-commit`, `post-merge`) for automatic graph updates
4. Prompts for optional coverage and Sonar integration
5. Symlinks skills into `~/.cursor/skills/` for Claude Code discovery

---

## 2. Configuration & AI Tools

**No API key needed to use skills inside Claude Code, Cursor, or Cursor CLI.** 
When inside an AI IDE, the IDE acts as the intelligence engine — skills are standard instructions, not local scripts.

### Supported AI tools
| Tool | Configured via |
|------|---------------|
| Claude Code | `CLAUDE.md` |
| Cursor CLI | `CLAUDE.md` |
| Antigravity | `~/.cursor/antigravity/skills/` (run `wednesday-skills sync`) |
| Cursor | `.cursorrules` |
| GitHub Copilot | `.github/cursor-instructions.md` |

### Environment Variables
API keys are only required for standalone CLI workflows (`plan`, `summarize`, `gen-tests`). 
Run the interactive configuration wizard:

```bash
wednesday-skills config
```

Or manually add to `.env`:
- `OPENROUTER_API_KEY` or `ANTHROPIC_API_KEY`: Used by offline LLM-backed tools.
- `GITHUB_TOKEN`: Used by `wednesday-skills dashboard` to fetch PR data.

---

## 3. Every Skill Explained

### Core Workflow Skills
| Skill | What it does |
|---------|-------------|