CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

propagate-design-change

Finds architecture decisions (ADRs) made stale by a changed GDD and walks through resolving each. Use when the user changed a number or rule in a GDD and asks which ADRs or architecture decisions are now out of date.

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

88%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 exemplarily operational skill: fully executable commands, exact outputs, sequenced phases with validation gates, verdict-driven feedback loops, and write permissions asked at each step. The only structural weakness is that everything is inlined in one long file when some templates and gate briefs could live in one-level-deep reference files.

DimensionReasoningScore

Conciseness

The body is dense and prescriptive — exact commands, exact user-facing messages, and templates with no re-teaching of concepts Claude already knows (e.g. "Ask git, never compare two whole documents by eye" instructs rather than explains). A few spots could still be trimmed (the M=0 edge-case table rows and repeated option listings), so it is efficient with minor instances of over-explanation rather than every token earning its place.

4 / 5

Actionability

Guidance is fully executable: copy-paste commands ("git diff HEAD -- design/gdd/[filename].md", "bash .claude/scripts/md-section.sh extract <adr> \"GDD Requirements Addressed\"", the md-section.sh replace heredoc), exact error/stop messages to emit, report templates, and scripted user questions cover the common cases. Absence of general-purpose code is appropriate for an instruction-only skill.

5 / 5

Workflow Clarity

Ten numbered phases with explicit stop conditions ("Nothing to propagate." Stop; N=0 and M=0 branches), an explicit denominator table (N, M), a technical review gate with verdict-driven recovery loops (REJECT → "analyse the impact again first"; NOT ASSESSED → supply missing input and re-run), and permission checks before every write. Validation checkpoints are explicit throughout, including the batch ADR check.

5 / 5

Progressive Disclosure

No bundle files exist; the single-file body is well organized with clear phase headers and one-level-deep, clearly signaled references to project resources (.claude/scripts/adr-status.sh, md-section.sh, .claude/docs/…). It falls short of the 5 anchor because all content — including the change-impact document template and TD gate brief — lives inline in a ~250-line monolith rather than being split across reference files.

4 / 5

Total

18

/

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: third-person voice, tight domain framing, explicit what-and-when with concrete trigger phrasing. It defines its niche clearly and would be selected for exactly the right situations; only minor keyword synonyms and pipeline coverage could be added.

DimensionReasoningScore

Specificity

"Finds architecture decisions (ADRs) made stale by a changed GDD and walks through resolving each" names a precise domain and concrete actions (find stale ADRs, walk through resolution) with only minor coverage gaps (reporting and traceability steps are not named). It is more specific than the anchor-3 example of two generic actions, but not comprehensive enough for a 5.

4 / 5

Completeness

The description explicitly answers both: what ("Finds architecture decisions (ADRs) made stale by a changed GDD and walks through resolving each") and when ("Use when the user changed a number or rule in a GDD and asks which ADRs or architecture decisions are now out of date") with a concrete trigger phrase, matching the 5 anchor.

5 / 5

Trigger Term Quality

"changed a number or rule in a GDD", "asks which ADRs or architecture decisions are now out of date" gives good natural keyword coverage including the key user phrasings. A few natural synonyms ("stale", "update ADRs after a design change", "impact") are missing, keeping it below the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche — propagating GDD changes into stale ADRs — with triggers ("changed a number or rule in a GDD", "which ADRs… out of date") that are distinct from related skills like /architecture-review, so conflict risk is minimal.

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

Donchitos/Claude-Code-Game-Studios

Path

.claude/skills/propagate-design-change/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.