Agent skill

agtx Review Phase

by fynnfluegge in fynnfluegge/agtx

Self-reviews completed work in an agtx-managed task for correctness, edge cases and code quality, fixes issues, commits and writes .agtx/review.md with a status.

Apache-2.0Auto-check passedDevelopment

Install agtx Review Phase

skills CLI
$ npx skills add fynnfluegge/agtx --skill agtx-review -a claude-code

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

GitHub CLI
$ gh skill install fynnfluegge/agtx agtx-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/fynnfluegge/agtx.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/agtx-terse/skills/agtx-review .claude/skills/agtx-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
agtx-review
GitHub stars
1.7k
Token cost
~475 tokens
SKILL.md length
240 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
Apache-2.0

At a glance

Self-reviews completed work in an agtx-managed task for correctness, edge cases and code quality, fixes issues, commits and writes .agtx/review.md with a status.

  • Works in 4 steps: Pick the scope. If .agtx/reviewed-at… → Check for → Fix any issues you find → …
  • Finishing an agtx task and reviewing it before merge
  • SKILL.md covers Instructions, Output, Review and Status, plus 2 more sections
  • Calls git

What it does

This skill runs the review phase of an agtx-managed task. The agent picks its scope: if .agtx/reviewed-at exists, it reviews only changes since that commit and checks that the points in the previous review were addressed. Otherwise it reviews everything done during execution with git diff HEAD and the commits since the merge base with origin/HEAD, never diffing against main, and reads untracked files in full. It checks correctness and edge cases, error handling, style consistency, test coverage and security issues such as injection and XSS.

Issues it finds are fixed and committed with a clean git status, because uncommitted work is destroyed at task completion and the merge is blocked until the tree is clean. The review goes to .agtx/review.md in the working directory, with a Review section of findings and a Status of READY or NEEDS_WORK with the remaining issues. The agent then says the review was written and stops to wait. Its output style is terse, with fragments allowed and one-line status updates.

When your agent uses it

  • Finishing an agtx task and reviewing it before merge
  • Re-reviewing only the new commits after a first review
  • Producing a READY or NEEDS_WORK verdict file for a task

Example prompts

  • “Review the work on this task and write .agtx/review.md.”
  • “Re-review only what changed since the last agtx review.”
  • “Check this branch for edge cases and security issues and fix what you find.”

Requirements

  • An agtx-managed task with a git working tree

