Agent skill

Pi Review

by natsukium in natsukium/dotfiles

Delegate a source-grounded design or code review to a fresh pi CLI process using sol or luna, then address verified findings until no blockers remain.

CC0-1.0Auto-check passedKnowledge Management

Install Pi Review

skills CLI
$ npx skills add natsukium/dotfiles --skill pi-review -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install natsukium/dotfiles pi-review --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/natsukium/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/modules/features/coding-agents/common/skills/pi-review .claude/skills/pi-review && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pi-review
GitHub stars
106
Token cost
~972 tokens
SKILL.md length
459 words
Files
3 (incl. scripts, references)
Skills in repo
10
Repo updated
First seen
Licence
CC0-1.0

At a glance

Delegate a source-grounded design or code review to a fresh pi CLI process using sol or luna, then address verified findings until no blockers remain.

  • Works in 5 steps: Read the review and verify each cited… → Fix accepted blockers and run the… → Start a fresh review with the previous… → …
  • Explicitly asked to get a review from pi/sol/luna
  • SKILL.md covers Models, Prepare the review, Run the review and Iterate
  • 「piにレビューもらって」「レビュー通して」

What it does

Pi Review is an agent skill from natsukium/dotfiles. Delegate a source-grounded design or code review to a fresh pi CLI process using sol or luna, then address verified findings until no blockers remain. Use when explicitly asked to "get a review from pi/sol/luna", 「piにレビューもらって」「レビュー通して」, or to obtain a fresh independent-context review.

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts and reference files (for example `references/reviewer.md`).

It sits in Knowledge Management, covering Source-grounded notebooks. The repository describes itself as: Nix dotfiles for NixOS, Darwin and WSL. The licence is CC0-1.0.

When your agent uses it

  • Explicitly asked to get a review from pi/sol/luna
  • 「piにレビューもらって」「レビュー通して」
  • Obtain a fresh independent-context review

Example prompts

  • “get a review from pi/sol/luna”
  • “/pi-review”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Read the review and verify each cited location and failure mechanism.
  2. Fix accepted blockers and run the relevant checks.
  3. Start a fresh review with the previous findings and resolutions recorded in the
  4. Continue until the verdict is PASS. Do not change the target for a mistaken or
  5. Report each round's verdict and the accepted or rejected findings to the user.

What it can do on your machine

Read from SKILL.md and the folder at commit 31561dd. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pi Review loads about 972 tokens when it runs, and up to ~1.3k if it reads all its reference files. Until then it costs about 74 tokens; SKILL.md has 459 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~74
When it runs · the whole SKILL.md, loaded when a task matches
~972
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from natsukium/dotfiles at commit 31561dd, republished under its CC0-1.0 licence (© natsukium). 459 words, ~972 tokens.

Download SKILL.mdSave it as .claude/skills/pi-review/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
pi-review
description
Delegate a source-grounded design or code review to a fresh `pi` CLI process using sol or luna, then address verified findings until no blockers remain. Use when explicitly asked to "get a review from pi/sol/luna", 「piにレビューもらって」「レビュー通して」, or to obtain a fresh independent-context review.

Reviews Through pi

Run a fresh pi process so the review does not inherit the calling conversation. The reviewer inspects the repository; the calling agent verifies findings and owns any revisions.

Models

ModelUse for
openai-codex/gpt-6.1-solAdversarial design or diff review; final gate
openai-codex/gpt-6-lunaEarly drafts, quick checks, and triage between sol rounds

Use an explicitly requested model. Otherwise use luna for an early pass and sol for high-risk reasoning or the final pass.

Prepare the review

Write the change-specific information to a scratch file outside the repository:

markdown
# Review context

Target: <document or change>
Review range: <git diff, git diff --cached, or base...HEAD; omit for a document>
Revision context: <what changed and why>
Focus: <risks to examine>
Previous findings: <findings and claimed resolutions, or none>

For a design, attach the document with --attach. For code, let pi inspect the named Git range and surrounding source instead of copying the diff into the prompt. The fixed review criteria and output format live in ./references/reviewer.md, which the script passes itself.

Run the review

./scripts/pi-review launches pi detached from the calling shell and waits for it in a separate step, so the review survives a caller whose shell is killed or timed out. Run it from inside the target repository: it starts pi at the repository root and refuses to start elsewhere.

