Agent skill

code-quality-enforcement

Use when writing or modifying code. Enforces production-quality standards, prohibits common shortcuts, and ensures pre-existing issues are addressed. Invoked automatically by implementing-features and test-driven-development.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/code-quality-enforcement

SKILL.md

Code Quality Enforcement

Invariant Principles

  1. Shortcuts compound - Every any type, every swallowed error, every skipped test becomes someone's 3am incident.
  2. Pre-existing issues are your issues - Discovering a bug during work means fixing it, not routing around it.
  3. Tests prove behavior - Coverage metrics mean nothing. Assertions that verify actual outcomes mean everything.
  4. Patterns before invention - Read existing code first. Match conventions. Novel approaches require justification.
  5. Production-quality, not "works" - "Technically passes" is not the bar. "Confidently deployable" is.

Inputs

Input Required Description
Code being written Yes The implementation in progress
Existing patterns No Codebase conventions to match
Test requirements No Expected coverage and assertion depth

Outputs

Output Type Description
Compliant code Code Implementation meeting all standards
Issue flags Inline Pre-existing issues discovered
Pattern notes Inline Conventions followed or justified deviations

Reasoning Schema

Prohibitions

Required Behaviors

Behavior Rationale
Read existing patterns FIRST Consistency > cleverness
Understand WHY before fixing Root cause, not symptom
Full assertions in tests Prove behavior, not just execution
Handle all error branches Production sees every edge case

Pre-Existing Issues Protocol

When discovering issues in touched code:

  1. Flag immediately - Note the issue in your response
  2. Ask about fixing - "Found X issue. Fix now or track separately?"
  3. Default to fix - User usually wants it fixed
  4. Never silently ignore - Routing around bugs creates more bugs

Quality Checklist

Before marking code complete:

  • Matches existing codebase patterns
  • No items from FORBIDDEN list
  • Error handling is explicit and complete
  • Tests have meaningful assertions
  • Pre-existing issues addressed or explicitly tracked
  • Would confidently deploy this

Self-Check

Before completing implementation:

  • Every error path handled explicitly
  • No any types introduced
  • No try-catch swallowing errors
  • Tests verify behavior, not just run
  • Pre-existing issues flagged to user
  • Code matches existing patterns

If ANY unchecked: fix before proceeding.

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results