CtrlK
BlogDocsLog inGet started
Tessl Logo

updating-noridocs

Use this when you have finished making code changes and you are ready to update the documentation based on those changes.

60

Quality

68%

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 ./.agency/plugins/nori/skills/updating-noridocs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-structured, mostly lean workflow with an explicit verification step, but it has redundancy between its mistake/red-flag sections and presents the key dispatch step as non-executable pseudocode.

Suggestions

Consolidate the overlapping 'Common Mistakes' and 'Red Flags' sections to remove the duplicated guidance on context, verification, and trivial changes.

Replace the 'Task(subagent_type: nori-change-documenter)' pseudocode in the bash block with the actual Task tool invocation syntax, or clearly label it as a tool call rather than a shell command.

Include a complete example subagent prompt to make the dispatch step fully actionable and copy-paste ready.

DimensionReasoningScore

Conciseness

The body is lean and avoids explaining concepts Claude already knows, but the 'Common Mistakes' and 'Red Flags' sections overlap substantially (both cover providing context, verifying, and avoiding trivial updates) and could be consolidated.

2 / 3

Actionability

Checklists, an exact subagent type, 'git status', and a copy-paste format template are concrete, but the central dispatch is shown as 'Task(subagent_type: nori-change-documenter)' inside a bash block, which is non-executable pseudocode rather than the real tool-call form.

2 / 3

Workflow Clarity

A clear three-step sequence (Gather Context -> Dispatch -> Verify) with Step 3 as an explicit verification checkpoint and per-step checklists provides the validation/feedback loop the rubric rewards.

3 / 3

Progressive Disclosure

The skill is self-contained with no bundle files, well-organized into clearly labeled sections, and contains no nested references; the inline format template is core content that belongs in SKILL.md.

3 / 3

Total

10

/

12

Passed

Description

67%

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 answers both what and when with an explicit trigger, but it names only a single action and uses broad terminology with few trigger variations, leaving it somewhat generic.

Suggestions

List the concrete actions the skill performs, e.g. 'Gather change context, dispatch the nori-change-documenter subagent, and verify the updated docs.md files.'

Add natural trigger variations users would say, such as 'docs', 'after coding', or 'document the changes'.

Name the specific artifact (docs.md / Noridocs) instead of the generic 'documentation' to sharpen distinctiveness from other doc skills.

DimensionReasoningScore

Specificity

Names the domain ('documentation') and one action ('update') but does not list multiple concrete actions like gather context, dispatch subagent, and verify; not vague enough for 1, not comprehensive enough for 3.

2 / 3

Completeness

Opens with an explicit 'Use this when...' trigger and states what it does ('update the documentation based on those changes'), clearly answering both what and when.

3 / 3

Trigger Term Quality

'finished making code changes' and 'update the documentation' are natural phrasings, but it lacks common variations a user might say such as 'docs', 'after coding', or 'document the changes'.

2 / 3

Distinctiveness Conflict Risk

The post-code-change doc-update trigger is a fairly distinct niche, but the generic term 'documentation' could still overlap with other general documentation skills.

2 / 3

Total

9

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
microsoft/FluidFramework
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.