@rovergon/agent-skills

Cross-platform installer for the private agent skill pack in rovergon69/agents. Version 0.9.0 requires Node.js 20 or newer as its only local prerequisite.

Install or update

npx -y @rovergon/agent-skills@latest
npx -y @rovergon/agent-skills@latest cursor
npx -y @rovergon/agent-skills@latest opencode
npx -y @rovergon/agent-skills@latest --all-packs opencode
npx -y @rovergon/agent-skills@latest --pack default --pack pstack cursor
npx -y @rovergon/agent-skills@latest install --target opencode
npx -y @rovergon/agent-skills@latest install --target codex
npx -y @rovergon/agent-skills@latest --pack default cursor
npx -y @rovergon/agent-skills@latest --no-agents --pack default cursor
npx -y @rovergon/agent-skills@latest --pack pstack-light opencode
npx -y @rovergon/agent-skills@latest --pack pstack cursor
npx -y @rovergon/agent-skills@latest install --target cursor --pack pstack
npx -y @rovergon/agent-skills@latest doctor --pack pstack cursor
npx -y @rovergon/agent-skills@latest prune --pack pstack --target cursor
npx -y @rovergon/agent-skills@latest uninstall --pack pstack --target opencode
npx -y @rovergon/agent-skills@latest uninstall --pack pstack --target opencode --purge
npx -y @rovergon/agent-skills@latest uninstall --all
npx -y @rovergon/agent-skills@latest uninstall all --purge

Running without a command performs installation. install remains available as an alias. Choose codex, cursor, opencode, or agents as a positional argument or with --target. Choose packs with --pack or -p (repeatable), --all-packs, or a pack id as a positional argument after the target (install cursor pstack). In an interactive terminal the CLI asks for the target if that is omitted. If --pack and --all-packs are omitted in a TTY, install then asks which packs to install (default (skills generales), pstack-light, pstack): arrows move, space toggles, Enter confirms. Confirming with none selected installs nothing and exits 0. For each selected pack it lists that pack's skills, all checked; unchecked skills are left untouched. --pack X skips the pack picker and only shows that pack's skill picker. Multiple --pack flags install those packs, with a skill picker per pack. --all-packs installs every pack (skill pickers in a TTY; full packs without a TTY). Without a TTY, omitting --pack is an error; pass --pack <id> (repeatable) or --all-packs. doctor, prune, and uninstall require one --pack <id>, except uninstall --all (or uninstall all), which needs neither a pack nor a target.

Packs:

• default (aliases: general) reads skills/
• pstack-light reads packs/pstack-light/
• pstack reads packs/pstack/

Install also copies the repository's AGENTS.md into the target home (~/.codex/AGENTS.md, ~/.cursor/AGENTS.md, or ~/.config/opencode/AGENTS.md). In a TTY install asks first whether to install or update it, or only the skills; without a TTY it does so unless --no-agents is passed, which installs or updates skills only. An existing AGENTS.md is backed up under the software home before it is replaced.

The command installs immediate directories from the selected packs that contain SKILL.md, including their references, scripts, assets, and metadata. The skill picker lists one pack at a time, so general, pstack-light, and pstack skills do not appear together. It leaves identical skills untouched, backs up and replaces only different selected skills, and reports installed, updated, and unchanged totals per pack.

The repository is private. Authentication is resolved in this order:

• GH_TOKEN;
• GITHUB_TOKEN;
• gh auth token;
• the integrated GitHub Device Flow.

On first use without existing credentials, the installer opens GitHub, asks you to approve access, and continues after approval. The GitHub App is limited to read-only Contents and Metadata access on rovergon69/agents. The CLI never stores or prints tokens.

GitHub's API ZIP download is the primary source path. A shallow Git download is an optional fallback, so Git is not a prerequisite.

Commands

npx -y @rovergon/agent-skills@latest doctor --pack default cursor
npx -y @rovergon/agent-skills@latest doctor --pack default opencode
npx -y @rovergon/agent-skills@latest prune --pack default --target codex
npx -y @rovergon/agent-skills@latest prune --pack default --target opencode
npx -y @rovergon/agent-skills@latest uninstall --pack pstack --target opencode
npx -y @rovergon/agent-skills@latest uninstall --pack pstack --target opencode --purge
npx -y @rovergon/agent-skills@latest uninstall --all

doctor is read-only and does not change local skills. prune is explicit and removes managed skills that no longer exist on the main branch. uninstall removes every skill listed in that pack's local manifest; skills not in the manifest are left untouched. --purge then deletes that pack's manifest and backup directory only. Different skill folders are backed up before replacement, and removed skills before removal; only the latest backup for each skill is retained. uninstall does not download from GitHub. Without a TTY, --purge proceeds; in a TTY it asks for confirmation. uninstall --all (or uninstall all) removes managed skills from every target and pack where they are present, so it needs no target or pack; add --purge to also delete the manifests and backups. --all cannot be combined with --pack or --target.

Skills are installed into the official user skills directory of the chosen software. Codex uses $CODEX_HOME/skills, defaulting to ~/.codex/skills on macOS and Linux and %USERPROFILE%\.codex\skills on Windows. Cursor uses ~/.cursor/skills on macOS and Linux and %USERPROFILE%\.cursor\skills on Windows. OpenCode uses ~/.config/opencode/skills, or $XDG_CONFIG_HOME/opencode/skills when XDG_CONFIG_HOME is set, and %USERPROFILE%\.config\opencode\skills on Windows. agents uses the cross-tool convention ~/.agents/skills on macOS and Linux and %USERPROFILE%\.agents\skills on Windows, which Cursor, Codex, Copilot, and Gemini CLI also read.

All three packs copy skill folders into that same host skills directory (skills/<skillName>/SKILL.md). Codex, Cursor, and OpenCode discover one level of skills/*/SKILL.md, so a nested skills/pstack/<name>/ folder would not load. Pack isolation is the picker source plus separate manifests and backups under the software home: manifest.json and backups/ for default, manifest-pstack-light.json and backups-pstack-light/ for pstack-light, manifest-pstack.json and backups-pstack/ for pstack. prune, uninstall, and install of one pack do not read or write another pack's manifest.

Development

npm install
npm test
npm pack --dry-run

Publishing remains a manual operation outside this installation flow:

npm version patch
git push --follow-tags
npm publish --access public