CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

claude-win11-speckit-update-skill

Windows 11 system management

Quality

41%

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-claude/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

30%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 empty shell: well-organized headers and lean wording wrap essentially zero instructional content, deferring everything to an external repository link. Claude reading this skill would have no idea what steps to take, what commands to run, or how to validate results.

Suggestions

Replace 'This skill provides guidance and patterns' with the actual instructions: the concrete update procedure, required commands or scripts, and expected inputs/outputs.

Add a numbered workflow with validation checkpoints (e.g. check current state, apply update, verify success, rollback on failure) since system updates are batch/destructive operations.

Bundle the detailed guidance from the source repository into references/ files and link them from clearly signaled sections in SKILL.md instead of a bare external URL.

DimensionReasoningScore

Conciseness

The body is short with no over-explanation of known concepts, fitting anchor 4 ('efficient; minor instances of over-explanation that could be trimmed') — the phrase 'windows 11 system management' is repeated nearly verbatim across the Overview, When to Use, and Instructions sections, which is redundant filler. It cannot score 5 because those repeated tokens do not earn their place, but it never approaches the verbosity of anchors 1-3.

4 / 5

Actionability

There is no concrete guidance whatsoever: no commands, no steps, no examples, no specifics — only 'This skill provides guidance and patterns for windows 11 system management.' This matches anchor 1 ('entirely vague or abstract; no concrete code or commands; only describes rather than instructs'); it cannot score 2 because not even high-level executable hints are present.

1 / 5

Workflow Clarity

No sequence of steps exists anywhere in the body, and for a skill nominally about applying system updates (a batch/system-modifying operation) there are no validation checkpoints either. This matches anchor 1 ('steps missing or incoherent; no sequence; no validation for risky operations'), and the destructive/batch feedback-loop guidance reinforces the floor.

1 / 5

Progressive Disclosure

The body has clear section headers (Overview, When to Use, Instructions) but no bundle files exist, so the claimed 'guidance and patterns' are deferred to an external GitHub URL rather than properly structured references. This matches anchor 3 ('some structure but could be better organized') — above anchor 2 because sections are present and navigation is trivial, but below anchor 4 because the actual content is not appropriately placed inline or in one-level-deep reference files.

3 / 5

Total

9

/

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 three-word domain label with no actions, no usage triggers, and high overlap risk with any Windows administration skill. It sits just above the bad_overall examples like 'Helps with documents' and far below every good example, which pair concrete capabilities with explicit 'Use when...' trigger clauses.

Suggestions

State 2-4 concrete actions the skill performs, e.g. 'Runs Windows Update, checks driver versions, and applies Speckit update policies on Windows 11 systems.'

Add an explicit trigger clause: 'Use when the user asks to update, patch, or manage Windows 11 systems, drivers, or Windows Update settings.'

Include natural synonyms and specifics users would say (Windows Update, patch Tuesday, driver updates) to distinguish the skill from generic Windows administration skills.

DimensionReasoningScore

Specificity

The description 'Windows 11 system management' names a domain but contains zero concrete actions — it is a bare noun phrase with no verbs describing what the skill does. It is above anchor 1 because it does identify a specific domain (Windows 11), but it matches anchor 2 ('names the domain but actions are minimal or generic') at best, since even a generic action verb is absent.

2 / 5

Completeness

The 'what' is vague (what does 'system management' mean — updating, configuring, monitoring?) and the 'when' is entirely absent, matching anchor 2 ('has a vague what and no when'). It cannot score 3 because the what is not clear, and the missing 'Use when...' clause caps completeness at 3 per the judging guidelines anyway.

2 / 5

Trigger Term Quality

'Windows 11' is a term users would naturally say, but it is the only real keyword; 'system management' is generic and all natural variations users would actually utter (update Windows, Windows Update, patching, drivers, Speckit) are missing. This matches anchor 2 ('one or two generic keywords; missing the natural phrases users say') rather than anchor 3, which requires broader relevant keyword coverage.

2 / 5

Distinctiveness Conflict Risk

'Windows 11 system management' is very broad and would overlap with any Windows-related skill (updates, settings, drivers, administration), matching anchor 2 ('very broad; high overlap risk with many similar skills'). It edges above anchor 1 only because Windows 11 is a concrete platform, but no distinct trigger or niche is stated.

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.

Validation — 15 / 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

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/claude-win11-speckit-update-skill/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.