Design Audit

Trust Score 91/100

Audit code architecture and maintainability to find unnecessary complexity, misplaced abstractions, duplication, and high-impact refactoring opportunities.

triggers:design auditarchitecture reviewrefactor suggestionsabstraction problemsduplication detection

GitHub SKILL.md

What it does

Design Audit reviews codebases for architectural and structural problems that make working with the code expensive or risky. The skill focuses on maintainability: premature or missing abstractions, duplication, unclear module boundaries, circular dependencies, and other structural smells. It walks representative call sites and modules rather than guessing from filenames, and it prioritizes findings by maintenance impact and confidence. When invoked with an --accept flag it can apply high-confidence, behavior-preserving refactors and run available tests before committing.

When to use it

Use Design Audit when you need a focused, higher-level review of a codebase or a specific path to surface refactoring opportunities and concrete repair plans. Good for onboarding, pre-release reviews, or when a code area is becoming brittle. Do not use it for bug fixes, security audits, or style-only issues. If you want runnable quick fixes, include --accept.

What's included

Scripts: none bundled (has_scripts=false)
References: none bundled (has_references=false)
Instructions: step-by-step workflow for scoping the audit, mapping module boundaries, reading representative code, classifying findings by impact, and recommending concrete refactors. Guidance on when to implement refactors automatically and when to leave design recommendations.

Compatible agents

Compatible with code-focused agents that can read repositories and run tests (e.g., Codex/Copilot-style or code-execution-capable assistants).

Audit Summary

Design audit skill for reviewing code architecture and maintainability. No bundled scripts — pure prompt-based skill with detailed instructions on identifying abstraction problems, complexity, structural issues, and duplication. Well-structured SKILL.md with clear workflow, specific findings taxonomy, and explicit scoping (what not to flag). Useful for code review but not unique in this space.

Watch Out

--accept flag auto-commits refactors without confirmation — users should review changes first

Notes

Clean, instruction-only skill with no scripts or security concerns. The --accept auto-commit behavior is well-documented and gated behind an explicit flag, so not a real risk. SkilL.md is thorough and well-organized.

Information

Repository: dotfiles
Stars: 8

Trust Score

Overall91

Security98

Code Quality87

Architecture80

Usefulness72

More from dotfiles

Finances — Bank Statement Import & Reconciliation

Import CSV bank statements (Wise, Mercado Pago), parse and deduplicate transactions, auto-categorize with a guide, create a staging ledger file, and reconcile i

Related Skills

Run Execute

Orchestrates execution of work items across modes (autopilot, confirm, validate) with scripted init/complete tooling, plan/test/report artifacts and strict gati

OpenTestAI

Automated, high-confidence AI testing: bug detection, persona feedback, and prioritized test-case generation using many specialized tester profiles.

Codex Collab

Bridge Claude and Codex to run tasks, perform code reviews, and run background jobs for research or implementation workflows.

Minimal Run & Audit (repro reporting)

Execute a README-first smoke test and produce standardized reproducibility outputs (`repro_outputs/`) and PATCHES.md — trusted reporting for repo reproduction r

Skill Issue — Skill Auditor

Scan and audit installed agent skills to produce a health report covering inventory, usage, dependency checks, version status, and actionable recommendations.

GRC & Compliance (ServiceNow)

Guides Governance, Risk & Compliance (GRC) work in ServiceNow: policies, controls, risk records, audits and ES5 script examples for automating GRC workflows.

BK-CI Design Patterns Guide

Practical guide to design patterns used in the BK-CI project (Kotlin/Spring). Covers factory, strategy, singleton, decorator, observer, template method, chain-o

Node.js Best Practices

Guidelines and decision-making for Node.js architecture, runtime, async patterns, security, validation, and testing to inform framework and system choices.

Back to Skills