quality-analysis

Run Python linting, type checks, naming, and dead-code detection with reports.

3|Updated Nov 7, 2025
One-click install
npx skills add https://github.com/xiaden/nomarr --skill quality-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quality-analysis
Source: https://github.com/xiaden/nomarr/tree/main/.github/skills/quality-analysis
Command: npx skills add https://github.com/xiaden/nomarr --skill quality-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Automates and standardizes code quality checks across a codebase, surfacing violations early to reduce defects and maintenance costs.

Core Features & Use Cases

  • Automated QC Runs: Runs linting (ruff), type checks (mypy), naming convention checks, and dead-code detection across Python projects.
  • Quality Health Reports: Generates concise reports (text/JSON) with hotspots and remediation suggestions.
  • Pre-commit & CI Readiness: Easily wired into pre-commit hooks or CI pipelines to enforce quality gates.

Quick Start

Run the QC workflow on your project by executing the main QC script: python scripts/run_qc.py. After running, review the generated qc_reports directory for the timestamped qc_report file.

Frequently Asked Questions about quality-analysis

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

FAQPage Schema
How do I automate Python code quality checks for linting and dead code detection?

Automate Python code quality checks by running the main QC script, which executes linting, type checks, naming conventions, and dead-code detection. It generates a timestamped qc_report in the qc_reports directory.

What is static analysis for codebase health and how does it surface violations?

Static analysis for codebase health evaluates code without executing it to surface violations early. This process applies linting, typing, naming, and dead-code checks to reduce defects and maintenance costs.

Can I wire Python linting and type checks into pre-commit hooks or CI pipelines?

Yes, you can wire Python linting and type checks into pre-commit hooks or CI pipelines. The automated QC workflow is designed for CI readiness to enforce quality gates across development cycles.

What's the best way to find legacy code and dead nodes in a Python project?

The best way to find legacy code and dead nodes is using dedicated detection scripts like detect_slop.py, check_dead_nodes.py, and find_legacy.py. These identify unused code and generate remediation suggestions.

Does this code quality reporting tool support outputting quality health reports in JSON?

Yes, this code quality reporting tool supports outputting concise quality health reports in both text and JSON formats. These reports include identified hotspots and actionable remediation suggestions.

What are the limitations of running automated QC scripts on a Python codebase?

Limitations of running automated QC scripts include being restricted to Python projects and relying on specific tools like ruff for linting and mypy for type checks to evaluate codebase health.