Quality Fundamentals
Coordinates quality work across ESLint, SonarQube, dead-code cleanup, and technical debt so agents can choose the right quality primitive for the codebase and the risk profile.
SKILL.mdskills/quality/fundamentals/SKILL.md
GitHubQuality Fundamentals
Purpose
Use this skill to coordinate quality work across ESLint, SonarQube, dead-code cleanup, and technical debt.
This is a mother skill. It does not replace specialized quality skills. It tells an agent which quality primitive to use, in what order to apply it, and when the work should stay as a debt hop instead of becoming a broad refactor.
The core rule is simple:
Pick the quality primitive that matches the risk, the codebase, and the scope of the hop.
When to Use
Use this skill when:
- a team needs a quality improvement path
- lint, Sonar, and debt cleanup need coordination
- a review needs to stay small and measurable
- a cleanup pass should be sequenced instead of mixed
Do
Use a sequencing policy:
lint baseline -> disable governance -> safe autofix -> dead-code cleanup -> Sonar triage -> debt ledger
Keep the specialist skills separate:
eslint -> rules, disables, and safe autofix
no-dead-code -> dead exports, orphan files, dead branches
sonarqube -> gate triage, complexity, duplication, coverage
technical-debt -> hop-based debt tracking
Use runtime variants only when the guidance changes materially.
Do Not
Avoid turning the mother skill into implementation guidance.
Avoid mixing lint, dead code, Sonar, and debt cleanup without a policy.
Avoid using this skill to replace the specialized skills.
Review Checklist
- The team has a sequencing policy.
- Specialized skills remain separate.
- The cleanup hop stays bounded.
- The adoption path matches team maturity.
- The skill is used as routing and coordination, not implementation detail.
Expected Output
- Recommend the right quality primitive sequence.
- Route to the specialized skills.
- Keep the scope at architecture and cleanup-path level.
- Preserve the debt ledger.
- Summarize the quality improvement plan.