Official agent skill

Adk Style

by google in google/adk-python

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…

OfficialApache-2.0Auto-check passedDevelopment

Install Adk Style

skills CLI
$ npx skills add google/adk-python --skill adk-style -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install google/adk-python adk-style --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/google/adk-python.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/adk-style .claude/skills/adk-style && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
adk-style
GitHub stars
22k
Token cost
~748 tokens
SKILL.md length
201 words
Files
11 (incl. references)
Skills in repo
13
Repo updated
First seen
Licence
Apache-2.0

At a glance

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…

  • Editing ADK source
  • SKILL.md covers Pick a reference and A check failed — where to look
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Deciding whether a new file

What it does

Adk Style is an agent skill from google/adk-python, published by the product's own GitHub organization. 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…

Its SKILL.md is about 750 tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including reference files (for example `references/async.md`, `references/documentation.md` and `references/file-organization.md`).

It sits in Development, covering Linting and formatting, Type safety and Technical documentation. It works with Pydantic, Ruff and Python. The repository describes itself as: An open-source, code-first Python toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control. The licence is Apache-2.0.

When your agent uses it

  • Editing ADK source
  • Deciding whether a new file
  • Symbol should be public
  • Placing a test file

Example prompts

  • “/adk-style”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 666c26d. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Adk Style loads about 748 tokens when it runs, and up to ~8.6k if it reads all its reference files. Until then it costs about 202 tokens; SKILL.md has 201 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~202
When it runs · the whole SKILL.md, loaded when a task matches
~748
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.6k

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

Auto-check passed

The automated check found no risky patterns in SKILL.md.

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from google/adk-python at commit 666c26d, republished under its Apache-2.0 licence (© google). 201 words, ~748 tokens.

Download SKILL.mdSave it as .claude/skills/adk-style/SKILL.md (or your agent's skills folder). This skill also uses 10 other files; get the full folder from GitHub.
name
adk-style
description
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).

ADK Style Guide

Conventions for src/google/adk/ and tests/unittests/. Most are enforced by a pre-commit hook or a CI job, so a violation blocks the PR rather than surfacing in review. Read the one reference for the topic you are touching.

Pick a reference

TaskReference
Adding a .py file; deciding public vs private; __init__.py and __all__visibility.md
Writing import lines; relative vs absolute; circular imports; TYPE_CHECKING; lazy importsimports.md
Annotating args and returns; Optional vs | None; keyword-only args; isinstance; asserts; mypy; # type: ignore and casttyping.md
Defining a Pydantic model, validator, private attribute, or on-wire payloadpydantic.md
Indentation, line length, quotes; running the formatter; what each hook checksformatting.md
Writing a docstring or an explanatory commentdocumentation.md
Emitting a log record; naming the module logger; picking a levellogging.md
Anything that performs I/O — network, disk, databaseasync.md
Where a new file goes; license header; where its test goes and what to call itfile-organization.md
Writing or restructuring a unit test; the testing_utils fakestesting.md

A check failed — where to look

Failing checkReference
check-new-py-prefixvisibility.md
compliance-checkslogging.md (logger name), typing.md (from __future__ import annotations), imports.md (cli/ import direction)
pyink, isort, ruff, addlicense, codespellformatting.md
Mypy Check CI jobtyping.md
tests/unittests/test_import_loading.pyimports.md

© 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 10 other files (references) in .agents/skills/adk-style of google/adk-python.

  • SKILL.md
  • references/async.md
  • references/documentation.md
  • references/file-organization.md
  • references/formatting.md
  • references/imports.md
  • references/logging.md
  • references/pydantic.md
  • references/testing.md
  • references/typing.md
  • references/visibility.md

Open the folder on GitHubat commit 666c26d

Compare with similar skills

Adk Style next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Adk Style compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Adk Style this skillgoogle/adk-python22k—~748Automated safety check: PassApache-2.0
Kedro Babysitkedro-org/kedro11k—~4kAutomated safety check: PassCustom licence
Repo Guardsimovilab/databus101—~1.3kAutomated safety check: PassApache-2.0
Python ProJeffallan/claude-skills12k—~1.6kAutomated safety check: PassMIT
Vibe Python Style Guidemistralai/mistral-vibe5.1k—~1.2kAutomated safety check: PassApache-2.0
Modern Pythonantoinebou12/uml-mcp105—~1kAutomated safety check: PassMIT

