CtrlK
BlogDocsLog inGet started
Tessl Logo

using-skills

Describes how to use abilities. Read before any conversation.

49

Quality

62%

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/using-skills/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 content is a well-structured, actionable behavioral guide: it gives a clear required workflow, concrete good/bad examples for each failure mode, and exact phrasing patterns, without padding or explanation of known concepts. Its main weaknesses are minor redundancy in the TodoWrite examples and an unexplained "Nori workflow" reference.

DimensionReasoningScore

Conciseness

The body spends no tokens explaining concepts Claude already knows; every good/bad example is a short behavioral anchor. Minor trimming is possible (four TodoWrite bad-examples, and the unexplained "Following Nori workflow" reference), which keeps it at anchor 4 rather than the fully lean anchor 5.

4 / 5

Actionability

Guidance is concrete and executable: numbered steps ("1. Use Read tool to read the skill"), exact TodoWrite usage patterns shown per-item ("TodoWrite(Do foo)", not bundled), and copy-paste announcement phrasing ("I've read the [Skill Name] ability and I'm using it to..."). Minor gaps — e.g., no guidance on locating the skill file path — hold it below anchor 5.

4 / 5

Workflow Clarity

The <required> block gives an explicit 3-step sequence (read → announce if relevant → create todos), and failure modes are organized as avoid-rules with counter-examples. No validation checkpoints are needed since the skill involves no destructive or batch operations, but "Interpret instructions as 'WHAT' not 'HOW'" is under-specified, keeping it below anchor 5.

4 / 5

Progressive Disclosure

No bundle files exist and the body is organized into clear headed sections (Common Failure Modes, Announcing Skill Usage, How to Read a Skill) with content appropriately all-inline for a behavioral meta-skill. At ~90 lines it exceeds the under-50-line simple-skill case that would merit a 5, so anchor 4 (good structure, minor organization gaps) is the best fit.

4 / 5

Total

16

/

20

Passed

Description

30%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 too vague to function as a reliable trigger. It identifies a domain but lists no concrete actions, contains no natural user-facing trigger terms, and its "Read before any conversation" instruction makes it collide with every other skill in every conversation.

Suggestions

Replace "Describes how to use abilities" with 2-3 concrete actions (e.g., "Reads skill files before use, announces skill usage, and creates TodoWrite checklists for skill steps").

Add a "Use when..." trigger clause with natural user terms such as "Use when starting a task that matches an available skill, or when following a skill's checklist or workflow" — replace "Read before any conversation" with a scoped trigger.

Use consistent terminology ("skills", not "abilities") so the description matches the words users and other skills actually use, reducing conflict risk with unrelated skills.

DimensionReasoningScore

Specificity

"Describes how to use abilities" names the domain (using skills/abilities) but the only stated action is the generic "Describes how to use" — no concrete capabilities are enumerated, matching the anchor 'names the domain but actions are minimal or generic'. It is above anchor 1 because the domain is at least identified, but below anchor 3 since no concrete actions appear.

2 / 5

Completeness

There is a vague "what" ("Describes how to use abilities") and an explicit "when" ("Read before any conversation"). This is above anchor 2 (vague what and no when) but below anchor 4 (both clear and specific), leaving 3 as the best fit — the "what" is too indistinct for a 4.

3 / 5

Trigger Term Quality

The only keywords are "abilities" and "Read before any conversation"; "abilities" is not a term users naturally say (they say "skill"), and the read-instruction is a timing directive rather than a trigger phrase. It sits at anchor 2 (generic keywords, missing the natural phrases users say) rather than anchor 3, since no relevant natural trigger terms or their variations appear.

2 / 5

Distinctiveness Conflict Risk

"Read before any conversation" instructs triggering in literally every conversation, which would conflict with virtually any other skill — a direct match for anchor 1 (entirely generic; conflicts with virtually any skill). Anchor 2's 'high overlap risk with many similar skills' understates the problem.

1 / 5

Total

8

/

20

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.

Validation — 16 / 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.