bash
<skill-directory>/scripts/pi-review start --out /abs/scratch/review-1 \
  --context /abs/scratch/review-context.md [--attach /abs/path/design.md] [--model luna]
<skill-directory>/scripts/pi-review wait /abs/scratch/review-1

--model defaults to sol. wait prints the review, saves it to <out>.md, and exits 0 for PASS, 1 for BLOCKED, and 2 when pi ended without a verdict (its stderr is in <out>.err; that is not a review result). Sol rounds take 13 to 50 minutes and luna 10 to 15.

Where the caller's command timeout is shorter than a review, pass wait --timeout <seconds> below that limit and call wait again after exit 124; the review keeps running in between. Claude Code may instead run wait as a background command and act on its completion notice. wait exits 3 when the event stream has been silent for 15 minutes (--stall); then run pi-review stop <out> and start the round once more. Stop a review only through stop, which kills the recorded pid: a pkill -f pattern naming the model also matches the calling shell's own command line.

Show full SKILL.md (129 more words)Show less

PI_REVIEW_WORKER=1 is set by the script: pi then omits this delegation skill from the child while loading other global and project skills normally.

Iterate

  1. Read the review and verify each cited location and failure mechanism.
  2. Fix accepted blockers and run the relevant checks.
  3. Start a fresh review with the previous findings and resolutions recorded in the new context file. Narrow Focus as the remaining risk changes.
  4. Continue until the verdict is PASS. Do not change the target for a mistaken or out-of-scope finding; record the evidence or scope boundary in the next context. After three consecutive BLOCKED rounds, stop and ask the user whether the direction still holds before starting another.
  5. Report each round's verdict and the accepted or rejected findings to the user.

© natsukium, CC0-1.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts, references) in modules/features/coding-agents/common/skills/pi-review of natsukium/dotfiles.

  • SKILL.md
  • references/reviewer.md
  • scripts/pi-review

Open the folder on GitHubat commit 31561dd

Compare with similar skills

Pi Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pi Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pi Review this skillnatsukium/dotfiles106—~972Automated safety check: PassCC0-1.0
Kdrive Sentry RcaInfomaniak/desktop-kDrive120—~4.1kAutomated safety check: PassGPL-3.0
NotebookLM Automationteng-lin/notebooklm-py20k—~4.1kAutomated safety check: PassMIT
Zlibrary To Notebooklmzstmfhy/zlibrary-to-notebooklm1.7k1 repos~968Automated safety check: PassMIT
Multi-Source to NotebookLM Processorjoeseesun/qiaomu-anything-to-notebooklm6.2k—~3.6kAutomated safety check: PassMIT
Learn From Materialsdmoshehun-prog/learn-from-materials947—~7.9kAutomated safety check: PassMIT

Similar skills

  • Kdrive Sentry Rca

    Infomaniak/desktop-kDrive

    Investigate kDrive crashes, Sentry issues, and application logs to produce source-grounded root cause analyses.

    120 GitHub stars~4.1k tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • NotebookLM Automation

    teng-lin/notebooklm-py

    Installs, authenticates and operates Gemini Notebook (NotebookLM) through the notebooklm-py CLI or its typed async Python API, for notebooks, sources, grounded chat and generated artifacts.

    20k GitHub stars~4.1k tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • Zlibrary To Notebooklm

    zstmfhy/zlibrary-to-notebooklm

    自动从 Z-Library 下载书籍并上传到 Google NotebookLM。支持 PDF/EPUB 格式,自动转换,一键创建知识库。

    1.7k GitHub starsUsed in 1 repo~968 tokens
    Knowledge ManagementAuto-check passed
  • Multi-Source to NotebookLM Processor

    joeseesun/qiaomu-anything-to-notebooklm

    Collects content from WeChat articles, web pages, YouTube, podcasts, documents and more, uploads it to NotebookLM and generates podcasts, slides or mind maps.

    6.2k GitHub stars~3.6k tokensUpdated 6 days ago
    Knowledge ManagementAuto-check passed
  • Learn From Materials

    dmoshehun-prog/learn-from-materials

    Turns books, PDFs, slides and web pages into a source-grounded knowledge base and an interactive learning page in English or Chinese, with quizzes, relationship maps and reusable methodology notes.

    947 GitHub stars~7.9k tokensUpdated 4 days ago
    Knowledge ManagementAuto-check passed
  • NotebookLM Research Workflow

    claude-world/notebooklm-skill

    Creates NotebookLM notebooks from URLs, text and files, asks cited questions, runs web research and generates audio, slides, quizzes and other artifacts.

    467 GitHub stars~1.8k tokensUpdated 2 mo ago
    Knowledge ManagementAuto-check passed

