agentleFS
TylerAkinsTylerAkins/ai-agent-skills/skills/review-lense/SKILL.md

review-lense

Skill1 starsChanged 33 days agoMITView on GitHub

Predict what a named reviewer may flag from their feedback in a specific repository. Use for reviewer-specific pre-review or preference analysis. Separate historical preferences from verified defects; do not replace correctness review or imply the reviewer will approve.

The file

We split this skill into the rules it gives an agent

8 rules. About 0 are common, 8 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈8

    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:

    Read anti-ai-writing before drafting feedback.

    line 12
  2. Distinctive:

    Use this skill to anticipate feedback, not impersonate a reviewer or change technical judgment to match their tastes.

    line 13
  3. Distinctive:

    Read collection and profile guidance before fetching or updating history.

    line 19
  4. Distinctive:

    Default to a bounded sample targeting 25 PRs with substantive feedback, searching up to 120 candidates unless the user specifies another …

    line 24
  5. Distinctive:

    Test each plausible prediction against the current diff, surrounding code, and actual consumers.

    line 36
  6. Distinctive:

    Keep the profile scope, freshness, and material gaps concise.

    line 50
  7. Distinctive:

    If no supported predictions remain, say so without implying a clean correctness review.

    line 52
  8. Distinctive:

    Keep profiles in workspace scratch or a user-selected cache outside installed packages.

    line 61

≈ “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

Reviewer Preferences

Read anti-ai-writing before drafting feedback. Use this skill to anticipate feedback, not impersonate a reviewer or change technical judgment to match their tastes. Preserve the supplied reviewer handle and resolve the repository and candidate/base. Ask for a missing handle rather than guessing.

1. Collect repository-specific evidence

Read collection and profile guidance before fetching or updating history. Use available GitHub tools or CLI with verified schemas and explicit repository/reviewer scope. Do not depend on scripts from another installed skill. With no access, use supplied evidence and disclose the reduced scope.

Default to a bounded sample targeting 25 PRs with substantive feedback, searching up to 120 candidates unless the user specifies another budget. Count distinct PRs and comments separately; boilerplate approvals do not establish a preference. Report actual sample size, search coverage, and stop reason. An underfilled sample can still inform a tentative prediction, but it is not complete history.

2. Derive and test predictions

  1. Cluster historical feedback by technical concern and triggering conditions, not wording. Read thread replies, historical code, and outcomes. Distinguish recurring preferences, one-off concerns, and explicit scoped waivers. A resolved thread or merged PR does not show by itself that the reviewer withdrew or accepted a concern.
  2. Test each plausible prediction against the current diff, surrounding code, and actual consumers. Verify technical validity using the finding bar and rubric in code-review. Drop disproven concerns; label unverified concerns as questions. Do not suppress defects absent from the reviewer's history.
  3. Record two separate judgments: historical support that this reviewer may comment, and current evidence that the code has a defect. Use qualitative support such as repeated, single-example, or tentative. Recurrence is not a calibrated probability of correctness or a future comment. Do not promise approval or treat silence as a waiver.

3. Report and apply only requested fixes

Lead with the few predictions that matter. For each, give the current location and trigger, likely concern, linked precedent, current validity, and a justified action. Keep the profile scope, freshness, and material gaps concise. Do not invent a finding count, pad the report with generic advice, or reproduce a reviewer's voice. If no supported predictions remain, say so without implying a clean correctness review.

Remain read-only for prediction requests and --no-fix. Treat --refresh as a request to rebuild the profile, not permission to edit code. When bounded fixes are explicitly requested, change only supported issues within that scope. Assess behavior and risk even for renames, logging, and type changes; run affected checks and obtain independent review for material repairs when authorized and available. Disclose unavailable review rather than labeling self-review independent.

Keep profiles in workspace scratch or a user-selected cache outside installed packages. Do not commit, push, contact reviewers, or publish from this skill.

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.