skilld
All skills
google avatar

/adk-style

@29933ce
by googlegoogle/adk-python22k stars
4,084

Python style and codebase conventions for ADK (Agent Development Kit): private-by-default file visibility, imports, type hints, Pydantic v2 models, formatting, docstrings, logging, async I/O, file and test layout, and unit test structure. Use when writing or editing ADK source or tests, deciding whether a new file or symbol should be public or private, naming or placing a test file, fixing a formatter, linter, or type-check failure (pyink, isort, ruff, mypy, addlicense, compliance-checks), or asking whether code matches house style. Don't use for reviewing a whole changeset (use adk-review), writing a developer guide or design doc for a code unit (use adk-unit-guide or adk-unit-design), building or configuring agents (use adk-agent-builder), or installing the toolchain (use adk-setup).

Ask your Agent

Use this Skill: https://skilld.dev/gh/google/adk-python/adk-style

This session only. Nothing lands on disk.

referencesfile-organization.md

≈285 tokens on demand. Your agent reads this file only when SKILL.md points to it.

File Organization

  • One class per file in workflow/.
  • New modules under src/google/adk/ are private by default — see the visibility reference for the naming rules and how to expose a public symbol.

File Headers

Every module under src/google/adk/ starts with:

  1. The Apache 2.0 license header (added by the addlicense hook).
  2. from __future__ import annotations.
  3. Imports: standard library, third party, then relative.

from __future__ import annotations is checked by scripts/compliance_checks.py, which exempts __init__.py, version.py, tests/, and contributing/samples/.

Where tests go

Mirror the source path under tests/unittests/:

src/google/adk/tools/environment/_edit_file_tool.py
tests/unittests/tools/environment/test_edit_file_tool.py

When one source file needs several test files, use the source file name — without the leading underscore or extension — as a shared prefix:

src/google/adk/workflow/_workflow.py
tests/unittests/workflow/test_workflow.py
tests/unittests/workflow/test_workflow_hitl.py
tests/unittests/workflow/test_workflow_nested.py

Source: SKILL.md on GitHub

Third-party checks

No alerts16d3 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    This skill provides comprehensive Python style and codebase conventions for the Agent Development Kit (ADK). It covers visibility, imports, typing, Pydantic models, formatting, and testing, all of which align with standard software development best practices.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

Provenance

Signed by skilld at 29933ce. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 months ago

README badge

README badge for google/adk-python/adk-style