CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

workflow-scenarios

Use when authoring or validating dotnet-inspect workflow scenarios, including exact-build execution, performance gates, profiling, and network observation.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%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.

An exemplary lean router skill: concise, unambiguous navigation, and textbook progressive-disclosure structure. The only weaknesses are that the body is not independently actionable (all executable guidance lives in the reference files) and those referenced files are missing from the provided bundle, leaving the disclosure structure unverified.

Suggestions

Include the four referenced files (writing-workflows.md, validating-workflows.md, performance-testing.md, network-guard.md) in the skill bundle so the one-level-deep navigation is verifiable and the skill is self-contained.

Add a single quick-start line for the most common task (e.g., the exact command to validate one scenario) so the body offers minimal executable value on its own before delegating to the references.

DimensionReasoningScore

Conciseness

The ~19-line body is lean and assumes Claude's competence: every line either scopes the skill ('repo-local contributor skill for the executable scenario documents under docs/workflows/'), routes to a reference, or states a non-obvious repo convention ('It is not embedded in the dotnet-inspect binary'). No known concepts are explained and nothing is trimmable, matching the 'every token earns its place' anchor.

5 / 5

Actionability

The four bullets form a concrete task-to-file mapping ('Choose the focused reference for the task'), but the body contains no commands, code, or executable steps — all executable detail is delegated to the reference files, which are absent from the provided bundle. This fits 'mostly executable guidance with minor gaps' rather than the copy-paste-ready anchor 5.

4 / 5

Workflow Clarity

This is a simple navigation skill with a single action — selecting the correct reference — and that action is unambiguous via four crisply delineated bullets, each naming a file and the scope it defines. The simple-skill exception applies; no multi-step or destructive/batch operations require validation checkpoints.

5 / 5

Progressive Disclosure

Structurally this matches the anchor-5 pattern: a clear overview with four well-signaled one-level references, each annotated with what it defines. However, the referenced files (writing-workflows.md, validating-workflows.md, performance-testing.md, network-guard.md) are not present in the provided bundle (no references/, scripts/, or assets/ directories), so the one-level-deep promise cannot be verified, leaving minor organization uncertainty.

4 / 5

Total

18

/

20

Passed

Description

78%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.

A concise, appropriately niche description with an explicit and specific trigger clause and strong distinctiveness. Its main weakness is that the skill's capabilities are only implied inside the 'Use when' phrasing rather than stated declaratively, and it lacks natural trigger variations beyond the canonical domain terms.

Suggestions

State the capability declaratively before the trigger clause (e.g., 'Defines authoring and validation conventions for dotnet-inspect workflow scenarios under docs/workflows/. Use when...') so the 'what' is explicit, not implied.

Add natural trigger variations contributors would actually say, such as 'docs/workflows', 'scenario documents', or 'running the workflow suite', to broaden keyword coverage.

DimensionReasoningScore

Specificity

Names the domain ('dotnet-inspect workflow scenarios') and several concrete capability areas ('exact-build execution, performance gates, profiling, and network observation'), matching the 'several specific actions; minor gaps' anchor; the sub-areas are capability nouns rather than fully concrete actions, so it falls short of the comprehensive anchor 5.

4 / 5

Completeness

The 'when' is explicit and specific ('Use when authoring or validating dotnet-inspect workflow scenarios'), but the 'what' is never declaratively stated — the skill's capabilities only appear folded inside the trigger clause, so scoring only what is explicitly written places it at 'both present; one could be more explicit' rather than the clearly-separated what+when of anchor 5.

4 / 5

Trigger Term Quality

'authoring', 'validating', 'workflow scenarios', 'performance gates', 'profiling', and 'network observation' are natural phrases a contributor would say, but common variations like 'docs/workflows', 'scenario documents', or 'running the suite' are missing — good coverage with a few natural terms absent, not the synonym/extension-level coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

'dotnet-inspect', 'workflow scenarios', and 'exact-build execution' pin the description to a narrow niche with distinct triggers and minimal overlap risk with any generic workflow or documentation skill, matching the clear-niche anchor.

5 / 5

Total

17

/

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

relative_links

Relative link issues: 4 missing

Warning

Total

15

/

16

Passed

Repository

richlander/dotnet-inspect

Path

.github/skills/workflow-scenarios/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.