CtrlK
BlogDocsLog inGet started
Tessl Logo

starting-nori

ALWAYS load this skill if it is not already loaded, for ANY user query or conversation - establishes the Nori workflow, protected-branch check, operating mode, tone, and coding guidelines before any other work

55

Quality

69%

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/starting-nori/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 body is a well-structured, actionable workflow document: explicit sequencing, plan-approval feedback loops, safety guardrails, and clearly signaled references to related skills. Its main weaknesses are redundant repeated admonitions and near-duplicate checklists across the two operating modes.

DimensionReasoningScore

Conciseness

The body is largely lean checklists with no explanations of concepts Claude already knows, matching anchor 4 ('efficient; minor instances of over-explanation that could be trimmed'). Trimmable redundancy includes the thrice-repeated '*CRITICAL* Add each element of this checklist to your Todo list using TodoWrite. DO NOT BE LAZY', near-duplicate research/plan steps across the two mode sections, and the personal aside 'My last assistant was too sycophantic and was replaced'. Not a 3 because there is no padded conceptual explanation; not a 5 because of that structural repetition.

4 / 5

Actionability

Guidance is concrete and directly executable: named skills to invoke ('Invoke the `using-skills` skill', 'read and follow the `writing-plans` skill'), a specific branch check ('Check git status - are you on main, master, dev, or any similarly named protected branch?'), and explicit mode definitions. This matches anchor 4 ('mostly executable guidance... with minor gaps'); not a 5 because steps like 'Check if the codebase uses noridocs' give no method, and not a 3 because nothing is pseudocode or merely descriptive.

4 / 5

Workflow Clarity

The multi-step process is clearly sequenced (branch check → mode selection → research → plan → TDD → docs → finish) with an explicit feedback loop ('Present plan to me and ask for feedback... Repeat until I approve') and safety guardrails ('Do not make changes to production data... main... third party APIs'), matching anchor 4. Not a 5 because some checkpoints are implicit (no verification after the noridocs update step, no procedure for the noridocs check itself); not a 3 because sequence and approval checkpoints are explicit.

4 / 5

Progressive Disclosure

Content is well organized into clear sections (Full-send Mode, Copilot Mode, Tone, Coding Guidelines), and the 'See also' list references each related skill one level deep with a one-line description of what it provides (e.g. '`testing-anti-patterns` skill - What NOT to do when writing tests'). No bundle files exist, and the ~90-line body is appropriately self-contained — matching anchor 4 with minor organization gaps. Not a 5 because the two mode sections duplicate nearly identical checklists that could be factored into a shared step list.

4 / 5

Total

16

/

20

Passed

Description

47%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 clearly states what the skill establishes and gives explicit (if extreme) trigger guidance, but its always-on trigger for any conversation maximizes conflict risk and it contains no natural user-spoken trigger terms. The imperative voice also works against it under this rubric.

Suggestions

Replace the always-on trigger ('for ANY user query or conversation') with concrete conditions, e.g. 'Use when starting any coding task or branch work in a Nori-configured repository', to reduce conflict with every other skill.

Rewrite in third person, declarative voice (e.g. 'Establishes the Nori workflow: protected-branch check, operating-mode selection, tone, and coding guidelines.') instead of the imperative 'ALWAYS load this skill'.

Add natural trigger phrases users would actually say (e.g. 'start a task', 'new feature', 'make changes', 'open a PR') so the description contains keywords real queries match against.

DimensionReasoningScore

Specificity

The description lists several concrete components ("establishes the Nori workflow, protected-branch check, operating mode, tone, and coding guidelines"), which matches the anchor-4 example of several specific actions with minor gaps. However, the imperative second-person framing ("ALWAYS load this skill if it is not already loaded") violates the third-person voice rule, reducing the score by 1. Not a 2 because the listed capabilities are concrete rather than minimal or generic.

3 / 5

Completeness

Both parts are explicitly stated: the "what" ("establishes the Nori workflow, protected-branch check, operating mode, tone, and coding guidelines") and an explicit "when" ("ALWAYS load this skill... for ANY user query or conversation"). Not a 5 because the "when" is maximally broad rather than concrete trigger phrases; not a 3 because explicit trigger guidance is present, not merely implied.

4 / 5

Trigger Term Quality

The only trigger language is "for ANY user query or conversation", which is entirely generic and includes no natural phrases a user would actually say; "Nori workflow" is a coined term, not a user-spoken keyword. Not a 1 because a couple of recognizable generic keywords ("user query", "conversation", "coding guidelines") are present; not a 3 because no relevant synonyms or common variations appear.

2 / 5

Distinctiveness Conflict Risk

By claiming "for ANY user query or conversation", it overlaps with virtually every other skill, though the distinct "Nori" naming prevents total genericness (anchor 1). Not a 3 because the always-on trigger scope creates high overlap risk with many skills, exactly the anchor-2 example.

2 / 5

Total

11

/

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.