holistic-linting

Orchestrate Ruff, Mypy, and Bandit linting with reports in .claude/reports.

3|1|Updated May 31, 2018
One-click install
npx skills add https://github.com/bitflight-public/terraform-aws-lambda-slack-bot --skill holistic-linting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: holistic-linting
Source: https://github.com/bitflight-public/terraform-aws-lambda-slack-bot/tree/main/.claude/skills/holistic-linting
Command: npx skills add https://github.com/bitflight-public/terraform-aws-lambda-slack-bot --skill holistic-linting

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill ensures code quality by orchestrating comprehensive linting and formatting workflows, preventing silent quality gaps in codebases.

Core Features & Use Cases

  • Orchestrator workflow: delegates formatting, linting, and resolution to a dedicated linting agent and aggregates results.
  • Sub-Agents workflow: lint touched files before task completion to prevent regressions.
  • Knowledge base integration: references Ruff, Mypy, and Bandit rules and documentation to guide fixes.
  • CLAUDE.md integration: reads project linting configuration from CLAUDE.md and discovers the active toolchain.
  • Reports and artifacts: stores resolution reports in .claude/reports for traceability.

Quick Start

Instantiate the holistic-linting workflow to automatically format, lint, and resolve issues for modified files by delegating to the linting-root-cause-resolver and reviewing reports.

Frequently Asked Questions about holistic-linting

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

FAQPage Schema
How do I automate code linting and formatting for multiple Python tools?

Automate code linting by orchestrating Ruff, Mypy, and Bandit to format, lint, and resolve issues for modified files. It delegates tasks to a root-cause resolver and consolidates results in .claude/reports.

How does CLAUDE.md based linting configuration discovery work?

CLAUDE.md based linting configuration reads project rules from the CLAUDE.md file to discover the active toolchain. This guides how formatting, type-checking, and security fixes are applied.

What's the best way to prevent linting regressions in sub-agent workflows?

Prevent linting regressions by integrating automated linting into sub-agent workflows. The skill automatically lints touched files before task completion, ensuring code quality is maintained without manual intervention.

Can I use Ruff and Mypy together in an automated code quality workflow?

Yes, you can use Ruff and Mypy together alongside Bandit in an automated code quality workflow. The skill orchestrates these tools to handle formatting, type checking, and security analysis comprehensively.

Where are automated linting resolution reports stored for traceability?

Automated linting resolution reports are stored in the .claude/reports directory. This ensures traceability for all formatting, type-checking, and security fixes applied during the orchestrator workflow.

Do I need a dedicated linting agent to resolve root causes found by Bandit and Ruff?

The skill delegates root cause resolution to a dedicated linting agent called linting-root-cause-resolver. This agent handles fixing issues found by Ruff, Mypy, and Bandit, consolidating results for review.