CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

coding-workflow

How to work in a code repository under ~/code. Use for any thread that diagnoses, fixes, changes, reviews, or tests code.

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

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.

An exemplary lean instruction-only skill: every line is specific, actionable, and tailored to this environment, with clear behavioral rules and verification requirements. The only gap is the absence of an explicit error-recovery feedback loop in the fix-then-verify workflow, which keeps workflow clarity at 4.

DimensionReasoningScore

Conciseness

The ~20-line body is lean with zero padding or explanations of concepts Claude already knows — every line is environment-specific instruction ("check `git status` first", "Report meaningful findings during the run with `update_user` on `voice_agent`") — matching anchor 5 (every token earns its place); anchor 4 would require some trimmable over-explanation, which is absent.

5 / 5

Actionability

Guidance is fully concrete for an instruction-only skill: named files (`AGENTS.md`, `CLAUDE.md`, `CONTRIBUTING.md`, `README.md`), a specific command (`git status`), quoted user trigger phrases ("Why is this failing", "figure out", "look into", "review", "explain"), and named tools (`github__*` on `voice_agent`, `request_permission`) — matching anchor 5's 'specific examples cover the common cases' with no minor gaps that would justify a 4.

5 / 5

Workflow Clarity

A clear sequence is present with explicit ordering cues ("check `git status` first", "Reproduce first with a failing test or command", "when the turn ends") and validation checkpoints ("Run existing tests, linters, and type checkers, and report only checks you actually ran"), but no explicit error-recovery feedback loop (e.g., 'if the test still fails, fix and re-run') is spelled out, matching anchor 4 rather than anchor 5.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no external references needed, and the content is well-organized into clearly labeled sections (Diagnose without changing, Fixing, Verifying, Git & GitHub, Finishing); per the simple-skill guideline, this merits anchor 5 — no bundle files exist, so nothing is inlined that belongs elsewhere.

5 / 5

Total

19

/

20

Passed

Description

80%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, compact description with an explicit 'Use for...' trigger clause enumerating five concrete action verbs, which satisfies both the what and when requirements. Its main weaknesses are the generic opening clause and a broad trigger that risks overlap with dedicated review/testing skills in the code category.

Suggestions

Make the 'what' clause enumerate the concrete capabilities (e.g., "Diagnose failures, fix bugs, make minimal changes, review code, and run verification in code repositories under ~/code") instead of the generic "How to work in a code repository".

Add missing natural trigger synonyms such as "debug", "bug", "refactor", or "build" that users commonly say when they need this skill.

Narrow the trigger to reduce conflict risk with dedicated review or testing skills, e.g., "Use for any thread in a ~/code repository that diagnoses, fixes, changes, reviews, or tests code".

DimensionReasoningScore

Specificity

The trigger clause lists several concrete actions — "diagnoses, fixes, changes, reviews, or tests code" — but the opening 'what' ("How to work in a code repository under ~/code") is generic and capabilities like git/PR handling are absent, matching anchor 4 (several specific actions, minor gaps) rather than anchor 5's comprehensive coverage.

4 / 5

Completeness

Both parts are explicitly answered: the what ("How to work in a code repository under ~/code" plus the five enumerated actions) and an explicit when with concrete trigger phrases ("Use for any thread that diagnoses, fixes, changes, reviews, or tests code"), matching the anchor-5 example structure; anchor 4 does not fit because the 'when' is already fully explicit.

5 / 5

Trigger Term Quality

"diagnoses, fixes, changes, reviews, or tests code" gives good coverage of natural user verbs, matching anchor 4; it falls short of anchor 5 because common synonyms users say ("debug", "bug", "refactor", "build", "error") are missing, but it is well above anchor 3's single-phrase coverage.

4 / 5

Distinctiveness Conflict Risk

The ~/code location scoping adds some distinctiveness, but the trigger "Use for any thread that... reviews, or tests code" is broad and would fire alongside dedicated code-review, debugging, or testing skills in a crowded category, matching anchor 3 (somewhat specific but could still overlap with similar skills) rather than anchor 4's 'minor overlap risk'.

3 / 5

Total

16

/

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

google/adk-samples

Path

core/python/adk-voice-agent/sandbox/skills/coding-workflow/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.