CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

trace-regression

Trace a reported dotnet/maui issue to the commit or PR that introduced its regression using release boundaries, source history, and linked evidence. Use for "/issue trace-regression", "which PR introduced this issue", or "trace this regression". Distinguish confirmed introductions from likely candidates and missing evidence. Report-only; not PR regression-risk review, CI failure triage, or automatic bug fixing.

Quality

88%

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

71%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 delivers a highly actionable, well-sequenced investigation workflow with executable commands, an evidence-calibration table, and a complete report template. Its weaknesses are density and monolithic structure: repeated boundary-only instructions bloat section 1, and reference-worthy material (context-schema semantics, report template) is inlined rather than split out.

Suggestions

Extract section 1's field-by-field frozen-context semantics (releaseMetadata budgets, selection rules, diagnostics handling) into a references/ file, keeping SKILL.md to the workflow overview with a clearly signaled link.

Consolidate the three separate boundary-only-mode instructions into a single mode-handling table or subsection to remove the repetition in section 1.

Move the full markdown report template into a references/report-template.md file and keep only the structural requirements (badges, verdict/evidence placement, accordion nesting) inline.

DimensionReasoningScore

Conciseness

Mostly efficient — the body encodes non-obvious, skill-specific policy (frozen-context semantics, evidence budgets, classification rules) rather than concepts Claude already knows — but it could be tightened: the boundary-only mode is restated roughly three times ("With `mode: boundary-only`, produce **Insufficient evidence**...", "For `boundary-only`, proceed directly to the single report after that read", "For `boundary-only`, proceed to `add_comment` after this read"), and section 1's ~120 lines of conditional rules sprawl with run-on sentences. This is anchor 3 (mostly efficient but could be tightened) rather than anchor 4 (only minor trimming needed), because the repetition and density go beyond minor instances.

3 / 5

Actionability

Fully executable guidance: a concrete jq command with a known schema for the first read, a PowerShell collector snippet, a classification table specifying the exact required evidence per verdict, and a copy-paste-ready markdown report template with explicit placeholder-substitution instructions. Anchor 5: specific examples cover the common cases.

5 / 5

Workflow Clarity

A clearly sequenced four-phase workflow (establish boundaries → trace implementation with 5 numbered sub-steps → calibrate conclusion → write report) with explicit validation checkpoints ("Verify the candidate change is present in the bad revision and absent from the good one") and error-recovery feedback ("If the source interval does not explain the symptom, inspect relevant dependency version changes... Stop with an evidence gap"). Not anchor 5 because several checkpoints and mode-handling rules are buried in dense prose rather than surfaced as a checklist, leaving minor gaps in explicitness.

4 / 5

Progressive Disclosure

Sections are well-organized with numbered phases, but this is a ~310-line monolith with no bundle files: the ~120 lines of field-by-field frozen-context semantics in section 1 and the full report template in section 4 are inlined content that clearly belongs in separate reference files. Anchor 3 (some structure, but content that should be separate is inline) rather than anchor 4, since there are no references at all to signal.

3 / 5

Total

15

/

20

Passed

Description

100%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.

The description is exemplary: third-person, concise, concrete about both capability and method, with an explicit "Use for" clause containing three natural trigger phrases and explicit exclusion of adjacent skills. All four dimensions sit at the top anchor.

DimensionReasoningScore

Specificity

"Trace a reported dotnet/maui issue to the commit or PR that introduced its regression using release boundaries, source history, and linked evidence" and "Distinguish confirmed introductions from likely candidates and missing evidence" list multiple concrete actions with the methods named, comprehensively covering the skill's scope. It matches the anchor-5 example's coverage level, not anchor 4, which allows minor gaps in coverage.

5 / 5

Completeness

The first sentence explicitly answers "what" (traces an issue to the introducing commit/PR using release boundaries, source history, and linked evidence) and the "Use for ..." clause explicitly answers "when" with three concrete trigger phrases — the anchor-5 pattern. The "when" clause is explicit with concrete triggers, so this is not the anchor-4 case where the trigger guidance could be more specific.

5 / 5

Trigger Term Quality

Explicit natural trigger phrases — "Use for "/issue trace-regression", "which PR introduced this issue", or "trace this regression"" — are exactly the phrasings a user would say, covering the command form, the natural question form, and the imperative form. This is comprehensive natural-term coverage per anchor 5, beyond anchor 4's "a few natural terms missing".

5 / 5

Distinctiveness Conflict Risk

A clear niche (dotnet/maui regression introduction tracing) with distinct triggers, plus explicit negative scoping ("not PR regression-risk review, CI failure triage, or automatic bug fixing") that disambiguates the nearest competing skills. Minimal conflict risk; anchor 5 rather than anchor 4, which still admits overlap with closely related skills.

5 / 5

Total

20

/

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

dotnet/maui

Path

.github/skills/trace-regression/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.