Similar skills

  • Kedro Babysit

    kedro-org/kedro

    Run Kedro's local lint / format / type-check / tests on changed files (uses the project's pre-commit hooks, ruff, mypy, pytest, lint-imports, detect-secrets, Make targets — in the right venv), or…

    11k GitHub stars~4k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Repo Guard

    simovilab/databus

    Keep the databus repo clean as it grows — verify new/changed backend code meets the project's docstring, type-hint, and structural conventions, and update any docs the change made stale.

    101 GitHub stars~1.3k tokensUpdated 29 days ago
    DevelopmentAuto-check passed
  • Python Pro

    Jeffallan/claude-skills

    Writes type-annotated Python 3.11+ with async patterns, dataclasses and pytest suites, validated with mypy in strict mode, black and ruff.

    12k GitHub stars~1.6k tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • Vibe Python Style Guide

    mistralai/mistral-vibe

    Official

    Python conventions for the Mistral Vibe codebase covering style, strict typing, imports, Pydantic patterns, logging, error handling and file I/O.

    5.1k GitHub stars~1.2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Modern Python

    antoinebou12/uml-mcp

    Modern Python tooling and best practices using uv, ruff, ty, and pytest.

    105 GitHub stars~1k tokensUpdated today
    DevelopmentAuto-check passed
  • Specx Project Tooling

    maksimzayats/specx

    Add strict Python project tooling for a specx service. An agent skill from maksimzayats/specx.

    202 GitHub stars~965 tokensUpdated 2 mo ago
    DevelopmentAuto-check passed

More from google/adk-python

All 13 skills in this repo
  • Adk Verify Snippets

    google/adk-python

    Official

    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…

    22k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Adk Sample Creator

    google/adk-python

    Official

    Creates a new sample agent in the ADK Python repository — the sample directory, its agent.py, and its README.md — following the conventions the existing samples already use.

    22k GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Adk Unit Guide

    google/adk-python

    Official

    Writes a hands-on developer guide for one ADK code unit — a minimal runnable example, how it works, a configuration-option table, advanced uses, limitations, and links to related samples — to…

    22k GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Adk Git

    google/adk-python

    Official

    Writes commit messages and pull request descriptions for the adk-python repository: Conventional Commits types and scopes, subject lines that say why a change was made, and the linked-issue and…

    22k GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Adk Setup

    google/adk-python

    Official

    Sets up a local ADK Python development environment in a git clone of the open-source adk-python repository: a uv virtual environment, all dependency extras, pre-commit hooks, and a first unit-test…

    22k GitHub stars~993 tokensUpdated today
    Auto-check: notes
  • Adk Agent Builder

    google/adk-python

    Official

    Builds ADK (Agent Development Kit) Python agents: LLM agents with tools, graph workflows of function and agent nodes, conditional routing, fan-out and join, schema-validated delegation between…

    22k GitHub stars~879 tokensUpdated today
    Auto-check passed

Categories

Questions about Adk Style

What does Adk Style do?

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…. Adk Style is an agent skill from google/adk-python, published by the product's own GitHub organization. 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.

When should I use Adk Style?

Adk Style fits situations like: editing ADK source; deciding whether a new file; symbol should be public; placing a test file.

How do I install Adk Style in Claude Code?

Run `npx skills add google/adk-python --skill adk-style -a claude-code`. Or copy the skill folder (.agents/skills/adk-style in google/adk-python) into .claude/skills/adk-style in your project. Claude Code loads it when a task matches its description.

How do I install Adk Style in Codex?

Run `npx skills add google/adk-python --skill adk-style -a codex`. Or copy the skill folder (.agents/skills/adk-style in google/adk-python) into .agents/skills/adk-style in your project. Codex loads it when a task matches its description.

Can I use Adk Style in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add google/adk-python --skill adk-style -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/adk-style, .gemini/skills/adk-style, .github/skills/adk-style and .opencode/skills/adk-style in your project.

What does Adk Style need to run?

SKILL.md names no scripts, command-line tools or credentials: Adk Style is instructions for the agent only. Our summary lists: Python 3.

Does Adk Style access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Adk Style safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Adk Style use?

Adk Style is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Adk Style use?

About 748 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.8k tokens, read only when the agent opens those files.

What are the alternatives to Adk Style?

Skills that share tags, products or a category with Adk Style: Kedro Babysit (kedro-org/kedro, 11k stars), Repo Guard (simovilab/databus, 101 stars), Python Pro (Jeffallan/claude-skills, 12k stars) and Vibe Python Style Guide (mistralai/mistral-vibe, 5.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Adk Style?

google (a GitHub organization, an official publisher) maintains it in google/adk-python, which has 21,729 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on October 7, 2026.

Source: google/adk-python on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.