CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agm-validate-change

Establish change scope and select focused validation evidence for an Antigravity Manager change. Use after implementation or before reporting work complete; do not use for read-only analysis or semantic code review.

64

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/agm-validate-change/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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.

A tight, highly actionable instruction-only skill: exact pnpm commands, explicit failure-handling and re-validation loops, and clean one-level-deep delegation to repo docs. It falls short of top marks only where steps stay directional (Prettier, Playwright) and where the evidence-selection section is a rule list rather than an ordered checklist.

Suggestions

Give the exact commands for the directional steps, e.g. the Prettier invocation for changed doc paths and how to run focused Playwright evidence (actionability).

Convert the 'Select evidence' bullets into a short ordered decision sequence with an explicit checkpoint per change category (workflow_clarity).

Trim the Git-hooks behavioral detail (index blobs, ESLint configuration) to a single sentence linking docs/development.md, since the hook specifics live there anyway (conciseness).

DimensionReasoningScore

Conciseness

The body is dense, project-specific policy with zero concept explanations Claude already knows — every line carries repo-specific rules like "Code lint reads index blobs with the current ESLint configuration". A few passages (the Git-hooks paragraph and the upgrade-guide bullet) carry detail that could be trimmed or delegated to the referenced docs, matching 'efficient; minor instances of over-explanation that could be trimmed' rather than the every-token-earns-its-place anchor at 5.

4 / 5

Actionability

Much of the guidance is executable with exact commands ("pnpm run change-scope --base HEAD", "pnpm run type-check", "pnpm run check:agent-contracts", "pnpm run check:ci --list") and precise ownership rules, but several steps remain directional without the command — "Run Prettier against changed documentation paths" and "Add focused Playwright evidence" — leaving minor gaps that keep it below the fully copy-paste-ready anchor at 5.

4 / 5

Workflow Clarity

The phases are clearly ordered (Inspect the change → Select evidence → Handle results → Pull request checks → Report) with an explicit failure feedback loop ("If a relevant check fails, diagnose that failure before widening scope. Do not skip it") and re-validation rules ("recalculate the changed paths and rerun only evidence affected by the new diff"). However, 'Select evidence' is a policy bullet list rather than an ordered procedure with checkpoints, and validation checkpoints within evidence selection are implicit, so it sits at 'clear sequence with most checkpoints present' rather than the explicit-checkpoint anchor at 5.

4 / 5

Progressive Disclosure

The body is under 50 lines, organized into clear sections, and acts as an overview that delegates detail to one-level-deep, purpose-signaled references — "[Testing strategy](../../../docs/testing.md) owns the change-to-evidence mapping", "follow [scripts/AGENTS.md](../../../scripts/AGENTS.md) before execution", "use [test reliability](../../../docs/test-reliability.md)" — each stating what the referenced file provides. No references/, scripts/ or assets/ bundle directories exist alongside this SKILL.md, and the per-skill guideline allows a 5 for a sub-50-line skill with well-organized sections and no need for in-bundle external references.

5 / 5

Total

17

/

20

Passed

Description

75%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 concise, third-person description with an explicit what and explicit positive and negative when-triggers, clearly separated from sibling analysis/review skills. Its main weakness is thin keyword coverage and an abstract 'what' that never names the concrete evidence it selects.

Suggestions

Broaden trigger coverage with natural synonyms users would actually say, e.g. 'Use when asked to validate, verify, or test an Antigravity Manager change' (trigger_term_quality).

Make the what-clause more concrete by naming the evidence types it selects, e.g. 'run the owning unit or integration tests, type-check, and focused Playwright evidence' (specificity).

DimensionReasoningScore

Specificity

The description names the domain ("an Antigravity Manager change") and two concrete actions — "Establish change scope" and "select focused validation evidence" — which matches the anchor for 1-2 concrete actions without comprehensive coverage; it does not list the several specific actions (run owning tests, type-check, lint/contract checks) that would justify a 4.

3 / 5

Completeness

Both parts are explicit: the what ("Establish change scope and select focused validation evidence for an Antigravity Manager change") and concrete when-triggers ("Use after implementation or before reporting work complete"), plus explicit negative triggers ("do not use for read-only analysis or semantic code review"). This matches the anchor for clearly and explicitly answering both what AND when with concrete trigger phrases, not the anchor at 4 where the 'when' could be more explicit.

5 / 5

Trigger Term Quality

Relevant keywords are present ("change", "validation", "implementation", "reporting work complete"), but common natural variations a user would say — "validate", "verify", "test this change", "run the checks" — are missing, fitting the 'some relevant keywords but missing common variations or synonyms' anchor rather than the good-coverage anchor at 4.

3 / 5

Distinctiveness Conflict Risk

The description claims a clear niche — change validation for one named project — and explicitly fences off neighboring skills ("do not use for read-only analysis or semantic code review"), giving it distinct triggers and minimal conflict risk per the top anchor rather than the 'minor overlap risk' anchor at 4.

5 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 8 suspicious

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

Draculabo/AntigravityManager

Path

.agents/skills/agm-validate-change/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.