doc-tester

Audit Aspire documentation against runtime behavior using Playwright MCP navigation and snapshots.

187|81|Updated Oct 28, 2025
One-click install
npx skills add https://github.com/microsoft/aspire.dev --skill doc-tester
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-tester
Source: https://github.com/microsoft/aspire.dev/tree/main/.github/skills/doc-tester
Command: npx skills add https://github.com/microsoft/aspire.dev --skill doc-tester

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill validates Aspire documentation against actual runtime behavior by systematically auditing pages, examples, and workflows.

Core Features & Use Cases

  • Documentation auditing: verifies that docs reflect actual features, flows, and CLI behavior.
  • Gap identification: flags discrepancies between documentation and implementation to trigger doc-writer tasks.
  • Playwright-driven testing guidance: prescribes Playwright MCP tooling to navigate, snapshot, and validate pages.

Quick Start

Follow the documented testing workflow to run this skill in a dev environment. It does not require code changes; use the MCP tools to observe site behavior and report gaps.

Frequently Asked Questions about doc-tester

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate documentation against actual runtime behavior?

Documentation auditing involves verifying that pages, examples, and workflows reflect actual features and CLI behavior. It identifies discrepancies between documentation and implementation, triggering tasks for doc-writers to resolve gaps.

Can I test aspire.dev documentation without inspecting the source code?

Yes, this documentation validation approach requires no source code inspection. Testers operate strictly from the docs using Playwright MCP navigation and snapshotting to observe site behavior, reporting gaps rather than reading implementation code.

How do I audit Aspire Getting Started and Integrations pages using Playwright?

Use Playwright MCP guided navigation to traverse Getting Started, Fundamentals, and Integrations pages. Snapshot pages, collect evidence of behavioral gaps, and report blockers explicitly to fix documentation inaccuracies.

What is the best way to identify documentation gaps in a local Aspire dev setup?

Sandbox the testing process in a local Aspire dev setup and follow the documented workflow. Navigate the site with Playwright MCP tools, compare documented flows against reality, and explicitly flag discrepancies for doc-writers to resolve.

Do I need a local Aspire dev environment to run documentation validation?

Yes, a local Aspire dev environment is required. The framework is sandboxed within this local setup to safely observe runtime behavior, navigate pages with MCP tooling, and collect evidence of documentation gaps.

Why does documentation testing fail when docs do not match implementation?

Testing fails when docs do not match implementation because the framework enforces explicit reporting of blockers and gaps. It flags discrepancies between documented flows and actual CLI behavior, triggering necessary fixes by doc-writers.