@nebula-skills/installer

Shared installer used by every @nebula-skills/* package.

After npm install -g @nebula-skills/<some-skill>, the skill package's postinstall script calls this installer, which copies the bundled skill/ directory into every detected tool target:

• ~/.claude/skills/<name>/ (Claude Code)
• ~/.cursor/skills/<name>/ (Cursor)
• ~/.codex/skills/<name>/ (Codex CLI)

Tools whose root dir does not exist are skipped silently.

CLI

nebula-skill install <name> --dir <skill-dir> [--mode copy|symlink] [--targets claude,cursor,codex]
nebula-skill uninstall <name> [--targets claude,cursor,codex]
nebula-skill list
nebula-skill status <name>
nebula-skill help

Environment overrides

| Variable | Effect | | --------------------------------- | --------------------------------------------------- | | NEBULA_SKILL_TARGETS | comma-separated list of claude,cursor,codex | | NEBULA_SKILL_MODE | copy (default) or symlink | | NEBULA_SKILL_SKIP_POSTINSTALL=1 | skip the auto-install on npm install |

Programmatic API

import { install, uninstall, listInstalled, statusOf } from "@nebula-skills/installer";

install({ name: "nebula-code-standards", skillDir: "/abs/path/to/skill", mode: "copy" });