CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pre-modification-check

Use before modifying, refactoring, or deleting files in a codebase that has Repowise indexed (indicated by a .repowise/ directory). Activates when Claude is about to edit code, especially shared utilities, core modules, or files the user didn't explicitly mention. Helps assess impact and avoid breaking things.

Quality

89%

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

100%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 exemplary instruction-only skill body: concrete tool-call syntax with arguments, explicit numeric thresholds for when to warn the user, batch guidance, and a defined fallback when the MCP server is unavailable. It stays lean while packing in only Repowise-specific knowledge Claude could not infer, and its section structure fully covers the skill's scope without needing bundle files.

DimensionReasoningScore

Conciseness

The ~45-line body is lean and assumes Claude's competence: no explanations of what refactoring or hotspots are, and every line carries Repowise-specific facts Claude cannot know (field semantics like 'fix_count over the trailing 6 months', the caveat 'the per-symbol counts are approximate — read them as "mostly here"', terse prioritization 'A file that keeps getting fixed is the strongest single signal... lead with it'). Re-checking anchor 4, no section is padded or could be trimmed without losing operational information.

5 / 5

Actionability

Fully executable guidance: copy-paste-ready calls ('get_risk(targets=["path/to/file.py"])', the batch form 'get_risk(targets=["file1.py", "file2.py", "module/"])', 'get_context', 'get_health') plus specific numeric decision thresholds ('above 90th percentile', 'More than 10 dependents', 'Bus factor of 1', named risk types) and a concrete fallback for tool errors. Specific examples cover the common cases (single file, batch, refactor, error).

5 / 5

Workflow Clarity

The workflow is sequenced by scenario (before editing → read risk signals → warn on thresholds → get_context before refactors → get_health for heavy refactors) with an explicit warning checklist as the validation gate before any modification and a clear error-recovery path ('If get_risk returns a tool error... Proceed with the modification but note that risk assessment was unavailable'). The destructive-operation cap does not apply: the skill itself is the pre-edit validation step, and the simple-skill exception (under 50 lines, single task) is satisfied.

5 / 5

Progressive Disclosure

The skill is under 50 lines, self-contained, with no references/, scripts/, or assets/ bundle — nothing to offload. Five well-labeled sections ('Before editing a file', 'When modifying multiple files', 'When to warn the user', 'Before refactoring or moving code', 'Error handling') organize the content, matching the rubric's exception for short single-purpose skills.

5 / 5

Total

20

/

20

Passed

Description

73%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 well-targeted description with an explicit and unusually concrete activation condition (pre-edit in a Repowise-indexed codebase, .repowise/ marker, shared utilities/core modules). Its main weakness is the vague 'what' clause — 'Helps assess impact and avoid breaking things' — which names no concrete assessment capabilities, keeping specificity and completeness below the top anchors.

Suggestions

Replace the generic 'Helps assess impact and avoid breaking things' with concrete capabilities, e.g. 'Checks Repowise risk signals — bug-fix history, hotspot scores, dependent counts, ownership, and test gaps — before modifying, refactoring, or deleting files.'

Mention the refactoring support (context and health checks) in the description so the 'what' covers all workflows in the body, not just the pre-edit risk check.

DimensionReasoningScore

Specificity

The domain is named precisely ('a codebase that has Repowise indexed (indicated by a .repowise/ directory)' with trigger operations 'modifying, refactoring, or deleting files'), but the skill's own actions remain generic: 'Helps assess impact and avoid breaking things' never names what the assessment involves. Not 4 because it lists no concrete assessment capabilities (risk scores, dependents, ownership); not 2 because the domain and trigger operations are concrete rather than minimal.

3 / 5

Completeness

Both parts are explicitly present: 'when' is strong ('Use before modifying, refactoring, or deleting files... Activates when Claude is about to edit code, especially shared utilities, core modules, or files the user didn't explicitly mention') and 'what' is stated ('Helps assess impact and avoid breaking things'). Not 5 because the 'what' is a single shallow clause rather than a concrete capability list, unlike anchor 5's 'Extract text and tables from PDF files, fill forms, merge documents'; not 3 because 'when' is fully explicit, not merely implied.

4 / 5

Trigger Term Quality

Good natural keyword coverage: 'modifying, refactoring, or deleting files', 'about to edit code', 'shared utilities, core modules', plus the '.repowise/ directory' marker. Common variations users would say — 'changing', 'updating', 'renaming', 'impact analysis' — are absent, so it falls short of the comprehensive synonym coverage of anchor 5 but is clearly above anchor 3's 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The description is gated on a unique environment marker — 'a codebase that has Repowise indexed (indicated by a .repowise/ directory)' — giving it a clear niche with distinct triggers and minimal conflict risk against generic editing, review, or refactoring skills. Re-checking anchor 4 ('minor overlap risk with closely related skills'): no other plausible skill targets .repowise-indexed codebases, so the fit to anchor 5 holds.

5 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

repowise-dev/repowise

Path

plugins/claude-code/skills/pre-modification/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.