ar-self-reviewer

Reviews Agentic Repos framework PRs for project-specific noise leaking into generic artifacts.

1|2|Updated Jul 11, 2026
One-click install
npx skills add https://github.com/mahsanamin/agentic-repos --skill ar-self-reviewer-mahsanamin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ar-self-reviewer
Source: https://github.com/mahsanamin/agentic-repos/tree/main/.claude/commands/ar-self-reviewer
Command: npx skills add https://github.com/mahsanamin/agentic-repos --skill ar-self-reviewer-mahsanamin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? The Agentic Repos framework ships to every consuming team, so a change that smuggles one project's identity (real names, packages, developer paths, ticket ids, business-domain examples) into installed artifacts pollutes every install. Existing lints only catch stack idioms and rationale bloat, leaving business/project noise undetected. This gate reviews a framework PR and proves it introduces zero project-based noise before merge. ## Core Features & Use Cases - Project-noise detection: Combines mechanical lints (generic-skill-lint.sh, project-noise-lint.sh) with a judgment pass to catch real project names, packages, dev paths, tickets, emails, dated incident notes, and ungenericized business-domain examples. - Whole-file project-binding checks: Flags files whose name or dominant content binds the framework to one project (e.g. a <project>-feedback.md doc in docs/), recommending removal or relocation. - Structured PR review output: Classifies findings by type (PROJECT_NOISE, UNGENERICIZED_EXAMPLE, MISTIERED_RULE, VERSION_INCONSISTENCY, etc.) and severity, then posts them as a batch GitHub review in location-first comment format after user approval. - Use Case: After ar-add-improvement opens a framework PR, run this gate to self-review the diff, confirm no source-project identity leaked into rules/, skills/, agents/, templates/, setup.md, or docs/, and post actionable inline comments before merging. ## Quick Start Ask the assistant to run ar-self-reviewer on a specific agentic-repos PR number or URL to check it for project-based noise before merging.

Frequently Asked Questions about ar-self-reviewer

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

FAQPage Schema
How do I review a framework PR for project-specific noise?▼

Run ar-self-reviewer with the PR number or URL of a mahsanamin/agentic-repos pull request. It fetches the PR into a review worktree, runs lint scripts plus a judgment pass over the changed artifacts, and shows a draft findings table before posting any comments.

What kinds of project noise does this review gate catch?▼

It catches real project names, literal packages, absolute developer paths, ticket ids, emails, commit SHAs, dated incident notes, ungenericized business-domain examples, whole files bound to one project, rationale bloat, mis-tiered rules, and version-file drift.

Can I use ar-self-reviewer on a target-project pull request?▼

No. It reviews agentic-repos framework PRs only and refuses PRs from any other repository, since a target project is supposed to contain its own names. For target-project PRs it redirects you to a_sk_review_pr or ar-global-pr-reviewer.

Does the skill post review comments automatically?▼

No. It always shows a draft table of findings first and posts only after you choose which comments to publish. Posting happens as a single batch GitHub review so only one notification is sent.

What happens if no framework PR exists yet?▼

A pre-PR fallback scans the local branch diff from the working tree using git diff main...HEAD. The procedure is identical, but findings are printed locally instead of being posted to a pull request.

Why does the gate need a judgment pass in addition to lint scripts?▼

Regex-based lints cannot detect domain-shaped leakage like example names revealing a business domain, or mis-tiered rules in universal directories. The judgment pass adjudicates lint candidates and reads changed files cold to find what the lints miss.