agentleFS
kaithoughtarchitectkaithoughtarchitect/toppingout/skills/pack-review/SKILL.md

pack-review

Skill14 starsChanged 20 days agoMITView on GitHub

Package the current goal, constraints, and diff or artifact into a pasteable brief for an independent reviewer in another session. Does not review and does not rewrite. Use when the user types /pack-review before carrying work to a second model, or when an unattended run reaches its cross-model gate and needs the brief before dispatching `scripts/cross-review-dispatch.mjs`. Not a planning or build pack, and not a review (f-inspect, xreview).

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If they named a PR, branch, or files, gather those (git diff, git status, the named paths).

    line 41

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

pack-review

Build a single copy-paste review brief for a different session. Do not review. Do not rewrite. Do not name this model.

Loop

/pack-review (this session) → /xreview (reviewer session) → /adjudicate (back here).

Two ways the brief crosses to the reviewer:

  • Hand-carried (a human is driving). The user copies the fenced block and pastes it into the other session by hand.
  • Automated (unattended). The session that did the work invokes the dispatcher (scripts/cross-review-dispatch.mjs, wherever the repo installed it) with --host <this session's family> --brief <path to this brief> --out <dir>, plus --cwd <the checkout under review> when the reviewer must run somewhere other than the dispatcher's working directory. That script seats the reviewer on a different CLI vendor by a fixed, no-picker seat rule and runs it headless, it never asks this session to guess who reviews, and this session never invokes /xreview on the brief itself.

Either way, your own output here is the review brief only, you do not review it and you do not dispatch it yourself beyond writing it to where the caller asked.

disable-model-invocation is false so an unattended session can invoke this skill on its own at its cross-model gate without a human typing the slash command. That flip does not authorize this session to also play the reviewer: xreview on an artifact this same session produced is never valid, flag or no flag, independence here comes from a different process on a different vendor CLI (the dispatcher), never from this setting.

Gather

Stay read-only. Prefer live repo state over memory.

  1. Goal and hard constraints from this session, plus any extras the user just added in $ARGUMENTS.
  2. Non-goals and already-rejected approaches, if known.
  3. What to review: PR URL, branch, file list, or a unified diff.
  4. Tests or repro steps that already exist.
  5. Anything the reviewer must not relitigate.

If they named a PR, branch, or files, gather those (git diff, git status, the named paths). If the diff is huge, pack the file list plus the highest-risk hunks and say what was omitted.

Write every path in the brief as an absolute path whenever the reviewer may run in a different working directory or checkout than this session (a separate worktree, a separate repo holding the records): a relative path the reviewer resolves against the wrong root is a silent wrong review.

Redact

The reviewer must not learn which model did the work. Before emitting the brief, strip anything that names a model or vendor: commit trailers (Co-Authored-By, Generated with ...), session or tool names that identify the vendor, and paths under .claude/, .grok/, or .codex/ unless that path is itself what is under review. Replace, do not summarise around, the stripped text.

Output

One fenced markdown block the user can copy verbatim. No commentary before or after the block.

# Review brief

## Goal
...

## Hard constraints
- ...

## Non-goals
- ...

## What to review
- paths / PR / branch

## Diff or artifact
...

## Tests / repro
- ...

## Do not relitigate
- ...

## Reviewer instruction
Review with /xreview. Do not guess the author. Reply with the /xreview sections only, no essay.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.