docs

Write or revise a page under docs/ for gofastmcp.com. Use when adding a feature's documentation, fixing a docs issue, reworking a page, or auditing pages for accessibility and consistency. Covers the page shape, the voice, the checks that run in CI, and how a merged page reaches the live site.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

96%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 tightly written, highly actionable skill body with a clear validated workflow and well-organized sections. The only minor gap is progressive disclosure, where the body slightly exceeds the simple-skill line and leans on one external pointer.

Suggestions

Consider moving the MDX page template into a references/template.mdx file and signaling it from the body, which would let the body stay an overview and improve progressive_disclosure.

The pointer to .agents/skills/release/SKILL.md for docs-only publishing could be summarized inline in one line so the reader need not jump skills for the common sub-case.

Split the Gotchas list into a short references file if it grows, keeping the body as a navigable overview.

Dimension	Reasoning	Score
Conciseness	Lean, imperative prose that assumes Claude's competence with no preamble explaining what a docs site is; every section (Voice, Accessibility, Gotchas) earns its tokens, matching the lean-and-efficient anchor.	5 / 5
Actionability	Provides fully executable guidance: an exact ripgrep command with globs, runnable verify commands, a copy-paste MDX/Python template, and specific gotchas naming real identifiers (mcp_types, docs.json paths), matching the copy-paste-ready anchor.	5 / 5
Workflow Clarity	A numbered six-step procedure with an explicit validation checkpoint (step 5: run the Verify checks and fix what they report) and exact verify commands describing what each catches, matching the clear-sequence-with-explicit-validation anchor.	5 / 5
Progressive Disclosure	Well-organized into clear self-contained sections with a single appropriately-signaled one-level pointer to .agents/skills/release/SKILL.md; at ~80 lines and referencing an external skill file it sits just below the simple-skill exception's clean 5.	4 / 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.

A strong, specific description that clearly states both what the skill does and when to use it, scoped to a distinct niche with concrete trigger phrases. Slightly below top marks only on trigger-term synonym coverage.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ('Write or revise a page', 'adding a feature's documentation', 'fixing a docs issue', 'reworking a page', 'auditing pages for accessibility and consistency') with comprehensive coverage of the docs lifecycle, matching the anchor for multiple specific concrete actions.	5 / 5
Completeness	Explicitly answers both 'what' (write/revise a docs page; covers page shape, voice, CI checks, publish path) and 'when' with concrete trigger phrases, matching the anchor that requires both answered clearly and explicitly.	5 / 5
Trigger Term Quality	The 'Use when adding a feature's documentation, fixing a docs issue, reworking a page, or auditing pages...' clause provides good natural keyword coverage, but a few synonyms/common variations are missing, so it sits below the comprehensive-synonym anchor of 5.	4 / 5
Distinctiveness Conflict Risk	Scoped tightly to the gofastmcp.com Mintlify docs site with distinct triggers and minimal overlap risk with other skills, matching the clear-niche anchor.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

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: PrefectHQ/fastmcp
Path: .agents/skills/docs/SKILL.md
Commit: 345647d

Reviewed: 4 hours ago

Table of Contents

Discovery Implementation Validation

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.