CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

assessing-breaking-changes

Guides assessment of backward compatibility for MSBuild changes. Consult when modifying behavior, adding warnings or errors, changing defaults, altering target ordering, removing or deprecating features, deciding whether a change needs a ChangeWave, reviewing blast radius of behavioral changes, or when a PR introduces user-visible output differences.

Quality

86%

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

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

A well-crafted, lean decision-support skill with concrete, actionable guidance and a clear decision workflow — the compatibility checklist, decision tree, and test matrix cover the common cases thoroughly. Main weaknesses are minor: slight duplication of the warnings-as-errors rule and references that escape the skill bundle with fragile relative paths.

DimensionReasoningScore

Conciseness

The body is dense and lean — a blast-radius table, a decision tree, and a numbered deprecation protocol with no padding or explanations of concepts Claude already knows. Held below 5 because the WarnAsError rule is stated twice (Core Philosophy point 2 and 'The Warnings-as-Errors Rule' section) — a minor duplication that could be trimmed.

4 / 5

Actionability

Fully concrete, executable guidance: exact XML ('<TreatWarningsAsErrors>true</TreatWarningsAsErrors>'), exact option names (MessageImportance.Low / Normal), a specific test matrix ('<TargetFrameworks>net472;net8.0</TargetFrameworks>'), and three enumerated options for new warnings. As an instruction-only skill, the absence of code is not penalized — the guidance is copy-paste actionable.

5 / 5

Workflow Clarity

The decision framework tree, blast-radius checklist, and numbered deprecation protocol sequence the workflow clearly, with a documentation checkpoint ('Document the compatibility decision in your PR description so reviewers can validate it'). Not a 5: there is no explicit feedback loop for what to do when a checklist item or test-matrix check fails beyond 'test opt-out path'.

4 / 5

Progressive Disclosure

Well-organized sections with clearly signaled, one-level-deep references ('For detailed ChangeWave mechanics, see...'). Held below 5 because the references point outside the skill bundle ('../changewaves/SKILL.md', '../../../documentation/wiki/ChangeWaves-Dev.md') — relative paths that cannot be verified to resolve from within this skill directory, a minor navigation gap.

4 / 5

Total

17

/

20

Passed

Description

87%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 that clearly states the skill's purpose and provides explicit, varied 'Consult when...' trigger guidance covering the full range of compatibility scenarios. Third-person voice and domain-specific terminology make it both specific and distinctive.

DimensionReasoningScore

Specificity

Names the MSBuild compatibility domain and enumerates concrete assessment targets ('adding warnings or errors', 'changing defaults', 'altering target ordering', 'removing or deprecating features', 'reviewing blast radius'). The core capability is a single action ('guides assessment') rather than multiple distinct concrete actions, so it does not reach the comprehensive coverage of a 5.

4 / 5

Completeness

Explicitly answers both what ('Guides assessment of backward compatibility for MSBuild changes') and when ('Consult when modifying behavior, adding warnings or errors, changing defaults, altering target ordering...') with concrete trigger phrases in third-person voice.

5 / 5

Trigger Term Quality

Strong natural trigger phrases users would say: 'adding warnings or errors', 'removing or deprecating features', 'blast radius', 'ChangeWave', 'user-visible output differences'. Missing a few common variations such as 'breaking change', 'backcompat', or 'WarnAsError'/'TreatWarningsAsErrors'.

4 / 5

Distinctiveness Conflict Risk

Clear niche (MSBuild backward compatibility) with domain-specific triggers (ChangeWave, target ordering, MSBuild output) that would not fire for unrelated skills; minimal conflict risk.

5 / 5

Total

18

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 3 suspicious

Warning

Total

14

/

16

Passed

Repository

dotnet/msbuild

Path

.github/skills/assessing-breaking-changes/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.