# Installation

Install from this repo similarly to superpowers: clone once, then copy/symlink agent-specific skills.

## 1) Clone

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

## 2) Install `create-plan`

### Codex

```bash
mkdir -p ~/.codex/skills/create-plan
cp -R skills/create-plan/codex/* ~/.codex/skills/create-plan/
```

### Claude Code

```bash
mkdir -p ~/.claude/skills/create-plan
cp -R skills/create-plan/claude-code/* ~/.claude/skills/create-plan/
```

### OpenCode

Use your OpenCode skills/plugin path and copy the opencode variant.

```bash
# Example path (adjust for your environment)
mkdir -p ~/.opencode/skills/create-plan
cp -R skills/create-plan/opencode/* ~/.opencode/skills/create-plan/
```

## 3) Install `web-automation`

### Codex

```bash
mkdir -p ~/.codex/skills/web-automation
cp -R skills/web-automation/codex/* ~/.codex/skills/web-automation/
cd ~/.codex/skills/web-automation/scripts
pnpm install
npx camoufox-js fetch
```

### Claude Code

```bash
mkdir -p ~/.claude/skills/web-automation
cp -R skills/web-automation/claude-code/* ~/.claude/skills/web-automation/
cd ~/.claude/skills/web-automation/scripts
pnpm install
npx camoufox-js fetch
```

### OpenCode

```bash
mkdir -p ~/.opencode/skills/web-automation
cp -R skills/web-automation/opencode/* ~/.opencode/skills/web-automation/
cd ~/.opencode/skills/web-automation/scripts
pnpm install
npx camoufox-js fetch
```

Requirements for `web-automation`:
- Node.js 20+
- pnpm
- Browser download/network access for Camoufox
- `playwright-core` and `camoufox-js` installed in the skill scripts workspace

Dependency verification (run in your installed `scripts/` folder):

```bash
node -e "require.resolve('playwright-core/package.json');require.resolve('camoufox-js/package.json');console.log('OK: playwright-core + camoufox-js installed')"
node -e "const fs=require('fs');const t=fs.readFileSync('browse.ts','utf8');if(!/camoufox-js/.test(t)){throw new Error('browse.ts is not configured for Camoufox')}console.log('OK: Camoufox integration detected in browse.ts')"
```

## 4) Verify

- Ensure `SKILL.md` exists in the destination folder.
- Ensure `templates/` files (create-plan) or `scripts/` files (web-automation) are present.
- Start a new agent session and ask:
  - "create a plan for ..." (create-plan)
  - "scrape this page ..." (web-automation)

## Notes

- `docs/plans` / `docs/plan` can be gitignored by design.
- Plan artifacts are intentionally local.