docs-and-api-reference

A writing and maintenance guide for developer documentation and API reference across a product’s command line, API, web interface, and MCP tools. It requires examples and interfaces to stay consistent with shared source definitions.

In plain words
What is it for?
Use it when writing quickstarts, API or CLI reference, MCP documentation, web guides, and changelogs for features shared across interfaces.
Why use it?
It reduces documentation drift, where different interfaces describe the same feature differently or show outdated request formats.

Skill for Claude CodeCodex

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.

agentmods
npx agentmods add skills/webhook-co/webhook/docs-and-api-reference
Any agent
npx skills add webhook-co/webhook --skill docs-and-api-reference
Clone the repo
git clone --depth 1 https://github.com/webhook-co/webhook

Made for: Claude Code, Codex.

Per session 47 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 417 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found 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 $0.00047 $0.00417
Opus 5 $0.00023 $0.00209
Sonnet 5 $0.00009 $0.00083
Haiku 4.5 $0.00005 $0.00042

Measured yesterday against content hash 12a63b5dd204, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

docs-and-api-reference 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 yesterday.

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.

.claude/skills/docs-and-api-reference/SKILL.md · 43 lines

What it actually says

Docs & API reference

Produce clear, on-voice developer documentation and keep every surface documented at parity.

Parity is the core job

A capability exists on CLI, API, web, and MCP identically — so it must be documented on all four. When you document a feature:

  1. Show it across each relevant surface (CLI command, API request, web flow, MCP tool).
  2. Use the same payload/types across surfaces (sourced from shared/); don't invent per-surface shapes.
  3. Cross-link the surfaces so a reader can switch between them.

Voice & style

  • Follow the writing-voice rule: precise, quietly opinionated, developer-to-developer, dry wit that never costs clarity.
  • Lowercase webhook.co / wbhk.my; sentence case for headings and UI labels.
  • Lead with what the reader can do; runnable examples over prose. Every code sample should work.

Source of truth

  • API reference is generated from the spec (SDKs via Speakeasy/Stainless) — keep prose docs in sync with the generated reference; don't hand-maintain endpoint tables that drift.
  • Document Standard Webhooks signing/verification using the spec's terms (send and receive).

Guardrails

  • This repo is public-safe: no prices, tiers, cost figures, margins, or business strategy in any doc. Describe pricing only qualitatively (transparent, predictable, soft-cap that pauses) if at all.
  • Never include secrets, real tokens, or account IDs in examples — use clear placeholders.

Progressive disclosure

Keep this skill lean; put doc-site structure, frontmatter conventions, and per-surface example templates in references/.

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. yesterday First seen · 43 lines · 47 tokens per session scan A 12a63b5dd204

Subscribe to this mod's changes

docs-and-api-reference is a skill published in the GitHub repository webhook-co/webhook (0 stars, last pushed 6d ago), licensed Apache-2.0. It adds 47 tokens to every session and 417 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

update-saasmail

Sync the local saasmail repo with the latest upstream changes from https://github.com/choyiny/saasmail. Use this skill whenever the user wants to update saasmail, pull upstream changes, sync with upstream, rebase on upstream, get the latest saasmail, or says "/update-saasmail". Handles adding the upstream remote if…

choyiny/saasmail · 105 tokens

story-html-publisher

Final step of the AI Storybook pipeline. Consolidates the scenes, images, and per-scene audio into ONE self-contained HTML storybook — a swipe/tap player with every image and audio clip embedded as base64 so the single file works offline and can be shared as-is. Reads {slug}scenes.json, {slug}images.json, and…

hassancs91/claude-image-generation · 207 tokens

github-code-review

Comprehensive GitHub code review with AI-powered swarm coordination.

aegntic/cldcde · 15 tokens

Pair Programming

AI-assisted pair programming with multiple modes (driver/navigator/switch), real-time verification, quality monitoring, and comprehensive testing. Supports TDD, debugging, refactoring, and learning sessions. Features automatic role switching, continuous code review, security scanning, and performance optimization with…

aegntic/cldcde · 61 tokens

sparc-methodology

SPARC (Specification, Pseudocode, Architecture, Refinement, Completion) comprehensive development methodology with multi-agent orchestration.

aegntic/cldcde · 29 tokens

Skill Builder

Create new Claude Code Skills with proper YAML frontmatter, progressive disclosure structure, and complete directory organization. Use when you need to build custom skills for specific workflows, generate skill templates, or understand the Claude Skills specification.

aegntic/cldcde · 46 tokens