pakuskills

Interactive installer for the skills shipped in this repo. Pick a destination and some skills, and they land as standard SKILL.md folders your agent tools can load.

Quick start

npx pakuskills

Requires Node.js 20+ and an interactive terminal.

What it does

1. Lists the skill folders published in SKILLS/ of this repo
2. Asks where you want them installed
3. Lets you multiselect the skills
4. Downloads each one with degit (no git history, no full clone)

◇ Destino: .opencode/skills
◇ Instalando lcp-optimization...
✓ Skill 'lcp-optimization' instalada en .opencode/skills/lcp-optimization

Install targets

| Target | Path | Loaded by | |--------|------|-----------| | opencode (project) | .opencode/skills/ | opencode in this repo | | opencode (global) | ~/.config/opencode/skills/ | opencode, all projects | | Generic Agent Skills (project) | .agents/skills/ | VS Code, Copilot, Codex, opencode | | Generic Agent Skills (global) | ~/.agents/skills/ | same, all projects | | Claude Code (project) | .claude/skills/ | Claude Code in this repo | | Claude Code (personal) | ~/.claude/skills/ | Claude Code, all projects |

The default is .opencode/skills/. The three target families follow the Agent Skills open standard — the same SKILL.md folder works across tools.

Environment variables

| Variable | Effect | |----------|--------| | PAKU_SKILLS_TARGET | Skips the destination prompt. One of opencode, opencode-global, generic, generic-global, claude, claude-global. | | GITHUB_TOKEN | Optional. Raises the GitHub API rate limit from 60 to 5000 requests/hour. | | DEBUG | Optional. Prints the full stack trace on unexpected errors. |

# Example: install into ~/.agents/skills without the prompt
PAKU_SKILLS_TARGET=generic-global npx pakuskills

How to add a skill to the catalog

Skills live in the SKILLS/ folder of this repo, one folder per skill. The installer only lists directories inside SKILLS/, so keep skill folders flat and free of dot-prefixed names.

Each folder needs a SKILL.md whose frontmatter name matches the folder name, or VS Code and opencode silently skip it:

---
name: my-skill
description: What this skill does and when to use it.
---

## Instructions
...

Development

pnpm install
pnpm check   # syntax check
pnpm start   # run locally (needs an interactive terminal)

| | | |---|---| | Runtime | ESM only, no build step, single file cli.js | | Package manager | pnpm | | License | MIT |

Troubleshooting

| Symptom | Cause | |---------|-------| | ✕ Este instalador necesita una terminal interactiva | You ran it in a pipeline or CI script. Use an interactive shell, or set PAKU_SKILLS_TARGET and run from a real terminal. | | rate limit de GitHub | Unauthenticated API is capped at 60 requests/hour. Export GITHUB_TOKEN. | | PAKU_SKILLS_TARGET inválido | The value does not match any target. Valid values: opencode, opencode-global, generic, generic-global, claude, claude-global. | | GitHub respondió 404 | The SKILLS/ folder was renamed or moved. Update SKILLS_PATH in cli.js. | | Skill installed but not showing up | The frontmatter name does not match the folder name, or the file is not named SKILL.md. | | Skill already exists prompt | The installer asks before overwriting. No skips that skill. |

License

MIT © pa-ku