CtrlK
BlogDocsLog inGet started
Tessl Logo

scope-creep-detector

Analyzes git diffs against a stated intent to detect scope creep, unrelated files, broad pull requests, changes that grew beyond a fix, dependency additions, public API renames, config or CI edits, oversized hunks, and formatting-only files. Use when the user asks whether a change grew beyond the fix, a PR is too broad, or what unrelated stuff they touched, and wants keep, split, or justify guidance. Operates locally and offline.

77

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

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.

The body is an exemplary skill document: lean with zero filler, four executable command variants covering the common diff sources, a guarded decision framework with explicit verification and ask-before-acting checkpoints, and proper progressive disclosure to a real one-level-deep reference file. No dimension shows a meaningful weakness.

DimensionReasoningScore

Conciseness

The body is lean throughout: it never explains git, diffs, or CI concepts Claude already knows, and every section (intent, classifier commands, JSON fields, dispositions, report structure) adds non-obvious, skill-specific information. It matches anchor 5 ('Lean and efficient; assumes Claude's competence; every token earns its place'); there is no padded or over-explained section that would drop it to anchor 4.

5 / 5

Actionability

All four invocation styles are given as complete, copy-paste-ready commands with exact flags (--repo/--staged/--base/--diff/--intent/--json), the JSON output fields are each explained with their meaning, and the keep/split/justify framework gives concrete criteria plus a compact report template. This matches anchor 5 ('Fully executable; copy-paste ready code or commands; specific examples cover the common cases').

5 / 5

Workflow Clarity

The workflow is a clear single-purpose sequence — establish intent (with a checkpoint: ask for intent when the branch name is generic), run the classifier, read the signals reference before recommending, assign dispositions, write the report — and it includes explicit safeguards: 'Treat the classifier as triage evidence, not proof', verify connections before split, and 'Ask before applying any split, revert, staging, or commit operation'. This is a single-task skill with an unambiguous action and validation checkpoints, matching anchor 5 rather than anchor 4, which would require some checkpoints to be missing.

5 / 5

Progressive Disclosure

The SKILL.md is a well-organized overview that pushes detail to a single, clearly signaled, one-level-deep reference ('Read [references/scope-signals.md](references/scope-signals.md) before making a recommendation'), and the Files section accurately lists both bundle files, which exist on disk (references/scope-signals.md, scripts/scope_creep.py). This matches anchor 5 ('Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'); there is no inlined bulk material or nesting that would warrant anchor 4.

5 / 5

Total

20

/

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 strong description: third-person voice, concrete enumeration of detected signals and output decisions, and an explicit 'Use when' trigger clause with natural user phrasings. The only gap is a few missing synonym phrasings users might use, such as asking whether a diff is too big or requesting a review of a mixed change.

DimensionReasoningScore

Specificity

The description enumerates many concrete detection targets — 'unrelated files, broad pull requests, changes that grew beyond a fix, dependency additions, public API renames, config or CI edits, oversized hunks, and formatting-only files' — plus concrete output dispositions ('keep, split, or justify guidance'). This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' and exceeds anchor 4, which allows only several actions with minor gaps.

5 / 5

Completeness

It explicitly answers both questions: what it does ('Analyzes git diffs against a stated intent to detect scope creep...') and when to use it ('Use when the user asks whether a change grew beyond the fix, a PR is too broad, or what unrelated stuff they touched'). This is the anchor-5 pattern of a clear what followed by concrete trigger phrases; anchor 4 would require the 'when' to be less explicit or specific.

5 / 5

Trigger Term Quality

Natural user phrasings are present — 'scope creep', 'whether a change grew beyond the fix', 'a PR is too broad', 'what unrelated stuff they touched' — covering the main ways users would voice this need. It falls short of anchor 5 because common synonyms such as 'review my diff/PR', 'is this change too big', or 'refactor mixed in' are absent, matching anchor 4 ('Good keyword coverage; a few natural terms missing') rather than comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — diff-scope analysis with keep/split/justify recommendations — distinct from correctness or security review skills, and its triggers ('too broad', 'grew beyond the fix') would not naturally fire for other skills. It matches anchor 5's 'Clear niche with distinct triggers; minimal conflict risk'; anchor 4 would imply meaningful overlap with closely related skills, which is not the case.

5 / 5

Total

19

/

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
Shubhamsaboo/awesome-llm-apps
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.