bug-scrub

Aggregate testing, linting, and security results into prioritized markdown and JSON reports.

4|1|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/jankneumann/agentic-coding-tools --skill bug-scrub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bug-scrub
Source: https://github.com/jankneumann/agentic-coding-tools/tree/main/.agents/skills/bug-scrub
Command: npx skills add https://github.com/jankneumann/agentic-coding-tools --skill bug-scrub

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It provides a read‑only diagnostic that aggregates signals from testing, linting, type checking, specification validation, architecture analysis, security scans, deferred issues, and code markers to give a unified view of project health, helping teams prioritize remediation before problems grow.

Core Features & Use Cases

  • Multi‑source aggregation: Collects findings from pytest, ruff, mypy, OpenSpec validation, architecture diagnostics, security reports, deferred tasks, and code markers.
  • Prioritized reporting: Ranks findings by severity and age, groups nearby issues, and generates actionable recommendations.
  • Decision support: Produces both markdown and JSON reports that can be fed into /fix-scrub for automated or assisted fixes.

Quick Start

Run the bug‑scrub skill with default options to generate a health report for the current project.

Frequently Asked Questions about bug-scrub

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

FAQPage Schema
How do I aggregate linting, type checking, and security scan results into one project health report?

Aggregating project health signals involves running a read-only diagnostic that collects findings from testing, linting, type checking, and security scans to produce a unified, prioritized markdown and JSON report. This process helps teams identify critical issues across the codebase without manually reviewing each tool's output separately.

What is a code health diagnostic and when do I need to run one?

A code health diagnostic is a read-only process that detects and aggregates signals from testing, linting, security scans, and code markers to provide a unified view of project status. You need to run one when you want to prioritize remediation before accumulated issues grow into larger problems.

Can I use automated diagnostic reports for automated fixes in my CI pipeline?

Yes, automated diagnostic reports can be used for automated fixes because the diagnostic process generates both markdown and JSON outputs. The JSON format is specifically structured to be fed into fixing tools to apply the prioritized remediations automatically.

Does the project health diagnostic modify my source files during analysis?

No, the project health diagnostic does not modify your source files during analysis. The process runs Python scripts that parse tool outputs and generate markdown and JSON reports in a strictly read-only manner, ensuring your codebase remains untouched while surfacing health signals.

What's the best way to prioritize deferred issues and architecture diagnostics for remediation?

The best way to prioritize deferred issues and architecture diagnostics is to use a reporting tool that ranks findings by severity and age, groups nearby issues, and generates actionable recommendations. This provides a prioritized list of tasks based on aggregated health signals.