@cerebral-work/skills
v0.1.2
Published
Cerebral estate agent skills: one install for every harness, on both sides of WSL
Maintainers
Readme
@cerebral-work/skills
One install for agent skills across every harness on a machine, including both sides of a WSL setup.
npx @cerebral-work/skills # install (default)
npx @cerebral-work/skills doctor # report drift; exit 1 on drift
npx @cerebral-work/skills uninstall # remove what it installed; edited copies are keptThe package is public and contains only the installer. The skills themselves are
fetched at install time from a git repository you can read (default:
[email protected]:unsigned-gg/agentic.git, packages/skills/skills/), using your
own SSH key. With gh credentials instead, run gh auth setup-git and pass
--repo https://github.com/unsigned-gg/agentic.git. Without access, nothing is
installed.
What install does
- Linux: copies each skill into
~/.agents/skills/<name>as a real directory, recorded in.cerebral-skills-manifest.json, then symlinks it into every agent harness whose root directory exists: Claude Code (~/.claude), pi (~/.pi), opencode (~/.config/opencode), hermes (~/.hermes), omp (~/.omp). Gaps in omp'sincludeSkillsallowlist are reported, and--write-ompappends them. - Windows, when run from WSL: finds the Windows profile and copies the
portable skills into
%USERPROFILE%\.claude\skillsas real files, with their own manifest. Windows cannot follow WSL symlinks reliably, so nothing there is a link.synced\, which claude.ai manages, is never touched. - Ownership: a skill directory the installer did not write is replaced only
when it is byte-identical (adopted) or with
--adopt(the old copy is backed up first). A directory it wrote and someone edited is replaced only with--force.
A skill is portable unless its frontmatter declares
metadata.platforms: [linux]. With no declaration, a skill that mentions a
Linux-only tool (kubectl, systemctl, journalctl, ~/.local/bin, /proc/, …)
stays on the Linux side.
Options
| Flag | Meaning |
|---|---|
| --dry-run | print what would change, write nothing |
| --from <dir> | install from a local directory instead of fetching |
| --repo <url> / --ref <branch\|tag> | where to fetch from (also CEREBRAL_SKILLS_REPO) |
| --adopt / --force | replace foreign / locally edited skill directories |
| --write-omp | append missing skills to omp's allowlist |
| --home <dir> / --windows-home <dir> / --no-windows | targets |
Development
pnpm test runs the installer against sandboxed Linux and Windows homes.
skills/ holds the content and is not part of the npm package; see
skills/README.md.