More from natsukium/dotfiles

All 10 skills in this repo
  • Attmcojp Claude Md

    natsukium/dotfiles

    Change the org-level CLAUDE.md that governs every attmcojp repository.

    106 GitHub stars~1.3k tokensUpdated today
    Auto-check: notes
  • Ghq

    natsukium/dotfiles

    Clone and reuse GitHub/GitLab repositories under a single managed root (ghq root) instead of fetching files one-by-one via gh api/WebFetch or scratch-cloning into /tmp.

    106 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Gui Debug

    natsukium/dotfiles

    Verify a rendering or window-chrome change in any macOS GUI app unattended — find its CGWindowID via JXA, capture that window alone (with per-pixel alpha) using screencapture -l, and read exact RGBA…

    106 GitHub stars~909 tokensUpdated today
    Auto-check passed
  • Gui Debug

    natsukium/dotfiles

    Verify a rendering or window-chrome change in a GUI app unattended on Linux/Wayland under the niri compositor — enumerate windows and read output scale via niri msg --json, capture a specific window…

    106 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Po Translate

    natsukium/dotfiles

    Orchestrate English→Japanese translation of po/ja.po — classify, delegate translation/review to subagents, iterate until clean

    106 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Gh

    natsukium/dotfiles

    GitHub CLI for pull requests, issues, releases, workflows, and repository operations.

    106 GitHub stars~422 tokensUpdated today
    Auto-check passed

Questions about Pi Review

What does Pi Review do?

Delegate a source-grounded design or code review to a fresh pi CLI process using sol or luna, then address verified findings until no blockers remain. Pi Review is an agent skill from natsukium/dotfiles. Delegate a source-grounded design or code review to a fresh pi CLI process using sol or luna, then address verified findings until no blockers remain.

When should I use Pi Review?

Pi Review fits situations like: explicitly asked to get a review from pi/sol/luna; 「piにレビューもらって」「レビュー通して」; obtain a fresh independent-context review.

How do I install Pi Review in Claude Code?

Run `npx skills add natsukium/dotfiles --skill pi-review -a claude-code`. Or copy the skill folder (modules/features/coding-agents/common/skills/pi-review in natsukium/dotfiles) into .claude/skills/pi-review in your project. Claude Code loads it when a task matches its description.

How do I install Pi Review in Codex?

Run `npx skills add natsukium/dotfiles --skill pi-review -a codex`. Or copy the skill folder (modules/features/coding-agents/common/skills/pi-review in natsukium/dotfiles) into .agents/skills/pi-review in your project. Codex loads it when a task matches its description.

Can I use Pi Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add natsukium/dotfiles --skill pi-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pi-review, .gemini/skills/pi-review, .github/skills/pi-review and .opencode/skills/pi-review in your project.

What does Pi Review need to run?

SKILL.md names no scripts, command-line tools or credentials: Pi Review is instructions for the agent only.

Does Pi Review access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Pi Review safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Pi Review use?

Pi Review is published under the CC0-1.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pi Review use?

About 972 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 296 tokens, read only when the agent opens those files.

What are the alternatives to Pi Review?

Skills that share tags, products or a category with Pi Review: Kdrive Sentry Rca (Infomaniak/desktop-kDrive, 120 stars), NotebookLM Automation (teng-lin/notebooklm-py, 20k stars), Zlibrary To Notebooklm (zstmfhy/zlibrary-to-notebooklm, 1.7k stars) and Multi-Source to NotebookLM Processor (joeseesun/qiaomu-anything-to-notebooklm, 6.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pi Review?

natsukium (a GitHub user) maintains it in natsukium/dotfiles, which has 106 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 10, 2026.

Source: natsukium/dotfiles on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.