Docs

What it does

When your agent uses it

• Adding a features documentation
• Fixing a docs issue
• Reworking a page
• Auditing pages for accessibility and consistency

Example prompts

• “/docs”

Requirements

• Python 3
• Node.js

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

1. 1Find the owning page before creating one. rg -l "" docs --glob '!docs/python-sdk/' --glob '!docs/v2/' --glob '!docs/v3/**'. Extend it when…
2. 2Read two neighboring pages in the same docs.json group and match their section order and heading depth.
3. 3Write the page with the template below. Explain why the feature exists before showing how, and keep the first code block small enough to…
4. 4Make every code block runnable: imports present, names defined, one idea per block. Pull intermediate values into named variables instead…
5. 5Run the checks in Verify and fix what they report.
6. 6When the change is ready to ship, open a PR against main. Merged is not live: the site serves published-docs. A stable release from main…

What it can do on your machine

Read from SKILL.md and the folder at commit 5baeacf. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • npx
  • uv
  • rg

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md. Its commands use npx and uv, which can reach the network depending on how they are called.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Docs loads about 1k tokens when it runs. Until then it costs about 75 tokens; SKILL.md has 459 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~75

When it runs · the whole SKILL.md, loaded when a task matches

~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from PrefectHQ/fastmcp at commit 5baeacf, republished under its Apache-2.0 licence (© PrefectHQ). 459 words, ~1,049 tokens.

name

docs

description

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.

---
title: Feature Name
sidebarTitle: Feature
description: One sentence a search result can show.
icon: some-fontawesome-icon
---

import { VersionBadge } from '/snippets/version-badge.mdx'

<VersionBadge version="<version that introduces the feature>" />

One paragraph on the problem this solves and when to reach for it.

## Basic usage

Explain what the example does, then show it.

```python
from fastmcp import FastMCP

mcp = FastMCP("Demo")


@mcp.tool
def greet(name: str) -> str:
    return f"Hello, {name}!"
```

## Configuration

One subsection per option that changes behavior, each with a sentence on the default and an example of the override.

## How it works

Only when the mechanism affects what the reader should do. Put a one-sentence text description before any diagram.

(cd docs && npx --yes mint@latest broken-links)
uv run pytest tests/docs -n 0

© PrefectHQ, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/docs of PrefectHQ/fastmcp.

Open the folder on GitHubat commit 5baeacf