CtrlK
BlogDocsLog inGet started
Tessl Logo

claude-win11-speckit-update-skill

Windows 11 system management

33

Quality

29%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/claude-win11-speckit-update-skill/SKILL.md

The canonical home for this skill is claude-win11-speckit-update-skill in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

33%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 well-structured and token-lean but essentially content-free: it restates the vague description across three sections without any executable guidance, concrete steps, or validation. A user or Claude would learn nothing actionable from this skill.

Suggestions

Replace the vague Instructions section with concrete, executable commands (e.g., exact Update Assistant / DISM / PowerShell cmdlets) for the supported Windows 11 update tasks.

Add a sequenced workflow with explicit validation checkpoints and rollback steps, since system updates are destructive and currently lack any feedback loop.

Either move detail into bundle files (references/, scripts/) with clearly signaled one-level links, or fill the body with the specific patterns it claims to provide.

DimensionReasoningScore

Conciseness

The body is short and avoids explaining concepts Claude already knows, but lines like "This skill provides guidance and patterns for windows 11 system management" are vague filler that could be trimmed, placing it just below score-5's every-token-earns-its-place bar.

4 / 5

Actionability

The Instructions section only describes ("provides guidance and patterns") with no concrete commands, code, or steps, matching score-1's entirely vague/abstract guidance.

1 / 5

Workflow Clarity

There is no sequence of steps and no validation for what could be destructive system-update operations, matching score-1's missing/incoherent steps; the destructive-context cap of 3 is not reached because the content lacks steps entirely.

1 / 5

Progressive Disclosure

The body is well organized into Overview/When to Use/Instructions and is under 50 lines, but the only external pointer is a GitHub repo link rather than clearly signaled one-level-deep bundle references, leaving it just short of score-5.

4 / 5

Total

10

/

20

Passed

Description

25%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 a minimal noun phrase that names a domain but states no concrete capabilities and provides no trigger guidance, making it nearly indistinguishable from generic Windows-admin skills. It reads as a placeholder rather than an effective skill description.

Suggestions

Replace the description with concrete actions the skill performs (e.g., 'Installs Windows 11 feature updates via the Update Assistant, checks update compliance, and rolls back failed updates').

Add an explicit 'Use when...' clause with natural trigger phrases users would actually say (e.g., 'Use when the user asks to update, patch, or manage Windows 11 feature updates').

Narrow the scope and include file/tool references to reduce overlap with other system-management skills.

DimensionReasoningScore

Specificity

The phrase "Windows 11 system management" names the domain but provides no concrete actions at all, matching the score-2 anchor of naming a domain with minimal/generic actions rather than score-1's pure abstraction.

2 / 5

Completeness

It offers only a vague "what" ("Windows 11 system management") and no "when"/Use-when clause, exactly matching score-2; the missing trigger guidance also caps it well below the explicit what+when of higher anchors.

2 / 5

Trigger Term Quality

Only the single generic keyword "Windows 11" appears with no natural trigger phrases a user would say, fitting score-2's "one or two generic keywords" and falling short of score-3's relevant keyword coverage.

2 / 5

Distinctiveness Conflict Risk

"Windows 11 system management" is very broad and would overlap with many Windows-administration skills, matching score-2's high overlap risk; it is not specific enough for score-3's "somewhat specific."

2 / 5

Total

8

/

20

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.