code-tidy

Format, lint, and clean up recent code changes using the tidy tool and structural rules.

6|Updated Jun 25, 2026
One-click install
npx skills add https://github.com/tribgames/mixdog --skill code-tidy-tribgames
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: code-tidy
Source: https://github.com/tribgames/mixdog/tree/main/src/defaults/skills/code-tidy
Command: npx skills add https://github.com/tribgames/mixdog --skill code-tidy-tribgames

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Recent code changes often accumulate formatting inconsistencies, lint violations, dead code, and AI-generated slop that degrade maintainability. This Skill runs a layered cleanup pass over your recent changes while strictly preserving behavior and public APIs. ## Core Features & Use Cases - Deterministic formatting and linting: Runs the project's existing formatters and linters (Biome, Prettier, rustfmt, gofmt, and more) through the tidy tool, then applies structural rule packs, all scoped to your recent diff. - Agent-level cleanup: Applies a deletion ladder and four review lenses (reuse, quality, efficiency, altitude) to remove dead code, duplication, over-defensive checks, and needless complexity, with findings tiered by risk (SAFE, CAREFUL, RISKY). - Use Case: After finishing a feature branch, ask the agent to tidy your changes. It formats and lints the modified files, removes unused imports and dead helpers, flags risky structural issues for review, and reports test and typecheck results. ## Quick Start Tidy up my recent uncommitted changes, formatting and linting them and removing any dead code without changing behavior.

Frequently Asked Questions about code-tidy

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

FAQPage Schema
How do I clean up recent code changes without changing behavior?▼

Run the tidy workflow on your recent diff: it applies the project's formatters and linters first, then structural rules, then an agent-level pass that removes dead code and slop. Every layer preserves behavior and public APIs, with tests run after each apply step.

How do I remove dead code safely from a codebase?▼

Dead code removal follows a verification procedure: scanner reports are treated as candidates, then each symbol is checked for zero references, grep hits in strings and templates, and a never-dead list covering entry points, public APIs, and registry tables. Removals proceed in tiers with tests after each batch.

Which formatters and linters does the tidy tool support?▼

The tidy tool detects project engines such as Biome, Prettier, clang-format, rustfmt, and gofmt via a scan action that reports used and missing engines. It never invents a formatter config; projects keep their existing configuration files.

Can I run a cleanup pass in report-only mode?▼

Yes. Asking to check, review, or just report keeps every layer in dry-run mode, and the final report lists what would change without applying edits. An explicit focus such as dead code only or efficiency restricts the agent layer to that lens.

What happens if tests fail after a cleanup edit is applied?▼

The failing change is reverted and the next layer does not start until the baseline is green again. CAREFUL-tier edits are applied one file at a time with tests after each file, reverting that file on failure, and three failed attempts on one file stop the run with an escalation report.