review

Scan Second Brain projects for blockers, stale projects, and pending dreams.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/Cain-Ish/claude-code-plugin --skill review-cain-ish
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review
Source: https://github.com/Cain-Ish/claude-code-plugin/tree/main/skills/review
Command: npx skills add https://github.com/Cain-Ish/claude-code-plugin --skill review-cain-ish

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

You often lose track of which projects are blocked, drifting stale, or accumulating unreviewed context signals, so it becomes hard to decide what to focus on next.

Core Features & Use Cases

  • Cross-project blocker review: Scans each project’s ~/.second-brain/projects/*/PROJECT.md and groups any lines under ## Open blockers.
  • Staleness detection: Flags projects whose PROJECT.md mtime (or last extraction marker) is older than 14 days.
  • Pending dreams and persona graduation: Surfaces completed-but-unarchived dreams from ~/.second-brain/dreams/ and lists ungraduated persona signals where count >= 2 and graduated == false.
  • Wiki activity sanity check: Counts total wiki pages and those updated in the last 7 days to confirm knowledge is actually growing.
  • Read-only daily/weekly overview: Provides a single consolidated report without mutating state, suitable for a quick daily start or context-switch wrap-up.

Quick Start

Run the review skill to get today’s read-only snapshot of blockers, stale projects, pending dreams, ungraduated persona signals, and recent wiki activity across all registered projects.

Frequently Asked Questions about review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get a cross-project blocker and staleness snapshot for daily planning?

A cross-project blocker and staleness snapshot scans locally stored Second Brain project state in ~/.second-brain, reading PROJECT.md files to group open blockers and flag projects older than 14 days. It produces a read-only consolidated report for daily planning.

What is the best way to track ungraduated persona signals and pending dreams?

To track ungraduated persona signals and pending dreams, the review process reads status.json files from ~/.second-brain/dreams/ and persona-signals.jsonl observations, surfacing completed-but-unarchived dreams and signals where count >= 2 and graduated is false.

How do I check local wiki activity and knowledge growth across projects?

Checking local wiki activity involves counting total wiki pages and identifying those updated in the last 7 days within the ~/.second-brain directory, confirming knowledge growth through a read-only filesystem scan without mutating state.

Does the cross-project review snapshot modify my local project files or state?

The cross-project review snapshot does not modify local project files or state. It performs read-only filesystem and JSON processing using permitted Bash tools and a knowledge stats MCP tool, omitting empty sections to provide a clean overview.

What prerequisites are needed to scan for stale projects and open blockers?

Scanning for stale projects and open blockers requires a deterministic filesystem with locally stored Second Brain project state in ~/.second-brain, including per-project PROJECT.md files, dreams status.json files, and persona-signals.jsonl observations.