Generate Python Runnability Test
Generates a lightweight `tests/test_runnability.py` for a Python recipe.
Install
npx skills add google/adk-recipes --skill generate-python-runnability-test -g -a claude-code -y- Repository
- google/adk-recipes10.6k
- Category
- Testing
- Updated
- 4d ago
- License
- Apache-2.0
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- Yes, review before use
What it does
Generates a lightweight `tests/test_runnability.py` for a Python recipe. The test just imports the recipe's agent module and asserts that `root_agent is not None` (and `app is not None` if the module defines one). The skill parses agent.py with `ast` to figure out which import-time side effects need mocking (`vertexai.init`, `google.auth.default`) and which env vars need setting (`GOOGLE_CLOUD_PROJECT`, `INTEGRATION_TEST`), and only emits the boilerplate the recipe actually needs. Runs in dry-run (report + preview) and apply (write to disk) modes. Use when the user wants to "add a runnability test", "generate test_runnability.py", "create a smoke test for the recipe", or fix the missing-required-file failure from `python-validate-recipe.yml`.
Generate Python Runnability Test
Use this skill to create the tests/test_runnability.py file that every Python recipe under core/python/, contrib/python/, or plugins/<vertical>/<solution>/ must ship (see python-validate-recipe.yml Check 4). The generated test is deliberately minimal, it just verifies the agent module imports and defines the expected globals. Business-logic testing lives elsewhere.
What This Skill Does
Runs scripts/generate_runnability_test.py against a recipe directory. Steps:
- Locate
agent.py. Walks the recipe safely (excludes.venv,venv,env,build,dist,__pycache__,node_modules,tests,*.egg-info, and dot-directories) and picks the shallowestagent.pymatch. If none is found, errors out and suggests--agent-file. Only one file is generated per invocation.