Workflow steps

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

  1. Pick the scope. If .agtx/reviewed-at exists, a prior review covered everything up to that commit: review git diff $(cat…
  2. Check for
  3. Fix any issues you find
  4. Commit them. git add -A, commit, verify git status --short clean. Uncommitted = destroyed at task completion; merge is blocked until clean.

What it can do on your machine

Read from SKILL.md and the folder at commit 8ae6868. 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

    Shell commands in SKILL.md call:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

agtx Review Phase loads about 475 tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 240 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~34
When it runs · the whole SKILL.md, loaded when a task matches
~475

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from fynnfluegge/agtx at commit 8ae6868, republished under its Apache-2.0 licence (© fynnfluegge). 240 words, ~475 tokens.

Download SKILL.mdSave it as .claude/skills/agtx-review/SKILL.md (or your agent's skills folder).
name
agtx-review
description
Self-review completed work. Check for correctness, edge cases, and code quality. Write review to .agtx/review.md and stop.

Review Phase

You are in the review phase of an agtx-managed task.

Instructions

  1. Pick the scope. If .agtx/reviewed-at exists, a prior review covered everything up to that commit: review git diff $(cat .agtx/reviewed-at)..HEAD plus git status --short for uncommitted work, and read the prior .agtx/review.md — check its points were addressed, don't re-review the branch. Otherwise review all changes made during execution: git diff HEAD (staged+unstaged) and git log --oneline $(git merge-base HEAD origin/HEAD)..HEAD for your commits. Do NOT diff against main or origin/main — those may include unrelated upstream history. Either way ?? lines in git status --short are untracked files that git diff never shows — read them in full.
  2. Check for:
    • Correctness and edge cases
    • Error handling
    • Code style consistency with the existing codebase
    • Test coverage
    • Security issues (injection, XSS, etc.)
  3. Fix any issues you find
  4. Commit them. git add -A, commit, verify git status --short clean. Uncommitted = destroyed at task completion; merge is blocked until clean.

Output

Write your review to .agtx/review.md in the current working directory with these sections:

Review

Findings from your review — what looks good, what was fixed, any concerns.

Status

Either READY (good to merge) or NEEDS_WORK (with explanation of remaining issues).

CRITICAL: Stop After Writing

After writing .agtx/review.md (in the current working directory):

  • Say: "Review written to .agtx/review.md."
  • Wait for further instructions

Output Style

Terse. No pleasantries. Fragments OK. Short synonyms. Code exact. Status updates: one line. Pattern: [what] [why]. Done.

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

Files

Just SKILL.md in plugins/agtx-terse/skills/agtx-review of fynnfluegge/agtx.

Open the folder on GitHubat commit 8ae6868

Compare with similar skills

agtx Review Phase 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.

agtx Review Phase compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
agtx Review Phase this skillfynnfluegge/agtx1.7k—~475Automated safety check: PassApache-2.0
Qt C++ Code Reviewx-tools-author/x-tools1.1k2 repos~4.3kAutomated safety check: PassBSD-3-Clause
Adversarial Reviewer302ai/302-AI-Studio1321 repos~3kAutomated safety check: PassMIT
Feature-Level Code Reviewdataelement/bisheng12k—~1kAutomated safety check: PassApache-2.0
Two-Axis Code Reviewrengwu/wayfinder-maps137—~1.8kAutomated safety check: PassMIT
Code Revieweralirezarezvani/claude-code-tresor777—~1.8kAutomated safety check: PassMIT

Similar skills

  • Qt C++ Code Review

    x-tools-author/x-tools

    Read-only review of Qt6 C++ code that combines a deterministic lint script with six parallel analysis agents and reports only high-confidence issues.

    1.1k GitHub starsUsed in 2 repos~4.3k tokens
    DevelopmentAuto-check passed
  • Adversarial Reviewer

    302ai/302-AI-Studio

    Adversarial code review that breaks the self-review monoculture.

    132 GitHub starsUsed in 1 repo~3k tokens
    DevelopmentAuto-check passed
  • Feature-Level Code Review

    dataelement/bisheng

    Runs a seven-dimension code review on a finished feature, comparing the diff against a base branch and the feature's spec, design and task files.

    12k GitHub stars~1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Two-Axis Code Review

    rengwu/wayfinder-maps

    Reviews the changes since a commit, branch or tag along two separate axes: the repo's documented coding standards and fidelity to the originating spec or PRD.

    137 GitHub stars~1.8k tokensUpdated 5 days ago
    DevelopmentAuto-check passed
  • Code Reviewer

    alirezarezvani/claude-code-tresor

    Automatic code quality and best practices analysis. An agent skill from alirezarezvani/claude-code-tresor.

    777 GitHub stars~1.8k tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • Code Reviewer

    MageByte-Zero/spec-superflow

    Review completed implementation batches for spec compliance and code quality.

    846 GitHub starsUsed in 1 repo~1.5k tokens
    DevelopmentAuto-check passed

More from fynnfluegge/agtx

  • Runs a whole project unattended on an agtx kanban board, decomposing the goal, starting tasks, unblocking workers and merging each result.

    1.7k GitHub stars~3.8k tokensUpdated 9 days ago
    Auto-check passed
  • Agtx Task Sweep

    fynnfluegge/agtx

    Breaks a conversation's results into feature-level tasks and pushes them to the agtx kanban board, where each task gets its own worktree and agent session.

    1.7k GitHub stars~1.7k tokensUpdated 9 days ago
    Auto-check passed
  • agtx Execute Phase

    fynnfluegge/agtx

    Carries out an approved plan for an agtx-managed task: implements the changes, runs tests, commits, writes a summary to .agtx/execute.md and then stops.

    1.7k GitHub stars~439 tokensUpdated 9 days ago
    Auto-check passed
  • agtx Task Planning

    fynnfluegge/agtx

    Analyzes the codebase for an agtx task, writes a plan with analysis, steps and risks to .agtx/plan.md, then stops and waits for approval before any change.

    1.7k GitHub stars~439 tokensUpdated 9 days ago
    Auto-check passed
  • Agtx Research

    fynnfluegge/agtx

    Explore the codebase to understand a task before planning. An agent skill from fynnfluegge/agtx.

    1.7k GitHub stars~399 tokensUpdated 9 days ago
    Auto-check passed
  • Agtx Brainstorm Mode

    fynnfluegge/agtx

    Puts the agent in a discussion-only mode for exploring a feature idea, asking questions and probing trade-offs without planning or writing code.

    1.7k GitHub stars~497 tokensUpdated 9 days ago
    Auto-check passed

Works with

Categories

Questions about agtx Review Phase

What does agtx Review Phase do?

Self-reviews completed work in an agtx-managed task for correctness, edge cases and code quality, fixes issues, commits and writes .agtx/review.md with a status. This skill runs the review phase of an agtx-managed task.agtx/reviewed-at exists, it reviews only changes since that commit and checks that the points in the previous review were addressed.

When should I use agtx Review Phase?

agtx Review Phase fits situations like: finishing an agtx task and reviewing it before merge; re-reviewing only the new commits after a first review; producing a READY or NEEDS_WORK verdict file for a task.

How do I install agtx Review Phase in Claude Code?

Run `npx skills add fynnfluegge/agtx --skill agtx-review -a claude-code`. Or copy the skill folder (plugins/agtx-terse/skills/agtx-review in fynnfluegge/agtx) into .claude/skills/agtx-review in your project. Claude Code loads it when a task matches its description.

How do I install agtx Review Phase in Codex?

Run `npx skills add fynnfluegge/agtx --skill agtx-review -a codex`. Or copy the skill folder (plugins/agtx-terse/skills/agtx-review in fynnfluegge/agtx) into .agents/skills/agtx-review in your project. Codex loads it when a task matches its description.

Can I use agtx Review Phase 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 fynnfluegge/agtx --skill agtx-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/agtx-review, .gemini/skills/agtx-review, .github/skills/agtx-review and .opencode/skills/agtx-review in your project.

What does agtx Review Phase need to run?

Going by SKILL.md and its folder, agtx Review Phase needs the command-line tools its instructions call (git). Our summary lists: An agtx-managed task with a git working tree.

Does agtx Review Phase access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is agtx Review Phase 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. Review the folder before installing.

What licence does agtx Review Phase use?

agtx Review Phase is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does agtx Review Phase use?

About 475 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to agtx Review Phase?

Skills that share tags, products or a category with agtx Review Phase: Qt C++ Code Review (x-tools-author/x-tools, 1.1k stars), Adversarial Reviewer (302ai/302-AI-Studio, 132 stars), Feature-Level Code Review (dataelement/bisheng, 12k stars) and Two-Axis Code Review (rengwu/wayfinder-maps, 137 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains agtx Review Phase?

fynnfluegge (a GitHub user) maintains it in fynnfluegge/agtx, which has 1,713 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 2, 2026.

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