Adk Verify Snippets

What it does

When your agent uses it

• The user asks to verify
• Validate the code samples in a README
• A documentation page
• Wants to know which snippets in a Markdown file are broken

Example prompts

• “t use for running the project”
• “Use the adk-verify-snippets skill to check that every Python code block in a Markdown file actually compiles and runs, by extracting each block to a…”
• “/adk-verify-snippets”

Requirements

• Python 3
• A credential in GEMINI_API_KEY
• A credential in GOOGLE_API_KEY

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

1. 1An ADK development environment — run from the repository root with the uv
2. 2coverage, optional. It is not a declared project dependency, so install it
3. 3A Gemini API key, needed only for snippets that build an Agent, App, or

What it can do on your machine

Read from SKILL.md and the folder at commit 097ae1e. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 2 files in scripts/ (Python), which the agent can run.

  Shell commands in SKILL.md call:

  • uv

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • GOOGLE_API_KEY
  • GEMINI_API_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Adk Verify Snippets loads about 1.4k tokens when it runs. Until then it costs about 170 tokens; SKILL.md has 654 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~170

When it runs · the whole SKILL.md, loaded when a task matches

~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from google/adk-python at commit 097ae1e, republished under its Apache-2.0 licence (© google). 654 words, ~1,411 tokens.

name

adk-verify-snippets

description

Checks that every Python code block in a Markdown file actually compiles and runs, by extracting each block to a temporary file, executing it in an isolated subprocess, and writing a pass/fail report with per-snippet coverage. Use when the user asks to verify, test, or validate the code samples in a README, a guide, or a documentation page; wants to know which snippets in a Markdown file are broken or out of date; or asks for a snippet verification report. Don't use for running the project's test suite (run pytest directly), for checking code style or formatting (use `adk-style`), or for authoring a new runnable sample agent (use `adk-sample-creator`).

uv run --no-sync python .agents/skills/adk-verify-snippets/scripts/verify_md.py {path_to_markdown_file}

<!-- verify-snippets: ignore -->
```python
# pseudo-code — not runnable as-is
my_agent = Agent(model="gemini-ultra-hypothetical", ...)
```

© google, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in .agents/skills/adk-verify-snippets of google/adk-python.

• SKILL.md
• scripts/run.py
• scripts/verify_md.py

Open the folder on GitHubat commit 097ae1e