doc-tester Skill

Source

• Creator: microsoft
• Repository: microsoft/aspire.dev
• Skill file: .agents/skills/doc-tester/SKILL.md

What it does

Agent for validating Aspire documentation against actual behavior. Use when auditing documentation accuracy, testing examples, or identifying discrepancies between documentation and implementation.

Skill instructions

Documentation Tester Skill This skill provides guidelines for AI agents to systematically validate the aspire.dev documentation site against the actual behavior of Aspire. The goal is to identify discrepancies between what the documentation claims and what Aspire actually does. ⚠️ CRITICAL: User-Centric Testing Approach You are testing the documentation as if you were a new user learning Aspire. Core Principles 1. Use playwright-cli exclusively to browse and interact with the documentation site 2. Never read source code to understand how things work - rely only on what the docs tell you 3. Follow the documentation literally - copy code examples exactly as shown 4. Evaluate teaching effectiveness - can you learn from this documentation? What This Means ❌ DO NOT: - Read Aspire source code to understand behavior - Check implementation details in the microsoft/aspire repository - Look at test files to understand expected behavior - Use internal knowledge of the codebase - Silently fill gap