polish-docs-meta

polish-docs-meta is a skill for Claude Code from cyanheads/gbif-biodiversity-mcp-server. It costs 54 tokens per session (5,394 once invoked), scanned A, a copy of polish-docs-meta, Apache-2.0.

A checklist for finalizing documentation and project metadata for an MCP server, a service that exposes tools, resources, or prompts to AI agents. It is intended for a project whose implementation and tests are already complete.

In plain words
What is it for?
Auditing registered tools, resources, and prompts, then completing the related documentation and metadata. It expects devcheck and tests to pass first.
Why use it?
It helps bring the server’s public documentation and metadata in line with what it actually provides before release or publication.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions .claude-plugin; mentions CLAUDE.md; mentions Claude Code.

Part of the gbif-biodiversity-mcp-server plugin — 33 skills, 1 MCP server shipped together

Good fit Auditing registered tools, resources, and prompts, then completing the related documentation and metadata. It expects devcheck and tests to pass first.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/cyanheads/gbif-biodiversity-mcp-server/polish-docs-meta
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add cyanheads/gbif-biodiversity-mcp-server --skill polish-docs-meta
Clone the repo
git clone --depth 1 https://github.com/cyanheads/gbif-biodiversity-mcp-server

Made for: Claude Code.

Or install gbif-biodiversity-mcp-server, the plugin that ships this one along with the rest of its 33 skills, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for polish-docs-meta

README.md
[![agentmods](https://agentmods.dev/badge/skills/cyanheads/gbif-biodiversity-mcp-server/polish-docs-meta/github.svg)](https://agentmods.dev/skills/cyanheads/gbif-biodiversity-mcp-server/polish-docs-meta)
Your own site
<a href="https://agentmods.dev/skills/cyanheads/gbif-biodiversity-mcp-server/polish-docs-meta"><img src="https://agentmods.dev/badge/skills/cyanheads/gbif-biodiversity-mcp-server/polish-docs-meta/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for polish-docs-meta

Your own site · 80×15
<a href="https://agentmods.dev/skills/cyanheads/gbif-biodiversity-mcp-server/polish-docs-meta"><img src="https://agentmods.dev/badge/skills/cyanheads/gbif-biodiversity-mcp-server/polish-docs-meta.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 54 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 5,394 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 100% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00054 $0.05394
Opus 5.5 $0.00022 $0.02158
Sonnet 5.5 $0.00011 $0.01079
Haiku 4.5 $0.00005 $0.00539

Measured 3d ago against content hash 0c4dd74c4641, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

polish-docs-meta scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

100% identical to polish-docs-meta — 21 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

framework-skills/polish-docs-meta/SKILL.md · 287 lines

How it starts

The opening of the file, as written. The whole thing — 287 lines — stays where its author put it; the contents beside it link to each section on GitHub.

When to Use

  • Server implementation is functionally complete (tools, resources, prompts, services all working)
  • bun run devcheck passes, tests pass
  • You're preparing for first commit, first release, or making the repo public
  • User says "polish", "polish docs", "finalize", "make it ship-ready", "clean up docs", or similar
  • Re-running after adding/removing tools, resources, or other surface area changes

Prefer running after implementation is complete, but safe to re-run at any point — steps are idempotent.

Companion: pair with security-pass for a full pre-ship review — this skill polishes docs and metadata; security-pass audits handlers for MCP-specific security gaps.

Prerequisites

  • All tools/resources/prompts implemented and registered
  • bun run devcheck passes
  • Tests pass (bun run test)

If these aren't met, address them first.

Steps

1. Audit the Surface Area

Read all tool, resource, and prompt definitions. Build a mental model of what the server actually does — names, descriptions, input/output shapes, auth scopes. This inventory drives every document below.

Read:

  • src/index.ts (what's registered in createApp())
  • All files in src/mcp-server/tools/definitions/
  • All files in src/mcp-server/resources/definitions/
  • All files in src/mcp-server/prompts/definitions/
  • All files in src/services/ (if any)
  • src/config/server-config.ts (if any)

Capture: tool count, resource count, prompt count, service count, required env vars.

2. README.md

Read the gold standard first: the pubmed-mcp-server README — https://github.com/cyanheads/pubmed-mcp-server/blob/main/README.md (or ../pubmed-mcp-server/README.md when that repo is checked out beside this one). Mirror its structure, section order, heading forms, and density. Reuse its non-server-specific content as-is — the framework line under Features, and the Getting started / Configuration / Running the server / Development guide / Contributing boilerplate — and tune only what is server-specific: the header, the Overview description, the primitives and their Capability reference entries, the domain-specific and agent-friendly bullets, env vars, project structure. Then read references/readme.md for the conventions spelled out; where it and the pubmed README disagree, the README wins — note the discrepancy in your report rather than editing the reference.

Read the full file on GitHub · 287 lines

Files

What ships with it

4 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago Changed 0c4dd74c4641
  2. 17d ago Changed · +1 lines 4a671f3c402d
  3. 1mo ago Changed · +9 lines a35cfa92eff5
  4. 1mo ago First seen · 277 lines · 54 tokens per session scan A 50926cd53e50

Subscribe to this mod's changes

polish-docs-meta is a skill published in the GitHub repository cyanheads/gbif-biodiversity-mcp-server (1 stars, last pushed 3d ago), licensed Apache-2.0. It adds 54 tokens to every session and 5,394 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. It is 100% identical to polish-docs-meta, differing in 21 lines, and is treated as a copy.

Related

Other skills, from other repositories

search

Hybrid search across Captain Memo's local memory + skills + observations. Use when the user types /captain-memo:search to retrieve top hits without the model having to decide whether to call searchall on its own.

kalinbogatzevski/captain-memo · 49 tokens

doctor

Health probe across the worker, embedder, summarizer, queue, vector index, schema, cross-AI wiring and plugin install (cache and live versions). Use when the user types /captain-memo:doctor or when something seems wrong.

kalinbogatzevski/captain-memo · 52 tokens

openstreetmap-guide

Use openstreetmap tools for OSM feature surveys, boundary-scoped searches, tag-based discovery, or Overpass QL. Resolve object references and check scope, coverage, and pagination before drawing absence or completeness conclusions.

cyanheads/openstreetmap-mcp-server · 50 tokens

wtf-happened

Retrieve a distilled timeline of the current troubleshooting incident and generate a runbook skeleton. Returns a concise summary by default, or the full untruncated timeline on request.

Wave-Engineering/mcp-server-wtf · 0 tokens

wtf-now

Add a manual observation to the WTF flight recorder journal. The entry is stored as a crafted (intentional) record. Classification of the entry's action type is handled by the background classifier — do not attempt to infer it here.

Wave-Engineering/mcp-server-wtf · 0 tokens

wtf

Launch the WTF flight recorder for a new troubleshooting incident. Archives any prior incident, prompts for an optional title, then puts Claude into flight recorder mode where significant observations, theories, and corrective actions are journaled automatically.

Wave-Engineering/mcp-server-wtf · 0 tokens