How do I install the Pkc Session skill?

Run npx skillmds@latest add spillwavesolutions/pkc-session in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Pkc Session skill do?

Open or close an isolated second-brain write session (worktree + PR). Use before capturing or materializing when multiple agents share one knowledge remote. It is listed under Coding & Dev Tools on SkillMD.

Is Pkc Session safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Pkc Session?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Pkc Session free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Pkc Session?

spillwavesolutions (@spillwavesolutions) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Pkc Session by spillwavesolutions — Agent Skill

Name: Pkc Session
Author: spillwavesolutions

File contents

pkc-session

When

More than one agent or machine writes the shared second brain
The current project worktree is not the knowledge repo
The user asks to isolate writes, open a knowledge PR, or avoid clobbering main

Open

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/brain_session.py" open \
  --repo . \
  --bundle knowledge \
  --actor "${SECOND_BRAIN_IDENTITY:?claim an identity first}" \
  --plugin project-knowledge-capture \
  --host claude-code

Export SECOND_BRAIN_ROOT and BRAIN_SESSION_ID from the JSON. All writes go to that bundle via scripts/pkc_*.py.

Close

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/brain_session.py" close \
  --repo . \
  --session "${BRAIN_SESSION_ID}"

Pushes to whatever remote the checkout already has and opens a PR when gh is available. Never force-push. Never invent a remote URL.

Rules

Read shared truth from main. Overlay this session only.
Do not pack other agents' open branches.
Public examples use fictional lumenfield-detector and northstar-console only.
See docs/ISOLATION.md.

Frequently asked questions

Pkc Session