docs

Produce meaningful Mergify dashboard screenshots for the docs by staging a real product state in the mergify-sandbox org, capturing it, then cleaning up. Use when a docs page needs a screenshot that shows an actual state (a queue with PRs, a batch, a freeze, priority ordering), when auditing which pages are missing or have stale screenshots, or when asked to build a scenario and screenshot it. Sets up state via the sandbox-org skill, captures via the capture-screenshots skill, and tears the scenario down. Defers CI/Test Insights shots (they need real CI data). Composes with capture-screenshots, document-a-feature, docs-gap-analysis.

Capture consistent Mergify dashboard screenshots for the docs site using Chrome browser automation, save them to the correct images/ directory, and emit the ready-to-paste astro:assets import and <Image> tag with alt text. Use when adding or refreshing a dashboard screenshot in docs, when a docs page needs a UI image, or when asked to screenshot dashboard.mergify.com for documentation. Drives the claude-in-chrome MCP tools against the user's existing logged-in Chrome session.

Validate Mergify YAML configuration examples embedded in the docs against the real Mergify config JSON Schema, so broken config snippets never ship. Use after editing docs pages that contain .mergify.yml / YAML examples, when reviewing a docs PR with config snippets, or when asked to check/validate config examples in the docs. Runs `pnpm check:config-examples`, which extracts every YAML fence, classifies it, and validates the complete Mergify configs against public/mergify-configuration-schema.json.

Find undocumented or stale Mergify features by comparing what the product shipped against what the docs cover. Use when asked what is missing from the docs, to audit docs coverage, to find undocumented features, to check whether recent features/PRs are documented, or to plan documentation work. Gathers shipped-feature signal from merged PRs, Linear, and the changelog, maps it against src/content/docs/, and produces a prioritized gap report that feeds the document-a-feature skill.

Use the Mergify product source code (Mergifyio/monorepo) as the source of truth to verify or draft documentation. Use when checking whether a docs page matches how the product actually behaves, when a config key's default/enum/ behavior needs confirming against the implementation, when the schema and changelog disagree, or when drafting docs for a feature from its code/PR. Two modes: verify (audit docs against code) and draft (generate a code-grounded first draft). Reads a temporary local clone of the engine (Python/pydantic) and dashboard. Composes with proofread-technical, document-a-feature, and docs-gap-analysis.

End-to-end workflow for documenting a Mergify feature on the docs site. Use when asked to document a feature, write a new docs page, document a PR or Linear ticket, or add/update a page under src/content/docs/. Orchestrates placement, component selection, writing, site plumbing (navItems + redirects + SEO), and validation (proofread pipeline, config-example validation, build check). Composes with mdx-documentation, proofread-*, capture-screenshots, and validate-config-examples skills.

MDX and Astro documentation patterns for the Mergify docs site. Use when creating, editing, or reviewing documentation pages. Covers frontmatter, imports, components, and content structure.

Proofread documentation changes for terminology and naming consistency. Checks product terms, capitalization, and consistency with existing docs. Designed to run as a subagent on diffs of MDX files.

Proofread documentation changes for writing style. Checks for AI-sounding patterns, banned words, tone issues, and enforces natural human voice. Designed to run as a subagent on diffs of MDX files.

Proofread documentation changes for structure and completeness. Checks frontmatter, heading hierarchy, callout usage, undefined terms, and missing cross-references. Designed to run as a subagent on diffs of MDX files.

Proofread documentation changes for technical accuracy. Validates code examples, config keys, CLI commands, and feature references against the actual codebase. Designed to run as a subagent on diffs of MDX files.