CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

google-adk-setup

Bootstrap a Google ADK (Agent Development Kit) project from zero to a running local dev UI. Use when setting up a new ADK agent project, configuring Vertex AI credentials, scaffolding the agent folder, or troubleshooting ADK environment issues. Trigger on: adk setup, adk init, google-adk, vertex ai agent, uv run adk, adk web.

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

93%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is an exemplary lean setup guide: executable commands at every step, concrete prompt values, non-obvious operational facts, and a clean split that pushes full CLI and deployment detail into a real, clearly linked reference file. The single gap is the absence of an explicit inline validation/retry checkpoint in the workflow, with error recovery delegated to a troubleshooting table instead.

DimensionReasoningScore

Conciseness

The body is lean command blocks, env-var listings, and non-obvious gotchas like "The `.env` lives inside the `agent/` directory (not the project root)" and "`--reload_agents` hot-reloads agent code on file changes; omit in production". It explains nothing Claude already knows, so every token earns its place (anchor 5) rather than merely being efficient with minor trims (anchor 4).

5 / 5

Actionability

Fully copy-paste ready commands throughout: "uv init agent-project", "uv add google-adk", "uv run adk create agent", "uv run adk web --reload_agents", with specific interactive-prompt values ("Model: `gemini-2.5-flash`", "Location: `global`") and a concrete symptom-to-fix troubleshooting table. Specific examples cover the common cases (dev UI, CLI mode, Cloud Shell origins), matching anchor 5.

5 / 5

Workflow Clarity

A clear five-step sequence (create project → scaffold agent → verify `.env` → run dev UI → run CLI) is present, with one explicit checkpoint ("Verify the `.env` file") and a troubleshooting table for error recovery. It falls short of anchor 5 because there is no inline validate-and-retry loop (e.g. confirming the dev UI actually loads before proceeding); the recovery guidance lives in a separate table rather than explicit workflow checkpoints.

4 / 5

Progressive Disclosure

The body is a concise overview and the single bundle file references/cli-commands.md exists and is clearly signaled at the end ("See [references/cli-commands.md](references/cli-commands.md) for the full CLI reference"), with deployment correctly deferred ("Deploying to Cloud Run (deployment commands are in the references)"). One well-signaled, one-level-deep reference with appropriate content split matches anchor 5.

5 / 5

Total

19

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that clearly states both what the skill does and when to use it, with an explicit and natural trigger-term list covering command forms and synonyms. The only weakness is mild breadth in "troubleshooting ADK environment issues" and "vertex ai agent", which introduces minor conflict risk with closely related skills.

DimensionReasoningScore

Specificity

"Bootstrap a Google ADK (Agent Development Kit) project from zero to a running local dev UI" names the domain and multiple concrete actions: "configuring Vertex AI credentials, scaffolding the agent folder, or troubleshooting ADK environment issues". Coverage is comprehensive for a setup skill with no meaningful gaps, so it sits above the minor-gaps anchor 4.

5 / 5

Completeness

The "what" is explicit ("Bootstrap a Google ADK project from zero to a running local dev UI") and the "when" is explicit with concrete scenarios ("Use when setting up a new ADK agent project, configuring Vertex AI credentials, scaffolding the agent folder, or troubleshooting ADK environment issues"). This mirrors the anchor-5 example structure exactly; anchor 4 would require the when-clause to be less explicit.

5 / 5

Trigger Term Quality

"Trigger on: adk setup, adk init, google-adk, vertex ai agent, uv run adk, adk web" provides literal command strings users would naturally type, plus the spelled-out synonym "Agent Development Kit" and natural phrasings like "setting up a new ADK agent project". This matches the comprehensive synonym-and-command coverage of the anchor-5 example rather than the few-terms-missing anchor 4.

5 / 5

Distinctiveness Conflict Risk

Triggers are ADK-specific ("uv run adk", "adk web", "google-adk") giving a clear niche, but "troubleshooting ADK environment issues" and "vertex ai agent" are slightly broad, creating minor overlap risk with closely related skills such as agent-patterns or general Vertex AI skills. It does not reach anchor 5's "minimal conflict risk" because the description itself states no boundary against those neighbors.

4 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

saski/arnesto

Path

.agents/skills/google-adk-setup/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.