best-practices-reviewer

Enforce Claude Code best-practices compliance during implementation processes.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/884js/agent-skills --skill best-practices-reviewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: best-practices-reviewer
Source: https://github.com/884js/agent-skills/tree/main/skills/best-practices-reviewer
Command: npx skills add https://github.com/884js/agent-skills --skill best-practices-reviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures Claude Code's best-practices are followed during implementation and prompts for questions or improvements when deviations are detected.

Core Features & Use Cases

  • Verification of practices: checks for validation steps, testing, and clear improvement suggestions before changes.
  • Plan-before-implement discipline: ensures exploration, planning, and cautious implementation for large or cross-file changes.
  • Prompt specificity and context hygiene: requests concrete targets and maintains clean context across long sessions.
  • Sub-agent guidance: recommends using sub-agents to scope investigations without polluting the main context.
  • Iteration guardrails: detects repeated fixes and suggests context reset when needed.

Quick Start

Begin a best-practices review of the current implementation and surface concrete improvement questions.

Frequently Asked Questions about best-practices-reviewer

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

FAQPage Schema
How do I enforce best-practices compliance during code implementation?

To enforce best-practices compliance, you need a process that verifies validation steps, checks for testing, and prompts clarifying questions when evaluation criteria are missing. This ensures plans precede major changes and guides corrective actions.

What is the best way to maintain context hygiene across long-running development sessions?

Maintaining context hygiene requires requesting concrete targets, recommending sub-agents to scope investigations without polluting the main context, and suggesting context resets when repeated fixes are detected across long-running sessions.

How do I ensure a plan precedes large or cross-file code changes?

To ensure a plan precedes large or cross-file code changes, implement a plan-before-implement discipline that mandates exploration, planning, and cautious implementation before any major modifications are applied.

Why does my coding session need iteration guardrails for repeated fixes?

Iteration guardrails are needed to detect repeated fixes during development. When repeated fixes occur, the guardrails suggest a context reset to prevent context pollution and restore effective implementation.

Can I use sub-agents to scope investigations without polluting the main context?

Yes, you can use sub-agents to scope investigations without polluting the main context. Sub-agent guidance ensures exploratory actions remain isolated, preserving context hygiene across the implementation process.

When should I prompt for clarifying questions during a code review?

You should prompt for clarifying questions during a code review when evaluation criteria are missing. This surfaces concrete improvement questions and guides the user toward corrective actions before changes are finalized.