CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

simplify-codebase

Simplification audit or authorized codebase simplification whose stated objective is to remove accidental complexity. Use for evidence-backed deletion or consolidation of dead code, duplicate state, redundant APIs or layers, ownerless abstractions, obsolete compatibility or design records, and over-engineering in any language; also use for 代码简化 or 熵回收. Do not use for general code review, onboarding, style-only refactoring, or performance tuning.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exceptionally disciplined skill body: lean, well-sequenced, with strong conditional progressive disclosure and validation checkpoints throughout. The main improvement opportunity is grounding the more abstract guidance (discovery instruments, proof records) with a worked example or concrete commands.

Suggestions

Add one worked proof-record example (a filled-in Candidate/Burden/Reachability/... entry for a typical dead-code candidate) so the template's expected granularity is unambiguous.

Give a concrete example of using repository-native discovery instruments (e.g., a representative search, compiler dead-code warning, or dependency-metadata query) rather than naming the instrument classes only.

DimensionReasoningScore

Conciseness

The body is lean and dense with no padded explanations of concepts Claude already knows; every sentence carries operational weight ('Line-count reduction is supporting evidence, not the objective'), matching anchor 5.

5 / 5

Actionability

The instruction-only guidance is mostly concrete — a copy-paste proof-record template, enumerated keep/downgrade conditions, and mode/scope selection rules — but discovery instruments are described abstractly ('Use repository-native search, compiler and linter output') with no worked example of a completed proof record, leaving minor gaps.

4 / 5

Workflow Clarity

A clear sequence (select mode/scope → establish contract → cover surface → build proof record → decide → deliver) with explicit validation checkpoints appropriate to a potentially destructive skill: baseline capture ('capture a proportional baseline'), 'the smallest check that would expose an incorrect cut', and the required validation and operation receipt.

5 / 5

Progressive Disclosure

The body serves as a clear overview with five conditionally-signaled, one-level-deep references ('For every Broad engagement... read investigation.md'; 'In Change mode, read execution-and-recovery.md'), all of which exist as real files in references/, with detail appropriately split out of SKILL.md.

5 / 5

Total

19

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A highly specific, well-scoped description with explicit use and non-use triggers and comprehensive concrete capability enumeration. Its only weakness is a few missing natural English trigger phrases that users might say when requesting cleanup work.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete, specific actions — 'evidence-backed deletion or consolidation of dead code, duplicate state, redundant APIs or layers, ownerless abstractions, obsolete compatibility or design records, and over-engineering' — covering the candidate space comprehensively, which matches the anchor 5 example's breadth.

5 / 5

Completeness

It explicitly answers both 'what' (simplification audit / removal of accidental complexity via deletion and consolidation of enumerated candidate types) and 'when' ('Use for...' with concrete triggers, plus 'Do not use for...' exclusions), matching anchor 5 exactly.

5 / 5

Trigger Term Quality

Good keyword coverage including natural terms like 'dead code', 'duplicate', 'redundant APIs', and cross-language synonyms ('代码简化 or 熵回收'), but common English phrasings users would naturally say such as 'clean up the code' or 'remove unused code' are absent, fitting anchor 4 rather than the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The explicit exclusion clause 'Do not use for general code review, onboarding, style-only refactoring, or performance tuning' disambiguates it from adjacent skills, giving it a clear niche with minimal conflict risk as anchor 5 requires.

5 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

tt-a1i/archify

Path

.agents/skills/simplify-codebase/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.