141 lines
3.5 KiB
Markdown
141 lines
3.5 KiB
Markdown
# INSTALL
|
|
|
|
Install from this repo similarly to superpowers: clone once, then copy agent-specific skill variants.
|
|
|
|
## 1) Clone
|
|
|
|
```bash
|
|
git clone https://git.fiorinis.com/Home/ai-coding-skills.git
|
|
cd ai-coding-skills
|
|
```
|
|
|
|
---
|
|
|
|
## 2) Install prerequisite dependency for `create-plan` (Superpowers)
|
|
|
|
`create-plan` requires Superpowers planning skills:
|
|
- `brainstorming`
|
|
- `writing-plans`
|
|
|
|
Install Superpowers first (follow upstream instructions):
|
|
- https://github.com/obra/superpowers
|
|
|
|
### Verify Superpowers dependencies
|
|
|
|
Run in your agent's skills root and confirm these exist:
|
|
|
|
- `.../skills/brainstorming/SKILL.md`
|
|
- `.../skills/writing-plans/SKILL.md`
|
|
|
|
If missing, **stop** and return:
|
|
|
|
"Missing dependency: Superpowers planning skills are required (`brainstorming`, `writing-plans`). Install from https://github.com/obra/superpowers, then retry."
|
|
|
|
---
|
|
|
|
## 3) 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
|
|
|
|
```bash
|
|
mkdir -p ~/.opencode/skills/create-plan
|
|
cp -R skills/create-plan/opencode/* ~/.opencode/skills/create-plan/
|
|
```
|
|
|
|
### Verify `create-plan`
|
|
|
|
```bash
|
|
test -f ~/.codex/skills/create-plan/SKILL.md || true
|
|
test -f ~/.claude/skills/create-plan/SKILL.md || true
|
|
test -f ~/.opencode/skills/create-plan/SKILL.md || true
|
|
```
|
|
|
|
---
|
|
|
|
## 4) Install `web-automation`
|
|
|
|
### Requirements
|
|
|
|
- Node.js 20+
|
|
- pnpm
|
|
- Network access to download Camoufox browser artifacts
|
|
|
|
### 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
|
|
# explicit Playwright install/refresh
|
|
pnpm add playwright-core camoufox-js
|
|
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
|
|
# explicit Playwright install/refresh
|
|
pnpm add playwright-core camoufox-js
|
|
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
|
|
# explicit Playwright install/refresh
|
|
pnpm add playwright-core camoufox-js
|
|
npx camoufox-js fetch
|
|
```
|
|
|
|
### Verify `web-automation` dependencies
|
|
|
|
Run in the 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')"
|
|
```
|
|
|
|
If checks fail, **stop** and return:
|
|
|
|
"Missing dependency/config: web-automation requires `playwright-core` + `camoufox-js` and Camoufox-based scripts. Run setup in this skill, then retry."
|
|
|
|
---
|
|
|
|
## 5) Functional verification
|
|
|
|
- Ensure `SKILL.md` exists in each installed skill folder.
|
|
- Ensure `templates/` exists for `create-plan`.
|
|
- Ensure `scripts/` exists for `web-automation`.
|
|
- Validate trigger behavior:
|
|
- "create a plan for ..."
|
|
- "scrape this page ..."
|
|
|
|
## Notes
|
|
|
|
- `create-plan` writes plan artifacts under `ai_plan/`.
|
|
- `ai_plan/` should remain gitignored and local-only.
|