CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

signoz-page-story

Explore a SigNoz page, map the endpoints, states and query params it has, then write its Storybook page story with control-driven msw mocks that reach every state. Use when asked to create, extend or review a Storybook story for a page under frontend/src/pages, to add controls to an existing page story, or to write defineStoryMocks handlers and mock data for a page.

Quality

94%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A dense, high-quality skill body: project-specific rules only, executable code and commands, a validated multi-step workflow with feedback loops and a completion checklist, and detail properly offloaded to three real, clearly signaled reference files. The single weakness is a couple of over-long run-on rule bullets that could be tightened or moved to a reference.

DimensionReasoningScore

Conciseness

The body never explains concepts Claude already knows — every rule is project-specific and non-obvious ('@signozhq/ui turns a button off with aria-disabled instead', 'Storybook parses the order out of the file statically'). A few bullets (the file-layout rule, the play-function rule) are long run-on prose that could be tightened or split into a reference, keeping this just below 'every token earns its place'.

4 / 5

Actionability

Fully executable throughout: copy-paste-ready code for the meta/doc-comment pattern, the aria-disabled assertion, the click-and-check pattern, and the AI-owned banner, plus exact commands ('pnpm tsgo --noEmit', 'pnpm exec oxlint <files>', 'pnpm exec oxfmt --check <files>') and exact title and path formats. Specific examples cover the common cases with no gaps.

5 / 5

Workflow Clarity

A five-step sequenced workflow with explicit validation checkpoints and feedback loops: 'run it. The console names the endpoints step 1 missed', 'Never report the story as done without it', and 'Flip it once and run it' for assertions, capped by the 'Done means' checklist with concrete verification commands. This matches the top anchor including error recovery.

5 / 5

Progressive Disclosure

The body is a clear overview of process and rules, with detail correctly split into three well-signaled, one-level-deep references (references/discovery.md, references/controls.md, references/verify.md) that all exist in the bundle with substantive content (51/180/85 lines) and are linked at the point of need. Nothing that belongs in a reference is inlined and navigation is easy.

5 / 5

Total

19

/

20

Passed

Description

92%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 strong two-sentence what-plus-when: concrete, third-person capability verbs followed by an explicit 'Use when...' clause with three distinct trigger scenarios. Its only gap is minor — a few natural synonyms or file-extension variants (e.g. '.stories.tsx') that would broaden trigger matching.

DimensionReasoningScore

Specificity

Lists multiple concrete actions covering the full workflow: 'map the endpoints, states and query params', 'write its Storybook page story with control-driven msw mocks', and 'write defineStoryMocks handlers and mock data'. Coverage is comprehensive across explore, map, write, and handler/mock authoring, matching the top anchor rather than the 'minor gaps' anchor below it.

5 / 5

Completeness

Explicitly answers both: the 'what' ('Explore a SigNoz page, map the endpoints, states and query params... then write its Storybook page story') and the 'when' via an explicit 'Use when...' clause with three concrete trigger conditions. The when-clause is specific and trigger-phrase-driven, not merely present, so it exceeds the anchor 4 example.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present ('create, extend or review a Storybook story', 'add controls to an existing page story', 'mock data'), but a few natural variants are missing (e.g. '.stories.tsx', 'stories file'). This sits above 'some relevant keywords' (3) but short of the comprehensive synonym-and-extension coverage of the top anchor.

4 / 5

Distinctiveness Conflict Risk

Triggers are pinned to a clear niche ('a page under frontend/src/pages', 'defineStoryMocks handlers', 'SigNoz page'), so no closely related skill shares these triggers. This is a clear niche with distinct triggers and minimal conflict risk.

5 / 5

Total

19

/

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

SigNoz/signoz

Path

.claude/skills/signoz-page-story/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.