🔍Skill only

Repo lint report

Pure skill that reviews git diff for security, performance, and style. No MCP needed.

Surfaces
skill
Complexity
beginner
Trigger
natural
Est. tokens
3,500
Source repo

What It Does

A pure-skill review of the current git diff. No MCP, no subagents, no hooks. Claude runs git commands directly and classifies each hunk into security, performance, or style categories, then prints a grouped report with file:line citations.

When It Triggers

  • "Lint this diff"
  • "Review my PR before I open it"
  • "Check this change for issues"

SKILL.md

markdown
---
name: repo-lint-report
description: Reviews the current git diff and reports style, security, and performance issues with file:line citations. Use when user says "lint this", "review my diff", or "check this PR for issues".
---

# Repo Lint Report

## When to Use
- User asks to lint, review, or audit a git diff
- After a multi-file change, before opening a PR

## Steps
1. Run `git diff --cached` to inspect staged changes
2. For each hunk, classify issues:
   - Security (injection, missing auth, secret leaks)
   - Performance (N+1 queries, missing indexes, sync I/O in async)
   - Style (naming, dead code, comments)
3. Produce a grouped report: file:line — severity — suggested fix
4. Finish with a one-line verdict (ship / fix-first / block)

Why This Shape

The three classification buckets (security, performance, style) match real review priorities. The final one-line verdict (ship / fix-first / block) gives the user a clear next action instead of a wall of text.

Gotchas

  • Works best on diffs under 500 lines — larger diffs should go through parallel-code-audit with subagents.
  • "Security" classifications need the project's threat model to avoid noise on low-risk code.
  • Claude's findings are suggestions, not gates — keep a human reviewer on high-stakes code paths.

Before you continue

We use analytics cookies to understand how the documentation is used and improve the experience. Privacy Policy.