Files

admin 9bf56a806b Move docs/ package mirror into document-navigator plugin

Relocate the ~6k-file docs tree from the repo root into
plugins/document-navigator/docs/ so the plugin is self-contained and
portable. docs/superpowers/ (specs and plans) stays at the repo root.

Moved via cp+rm rather than git mv because directory rename() fails with
EPERM on this WSL /mnt DrvFs mount; git rename-detection pairs the
identical-content files at commit time.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-05-30 01:10:00 +01:00

assets/skills

Move docs/ package mirror into document-navigator plugin

2026-05-30 01:10:00 +01:00

src

Move docs/ package mirror into document-navigator plugin

2026-05-30 01:10:00 +01:00

README.md

Move docs/ package mirror into document-navigator plugin

2026-05-30 01:10:00 +01:00

README.md

@suaveplan/install-agent-skills - Suaveplan installer plugin: bundles the agent-skills set and installs them into a target project via @suaveplan/installer.

Summary

Installer plugin that bundles every Suaveplan skill (SKILL.md + assets) and installs them into a target project via @suaveplan/installer.

Documentation tree

apply — (no submodules)
- apply — (no submodules)
detect — (no submodules)
- detect — (no submodules)
plan — (no submodules)
- plan — (no submodules)
plugin — Composes the agent-skills installer plugin from its constituent stages (detect, prompts, plan, apply, `postInst…
- plugin — Composes the agent-skills installer plugin from its constituent stages (detect, prompts, plan, apply, `postInst…
post-install — (no submodules)
- post-install — (no submodules)
prompts — (no submodules)
- prompts — (no submodules)
error-codes — Defines the canonical error-code registry for @suaveplan/install-agent-skills. Every plugin-side failure path (invali…
manifest-loader — Loads and validates the bundled assets/skills/manifest.json produced by scripts/build-skills-bundle.ts. The loader…

- [apply](./src/apply/apply.md) — _(no submodules)_- [detect](./src/detect/detect.md) — _(no submodules)_- [detect](./src/detect/detect.md) — _(no submodules)_- [plan](./src/plan/plan.md) — _(no submodules)_- [plan](./src/plan/plan.md) — _(no submodules)_- [post-install](./src/post-install/post-install.md) — _(no submodules)_- [post-install](./src/post-install/post-install.md) — _(no submodules)_- [prompts](./src/prompts/prompts.md) — _(no submodules)_- [prompts](./src/prompts/prompts.md) — _(no submodules)_- [error-codes](./src/error-codes.md) — Defines the canonical error-code registry for `@suaveplan/install-agent-skills`. Every plugin-side failure path (invali…

manifest-loader — Loads and validates the bundled assets/skills/manifest.json produced by scripts/build-skills-bundle.ts. The loader…
plugin — Composes the agent-skills installer plugin from its constituent stages (detect, prompts, plan, apply, `postInst…
apply — (no submodules)- detect — (no submodules)- detect — (no submodules)- plan — (no submodules)- plan — (no submodules)- post-install — (no submodules)- post-install — (no submodules)- prompts — (no submodules)- prompts — (no submodules)- error-codes — Defines the canonical error-code registry for @suaveplan/install-agent-skills. Every plugin-side failure path (invali…
manifest-loader — Loads and validates the bundled assets/skills/manifest.json produced by scripts/build-skills-bundle.ts. The loader…
plugin — Composes the agent-skills installer plugin from its constituent stages (detect, prompts, plan, apply, `postInst…
apply — (no submodules)- detect — (no submodules)- detect — (no submodules)- plan — (no submodules)- plan — (no submodules)- post-install — (no submodules)- post-install — (no submodules)- prompts — (no submodules)- prompts — (no submodules)- error-codes — Defines the canonical error-code registry for @suaveplan/install-agent-skills. Every plugin-side failure path (invali…
manifest-loader — Loads and validates the bundled assets/skills/manifest.json produced by scripts/build-skills-bundle.ts. The loader…
plugin — Composes the agent-skills installer plugin from its constituent stages (detect, prompts, plan, apply, `postInst…
apply — (no submodules)- detect — (no submodules) - detect — (no submodules)- plan — (no submodules) - plan — (no submodules)- post-install — (no submodules) - post-install — (no submodules)- prompts — (no submodules) - prompts — (no submodules)- error-codes — Defines the canonical error-code registry for @suaveplan/install-agent-skills. Every plugin-side failure path (invali…
manifest-loader — Loads and validates the bundled assets/skills/manifest.json produced by scripts/build-skills-bundle.ts. The loader…
plugin — Composes the agent-skills installer plugin from its constituent stages (detect, prompts, plan, apply, `postInst…

Quickstart

bun add -D @suaveplan/install-agent-skills
npx @suaveplan/installer add agent-skills

Filtered installs

# Only a curated subset
npx @suaveplan/installer add agent-skills --only crypto,events,logger

# Everything except legacy skills
npx @suaveplan/installer add agent-skills --exclude legacy

# Force overwrite, non-interactive
npx @suaveplan/installer add agent-skills --force --no-interactive

Programmatic use

import { agentSkillsPlugin } from "@suaveplan/install-agent-skills";
import { Host, DiskFs } from "@suaveplan/installer";

const fs = new DiskFs({ cwd: process.cwd() });
const host = new Host(ctx, fs);
const result = await host.run(agentSkillsPlugin, {
    answers: { targetDir: ".suaveplan/skills" },
});
console.log(`installed ${result.handle?.installed} skills`);

Bundle build

The plugin ships its skill set inside assets/skills/. To rebuild the bundle from the upstream suaveplan-skills marketplace:

bun run build:bundle

By default the script reads from ../../../../suaveplan-skills/plugins; override via SUAVEPLAN_SKILLS_ROOT=/path/to/skills bun run build:bundle.

Module documentation

Every implementation file ships with a sibling .md covering Purpose, Features, Usage, API Reference, and Implementation Notes. See src/plan/plan.md, src/manifest-loader.md, src/plugin.md for the load-bearing modules.

License

MIT