Holochain Agent Skills

Agent skills for Holochain hApp development, built to the Agent Skills Open Standard so they work in Claude Code, opencode, GitHub Copilot, Cursor, Gemini CLI and every other tool that adopted the format. Pinned to Holochain 0.7, verified against a reference hApp that actually compiles.

Install

mkdir -p .claude/skills && curl -fsSL \
  https://github.com/Soushi888/holochain-agent-skills/releases/download/v1.0.0-rc.1/holochain-agent-skills.tar.gz \
  | tar -xz -C .claude/skills

Run it from the root of the project that should get the skill, and replace .claude/skills with your harness's path if it differs (the table below lists them all). The archive's root is one directory per skill, so the extraction lands skills/holochain/SKILL.md with no rename step and no --strip-components. Every release also publishes SHA256SUMS, so you can verify what you downloaded.

Restart your agent afterwards. Most harnesses read skills once, at startup. Then ask it anything about Holochain, or invoke it by name (/holochain in Claude Code).

Other ways to install

Nix. Either take the source tree and point at the subdirectory:

inputs.holochain-agent-skills = {
  url = "github:Soushi888/holochain-agent-skills/v1.0.0-rc.1";
  flake = false;
};
# consume: "${inputs.holochain-agent-skills}/skills/holochain"

or use the flake, which also hands you the devShell glue:

inputs.holochain-agent-skills.url = "github:Soushi888/holochain-agent-skills/v1.0.0-rc.1";

# in your devShell:
shellHook = ''
  ${inputs.holochain-agent-skills.lib.mkSkillsHook {
    inherit pkgs;
    skills = [{
      src  = inputs.holochain-agent-skills.packages.${system}.holochain;
      name = "holochain";
    }];
  }}
'';

packages.<system>.holochain is rooted at the skill itself, so ${it}/SKILL.md exists. packages.<system>.default is the bundle, one directory per skill, matching the release archive. mkSkillsHook writes into .claude/skills, .cursor/skills and .agents/skills by default; pass targets to change that. It exists because every consumer writes the same rsync glue and hits the same wall: Nix store paths are read-only and rsync -a preserves that mode, so the second nix develop fails with a permission error. The hook passes --chmod=u+w.

Clone it, and use the installer. The repository ships a harness-detecting installer that finds every agent harness a project uses and installs into all of them at once:

git clone https://github.com/Soushi888/holochain-agent-skills ~/holochain-agent-skills
cd ~/holochain-agent-skills && bun run build

cd your-project
node ~/holochain-agent-skills/bin/install.mjs install --yes

Useful flags: --global installs into the home-directory scope instead of the project, --target claude,opencode picks specific harnesses, --dry-run prints what would happen, and --link symlinks rather than copies so a git pull updates every installed copy at once. install.mjs list prints every skill and every harness path it knows.

Pin a version. The archive URL above names its tag, so pinning is just choosing the tag. Release candidates are marked as prereleases, which means releases/latest/download skips them: it keeps pointing at the last stable release until 1.0.0 ships.