Skip to main content
skill CX Codex

capture · nimbalyst — Claude Code skill: records session decisions in your wiki

Writes the decisions made during a session into the wiki pages they affect. Useful when the reasoning matters as much as the code.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add nimbalyst/nimbalyst --skill capture -a claude-code
Open on GitHub

What capture does

The skill reads the current session and pulls out what is worth keeping: what people decided, who decided it, what was rejected and why, and which questions stayed open. Routine progress and anything git log already shows get dropped. If nothing is left, it replies "nothing to record" and stops.

It works against a team or a local wiki. For the team wiki it calls pages_status with repo and project; when the state comes back ambiguous, it asks which project and pins it. For a local wiki it uses the nimbalyst-local tools, and offers to start one if none exists. Before writing, it reads the guide page on how that wiki is written and follows it. On a local wiki it starts from the code: pagesForFiles over the files this session changed, then either updates each page it finds or marks it outdated with one line about what changed.

One thing to watch: stale on a page means a covered file was committed after the page last changed, and that can include commits from before this session. The skill records only what changed now and says the page may lag further instead of guessing at older edits. If the desktop app's mcp__nimbalyst-trackers__* tools are available, it uses those and the desktop wiki skills rather than its own. It closes by listing the pages it updated, one link per line.

What it helps with

  • keep session decisions in the project wiki
  • flag pages that went stale after code changes
  • record what was rejected and why
  • leave open questions for teammates
  • capture context that git log does not hold

Example prompts for the agent

  • capture: record this session's decisions in the wiki
  • capture, just the auth scheme discussion
  • capture and update the pages the changes touched

How to install capture

1Skills CLI (Vercel)

npx skills add nimbalyst/nimbalyst --skill capture -a claude-code

2Manually: put the files in place

~/.claude/skills/capture/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/capture/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about capture

How do I install capture in Claude?

Run npx skills add nimbalyst/nimbalyst --skill capture -a claude-code. The skill file lands at ~/.claude/skills/capture/SKILL.md.

What does capture do?

It reads the current session and writes decisions, rejected options and open questions into the affected wiki pages. Writes go through the update skill, and picking the wiki is covered by connect.

Where do the writes land?

In a team or local wiki. If the project came from a pin or you are in several teams, the skill first says which project it writes to; on a local wiki it names the folder.

Source text

SKILL.md · MIT
---
name: capture
description: Record what people decided in this session in the wiki pages it affects (team or local wiki). Use when the user asks to capture or record what the session decided, or when a wiki reminder asks you to.
argument-hint: "[optional focus]"
---

Record what this session decided in the project's wiki. Load the `update` skill and follow it for every write; the `connect` skill covers choosing the wiki and finding the project.

Focus, if the user gave one: $ARGUMENTS (left as written or empty means the whole session)

1. If the desktop app's wiki tools are available (`mcp__nimbalyst-trackers__*`), use them and the desktop wiki skills instead of this plugin's tools.
2. Choose the wiki as the `connect` skill describes. For the team wiki, call `pages_status` with `repo` and `project`; if the state is `ambiguous`, ask which project and pin it; if it is `unbound`, follow the skill's connecting steps. For a local wiki, use the `nimbalyst-local` tools; if there is none yet, offer to start one. If there is still no wiki to write to, say so and stop.
3. Read the guide page ("How we write this wiki": `guideLink` on the team wiki, `listPages` on a local one) and follow it.
4. On a local wiki, start from the code: call `pagesForFiles` with the files this session changed (no arguments checks the working tree; when the work is already committed, pass the files, or `since` with the commit before it). For each page it returns, read it and either update it with what the change means for a reader, or, when you cannot say that well, set its `status` to `outdated` (`setPageFields`, or `tracker_update` on a typed page) and add one line saying what changed and where. `stale` means a covered file was committed after the page last changed, which may include commits from before this session; record what this session changed and say the page may lag further rather than guessing at older changes. Skip a page the change does not affect in meaning.
5. List the candidates from this session: decisions people made (who, what was not chosen, and why), questions answered or left open, and context a teammate would need to see the whole problem. Drop routine progress and anything the code or `git log` already says.
6. If nothing is left and no page needed updating, reply "nothing to record" and stop.
7. Otherwise, find the page each candidate affects with `listPages` and `readCollabDoc`, and write it there as the skill says: a decided or open mark on the sentence, a citation from `list_session_inputs` when the person's own words support it. Extend existing pages; create a page only when none fits. When the project came from a pin or the user is in several teams, first say which project the writes go to; on a local wiki, say which folder.
8. End your reply with the pages you updated or marked outdated, one link per line.

© nimbalyst · MIT · nimbalyst/nimbalyst

Similar skills

All skills for Agent setup: memory, context, orchestration →

capture by other authors comes first.

From the same set4

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor