stark-review-improvement

Applies targeted edits to code review prompts and orchestrator based on assessment findings.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/21StarkCom/stark-skills --skill stark-review-improvement-21starkcom
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: stark-review-improvement
Source: https://github.com/21StarkCom/stark-skills/tree/main/runtime-overrides/codex/skill/stark-review-improvement
Command: npx skills add https://github.com/21StarkCom/stark-skills --skill stark-review-improvement-21starkcom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After running automated PR reviews, you may find that review agents produce false positives, miss real issues, or review files outside the PR diff. This Skill closes that feedback loop by turning a Prompt Improvement Assessment into concrete, validated edits to review prompts, the TypeScript orchestrator, or review configuration. ## Core Features & Use Cases - Assessment-driven prompt edits: Parses a Prompt Improvement Assessment into classified action items (prompt-edit, orchestrator-edit, config-edit, no-action) and applies minimal, targeted changes to prompts in global/prompts/{claude,codex,gemini}/. - Orchestrator and config fixes: Makes surgical edits to tools/stark_review.ts (with tests for logic changes) and adds backward-compatible config fields like disabled_paths or severity_overrides. - Validation and changelog: Runs syntax checks, focused tests, and JSON validation, then records every change in a prompt changelog with source, reason, and validation status. - Use Case: After a review run flags v2 concerns as v1 issues, use this Skill to add a scope calibration instruction to the relevant domain prompt, validate the change, and log it — committing only when you explicitly approve the diff. ## Quick Start Ask the assistant to run stark-review-improvement on the prompt improvement assessment from your latest review to fix the noisy review prompts.

Frequently Asked Questions about stark-review-improvement

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

FAQPage Schema
How do I fix false positives from automated PR code review?▼

Run this Skill with the Prompt Improvement Assessment from the noisy review. It parses each recommendation, applies minimal edits to the relevant domain prompt or agent.md file, validates the changes, and shows you a diff before any commit.

How do I stop a review agent from reviewing files outside the PR diff?▼

The Skill edits the agent.md file's context section, replacing hardcoded base refs with a placeholder and adding an instruction to only review files in the diff output. This is classified as a prompt-edit action item.

Does this Skill commit changes automatically?▼

No. It always shows the full diff first and commits only when you pass --commit or explicitly approve after seeing the diff. It stages only the files it edited and never pushes unless separately requested.

Can it change the review orchestrator code, not just prompts?▼

Yes. Orchestrator-edit actions make surgical changes to tools/stark_review.ts, such as fixing how the base ref is passed to agents or correcting finding classification. Logic changes require accompanying tests, and backward compatibility is preserved.

What happens if no assessment is available in the conversation?▼

The Skill asks you for an assessment or receipt path and stops. It does not crawl history directories or guess the latest assessment, since that could pick artifacts from a different repository or review.