What problem does it solve?
Documentation code samples silently break as APIs evolve, and manually testing every snippet in a README or guide is tedious and error-prone. This Skill automatically extracts each Python block from a Markdown file, runs it in an isolated subprocess, and produces a per-snippet verification report.
Core Features & Use Cases
- Automated snippet execution: Extracts every ```python block, writes it to a temp file, and runs it via a bundled harness that detects module-level ADK Workflow, Agent, or App components and executes them against the Gemini API.
- Structured reporting: Generates a Markdown report with an Executive Summary table (load phase, run phase, coverage, details) plus per-snippet logs and tracebacks.
- Selective skipping: Supports a
<!-- verify-snippets: ignore --> annotation to exclude pseudo-code or setup-dependent blocks.
- Use Case: Before publishing an updated ADK guide, run the verifier on the Markdown file to find which code samples fail to compile or run, then fix only the broken ones.
Quick Start
Ask the assistant to verify the Python code snippets in a specific Markdown documentation file and show the summary report.
