mcpbeat Sign in

Second Brain Metrics Agent Skill

by undefined-ui

>- Record a dated snapshot of the vault's health numbers and compare against previous snapshots so trends are visible. Use this skill for a monthly or quarterly check, when the user asks whether the vault is improving, or asks to track its numbers over time. Do NOT use for a one-off graph analysis, which is second-brain-graph, or for structural repairs.

424 tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
150
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/undefined-ui/second-brain-os --skill second-brain-metrics

The instruction itself

5 sections, as written by the author

Record metrics

A single reading tells you almost nothing. Direction over months is the

information, and nobody remembers what last quarter's orphan rate was.

Core rule

Four numbers, appended to a dated log, compared against the last entry. Never

page count or word count.

Workflow

  • Run scripts/vault_stats.py and scripts/link_check.py.
  • Record: orphan rate, average degree, component count, stale-concept rate,

with the date and total pages for context.

  • Append to the metrics note. Never overwrite previous entries.
  • Compare against the last snapshot and name what moved.
  • Interpret only what changed. A stable number needs no commentary.

Output format

<date> | pages <n>
orphan rate    <n>%   (<+/-n> since <date>)
avg degree     <n>    (<+/-n>)
components     <n>    (main <n>%)
stale concepts <n>%   (<+/-n>)

Moved: <what changed and the likely cause>
Watch: <the one number to fix, or none>

Calibration

A rising orphan rate with a rising page count means ingestion has stopped

linking. That is the single most important pattern in this report and it should

be called out explicitly, not left in the numbers.

Do not recommend more than one thing to fix. A metrics report with five action

items gets ignored.

How to use it

Copy the folder

Take undefined-ui/second-brain-metrics from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.