Skillsship-second-brain

Ship Second Brain

Builds and maintains a team second brain in one markdown folder: raw issues, PRs, specs and call notes saved first, cut into one-idea notes with a source and confidence (seen, verified, opinion), linked, verified against the source, summed…

3 files and 409 lines, free under MIT. Built from arm-pz/ship-second-brain at 28e5c64.

What it is for

Builds and maintains a team second brain in one markdown folder: raw issues, PRs, specs and call notes saved first, cut into one-idea notes with a source and confidence (seen, verified, opinion), linked, verified against the source, summed up in today.md, and checked by an answer test, with misses in gaps.md. Use whenever a question or task touches such a vault (a folder with raw/ and notes carrying confidence front matter): what did we decide about X and where is it written down, a new spec or source that says something different from a verified note, ingest PRs or issues, file call notes, verify or upgrade notes, clean up or delete files, run the answer test, stop re-explaining context every session. Even if they never say second brain.

Not for

  • A one-off summary of one document, a shareable doc built from the vault (use docs)
  • A database or Notion setup

Know what you are installing.

Version, date and limits are read from the repo on every sync, and the check runs every night. Real-world runs are listed only with their evidence.

Version
Unversionedcommit 28e5c64
Updated
Not recorded yet
Works in
Claude Code, Codex, Cursor, Qoder and any agent that loads a SKILL.mdplain text; no API keys
Nightly check
Not checked yetIt joins the nightly check after its first run. How it is checked
Last real-world run
No public run yetRuns are published only with their evidence.
Known limits
Not built for:
  • A one-off summary of one document, a shareable doc built from the vault (use docs)
  • A database or Notion setup

Every file it installs

Measured from the packed archive at commit 28e5c64. A skill is plain text your agent reads, so this list is all of it.

FileLinesBytes
SKILL.md1136,565 B
references/note-format.md882,693 B
scripts/check_vault.py2087,992 B
3 files4097 KB

More in Build & Ship

Read it before you install it: the skill lives at skills/ship-second-brain in arm-pz/ship-second-brain.

Open the repo