ai-coding-skills/docs/INSTALL.md

INSTALL

Install from this repo similarly to superpowers: clone once, then copy agent-specific skill variants.

1) Clone

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

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

Claude Code

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

OpenCode

mkdir -p ~/.opencode/skills/create-plan
cp -R skills/create-plan/opencode/* ~/.opencode/skills/create-plan/

Verify create-plan

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

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

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

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:

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.