CtrlK
BlogDocsLog inGet started
Tessl Logo

mastra-docs

Documentation guidelines for Mastra. This skill should be used when writing or editing documentation for Mastra. Triggers on tasks involving documentation creation or updates.

69

Quality

83%

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

100%

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 tight, actionable overview: it tells Claude exactly which guide to start with, how to choose the right content guide, and which lint commands to run, with all references being real one-level-deep files. It exemplifies lean progressive disclosure with concrete executable guidance.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: it does not explain what linters or styleguides are, lists only the needed commands, and every line earns its place with no padding.

3 / 3

Actionability

It gives fully concrete, executable commands ('pnpm run format', 'pnpm run lint:remark', 'pnpm run validate') plus specific tool names and a clear file-selection rule, making the guidance copy-paste ready.

3 / 3

Workflow Clarity

It lays out a clear sequence (pick the right guide -> edit docs and sidebars -> run the linters) and names the verification layer ('run the linters to check your work'), giving an explicit checkpoint; the multi-step process is well sequenced.

3 / 3

Progressive Disclosure

The SKILL.md is a concise overview that points to one-level-deep, real reference files (STYLEGUIDE.md then DOC/GUIDE_*/REFERENCE.md), all of which exist, with clear signaling of which guide matches which content type and easy navigation.

3 / 3

Total

12

/

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 clearly answers both what the skill does and when to use it, with explicit trigger guidance, but its capability list and trigger vocabulary are relatively thin and the 'documentation' trigger risks overlap with general doc skills. It is solid but not maximally specific or distinctive.

Suggestions

Add concrete actions to broaden the capability list, e.g. 'write, edit, lint, and format Mastra docs and sidebars'.

Expand trigger terms with natural variations users would actually say, such as 'docs', 'guide', 'tutorial', 'API reference', or 'MDX content'.

Tighten distinctiveness by anchoring triggers to Mastra-specific artifacts (e.g. 'when editing docs/ in the Mastra repo') to reduce overlap with generic documentation skills.

DimensionReasoningScore

Specificity

It names the domain ('documentation for Mastra') and a couple of actions ('writing or editing documentation', 'documentation creation or updates'), but does not list multiple distinct concrete actions, staying at the domain-plus-some-actions level.

2 / 3

Completeness

It states what the skill does ('Documentation guidelines for Mastra... writing or editing documentation') and explicitly when to use it ('Triggers on tasks involving documentation creation or updates'), satisfying both what and when.

3 / 3

Trigger Term Quality

It includes relevant terms ('documentation', 'Mastra', 'documentation creation or updates') but omits common natural variations a user might say ('docs', 'guide', 'tutorial', 'API docs'), so coverage is partial.

2 / 3

Distinctiveness Conflict Risk

The Mastra-specific scoping helps, but 'documentation' is a broad trigger that could overlap with general doc-writing skills, so it is only somewhat specific rather than a clearly distinct niche.

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
mastra-ai/mastra
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.