neuro-audit

Audits codebases against project CLAUDE.md rules and generates prioritized violation reports.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/webdevarif/claude-skills --skill neuro-audit-webdevarif
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: neuro-audit
Source: https://github.com/webdevarif/claude-skills/tree/main/neuro-audit
Command: npx skills add https://github.com/webdevarif/claude-skills --skill neuro-audit-webdevarif

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams define coding standards in CLAUDE.md but have no systematic way to verify the codebase actually follows them, leading to rule drift and inconsistent code across files. ## Core Features & Use Cases - Rule Extraction: Reads the project's CLAUDE.md and converts every rule, constraint, and pattern into a numbered checklist. - Violation Scanning: Scans every .tsx/.ts/.jsx/.js file for violations, reporting exact file paths, line numbers, offending code, and the correct fix. - Prioritized Reports: Generates a Markdown audit report grouping violations by category and priority (P1 functionality risk, P2 inconsistency, P3 polish) with an actionable fix plan. - Use Case: Run a full audit on a React project to find every component that violates the styling or data-fetching rules defined in CLAUDE.md, then execute the fixes in priority order. ## Quick Start Ask the assistant to run a full project audit against the rules in CLAUDE.md and list all violations with fixes.

Frequently Asked Questions about neuro-audit

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

FAQPage Schema
How do I audit my codebase against CLAUDE.md rules?

Run the audit command and the skill reads your project's CLAUDE.md, extracts every rule into a checklist, then scans all .tsx, .ts, .jsx, and .js files for violations. The output is a prioritized report with exact file paths, line numbers, and fixes.

How do I audit only one folder instead of the whole project?

Pass the folder path as an argument, such as src/components or app/dashboard. The audit then limits its violation scan to files inside that directory while still using the full CLAUDE.md rule set.

Does this code audit work with frameworks other than React?

Yes, it works with any project because all rules come from the project's own CLAUDE.md rather than hardcoded assumptions. React, Vue, Svelte, Node, and PHP projects are all supported as long as a CLAUDE.md exists.

What happens if my project has no CLAUDE.md file?

The audit stops and tells you no CLAUDE.md was found, asking you to create one with your project rules first. It does not guess or assume rules, since CLAUDE.md is the only source of truth.

Can the audit automatically fix the violations it finds?

Yes, running with the fix flag audits and then repairs all violations. It works through the fix plan in priority order, marks each task done, and re-audits to verify the corrections.