CtrlK
BlogDocsLog inGet started
Tessl Logo

adk-engineer

Execute software engineer specializing in creating production-ready ADK agents with best practices, code structure, testing, and deployment automation. Use when asked to "build ADK agent", "create agent code", or "engineer ADK application". Trigger with relevant phrases based on skill purpose.

59

Quality

51%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/ai-ml/jeremy-adk-software-engineer/skills/adk-engineer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

67%

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

The description establishes a clear domain (ADK agent development) and includes an explicit 'Use when' clause with trigger phrases, which is good. However, it suffers from vague capability descriptions that read more like category labels than concrete actions, and the final sentence 'Trigger with relevant phrases based on skill purpose' is meaningless padding that adds no value. The description would benefit from more specific actions and expanded trigger terms.

Suggestions

Replace vague category labels with concrete actions, e.g., 'Scaffolds ADK agent projects, writes agent logic and tool definitions, generates unit/integration tests, and configures deployment pipelines'.

Expand trigger terms to include natural variations users might say: 'ADK project', 'Agent Development Kit', 'agent tools', 'deploy ADK', 'agent testing', 'adk scaffold'.

Remove the meaningless filler sentence 'Trigger with relevant phrases based on skill purpose' — it provides no useful information for skill selection.

DimensionReasoningScore

Specificity

Names the domain (ADK agents) and mentions some areas like 'code structure, testing, and deployment automation', but these are high-level categories rather than concrete specific actions. 'Creating production-ready ADK agents' is somewhat specific but lacks detail on what concrete actions are performed (e.g., scaffold project, write unit tests, configure CI/CD).

2 / 3

Completeness

Explicitly answers both 'what' (creating production-ready ADK agents with best practices, code structure, testing, deployment automation) and 'when' (with a 'Use when' clause listing specific trigger phrases). Both components are present and explicit, though the quality of each could be improved.

3 / 3

Trigger Term Quality

Includes some relevant trigger phrases like 'build ADK agent', 'create agent code', 'engineer ADK application', but the final sentence 'Trigger with relevant phrases based on skill purpose' is meaningless filler. Missing natural variations users might say like 'ADK project', 'agent development kit', 'deploy agent', 'agent testing'.

2 / 3

Distinctiveness Conflict Risk

The ADK-specific focus provides some distinctiveness, but terms like 'production-ready', 'best practices', 'code structure', and 'testing' are very generic and could overlap with general software engineering or other agent framework skills. The acronym 'ADK' without expansion could also cause confusion.

2 / 3

Total

9

/

12

Passed

Implementation

35%

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

This skill reads more like a project management checklist than an engineering skill. It describes what to do at a high level but never shows how—there are no code snippets, no concrete commands, no file templates, and no executable examples. The workflow has reasonable structure but lacks the specificity and validation rigor needed for a production engineering skill.

Suggestions

Add concrete, executable code examples: show an actual ADK agent scaffold (e.g., a minimal `agent.py`, `tools.py`, and `test_agent.py`) rather than describing what files should exist in prose.

Include specific commands for each workflow step, e.g., `adk create my_agent`, `pytest tests/`, `adk deploy --project=...` so Claude knows exactly what to run.

Replace the prose-based examples with input/output pairs that include actual code: show the before/after of a refactored agent or the concrete file layout of a multi-agent system.

Add explicit validation checkpoints with expected outputs, e.g., 'Run `pytest -v` and verify all tests pass before proceeding to deployment step.'

DimensionReasoningScore

Conciseness

The content is mostly efficient but includes some unnecessary framing (e.g., 'Engineer production-ready Agent Development Kit (ADK) agents and multi-agent systems: clean structure, testability, safe tool usage, and deployment automation' repeats the overview). The examples are high-level descriptions rather than concrete code, which adds words without adding much value. Some sections like 'Overview' restate what the instructions already convey.

2 / 3

Actionability

The skill provides no executable code, no concrete commands, no specific file contents, and no copy-paste-ready examples. Instructions are entirely abstract ('Scaffold structure', 'Implement incrementally', 'Add operational guardrails') without showing what any of these look like in practice. The examples section describes inputs and outputs in prose rather than showing actual code or commands.

1 / 3

Workflow Clarity

The six-step workflow provides a reasonable sequence, and step 6 mentions local validation. However, validation checkpoints are vague ('Validate locally (tests + smoke prompts)') without specific commands or expected outputs. There's no explicit feedback loop for fixing issues during the build process—the error handling section is separate and generic rather than integrated into the workflow steps.

2 / 3

Progressive Disclosure

The skill references a detailed playbook at `${CLAUDE_SKILL_DIR}/references/SKILL.full.md` and external repo standards, which is good progressive disclosure structure. However, no bundle files were provided to verify these references exist, and the main SKILL.md itself contains content that could be more concise if it properly delegated details to the referenced files. The references are clearly signaled but their existence cannot be confirmed.

2 / 3

Total

7

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

9

/

11

Passed

Repository
jeremylongshore/claude-code-plugins-plus-skills
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.