CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

verifying-changes

Concrete, per-area proof that a change actually works before reporting it fixed, done, or "should work now" — which dev server, test command, or invocation proves a template UI change, an action, a migration, a guard, or a core/package change. Use before every wrap-up, and before stopping mid-task to ask permission instead of continuing.

Quality

86%

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

88%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 exceptionally actionable operational ruleset: every change type has an exact verification command, validation is woven through as both the goal and the checkpoint, and unverifiable situations have an explicit fallback script. Its only weaknesses are mild token redundancy (the quoted user-failure anecdotes and repeated framing) and a dense single-file structure that could offload some per-area detail to a reference file.

DimensionReasoningScore

Conciseness

The body is dense with repo-specific, non-obvious knowledge (per-template `action` scripts, the local-dev sign-in endpoint, `test:fast` exclusion suffixes) and avoids explaining concepts Claude already knows. Minor over-explanation remains: the "Real failures this replaces" quote block and some "Do NOT report done" framing restate rules already stated elsewhere, keeping it below anchor 5's every-token-earns-its-place bar.

4 / 5

Actionability

Every change area maps to a copy-paste-ready command (`pnpm --filter <app> dev`, `pnpm action <name> --key value`, `pnpm guard:<name>`, `node --experimental-strip-types --test scripts/ci-change-scope.test.ts`, `pnpm qa:deploy-paths --target node`) including edge-case workarounds like signing in via `POST /_agent-native/auth/local-dev`. The per-area table fully covers the common cases with executable commands.

5 / 5

Workflow Clarity

The process is unambiguous and validation is the skill's explicit subject: scale the verification, run the per-area proof, put the proof in the reply, and state the exact gap when verification is impossible. Validation checkpoints and feedback loops are explicit throughout ("A failing check is a reason to keep working"; the guard row requires testing both a case that should pass and one that should still fail; the migration row boots then reads back the new column).

5 / 5

Progressive Disclosure

The single file is well-organized with clear sections, the "Proof by area" table is core content that belongs inline, and there are no buried or nested references. However, at roughly 100 body lines with a very dense table and no reference files to offload per-area detail, it exceeds the under-50-line simple-skill case that would justify anchor 5, landing at anchor 4's good-structure-with-minor-gaps level.

4 / 5

Total

18

/

20

Passed

Description

83%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 what the skill provides (per-area proof commands) and exactly when to use it (before every wrap-up or mid-task stop), with concrete quoted trigger phrases. Its main gaps are the missing natural trigger words from the verify/test/confirm family and a dense phrasing style that slightly blurs distinctiveness against general testing skills.

DimensionReasoningScore

Specificity

The description enumerates concrete proof mechanisms ("which dev server, test command, or invocation") and five change areas ("a template UI change, an action, a migration, a guard, or a core/package change"), giving several specific elements with only minor gaps (e.g., production forensics and docs-only cases are unmentioned). It exceeds anchor 3's 1-2 concrete actions but is not the comprehensive action enumeration of anchor 5.

4 / 5

Completeness

It explicitly answers both questions: what ("Concrete, per-area proof that a change actually works before reporting it fixed") and when ("Use before every wrap-up, and before stopping mid-task to ask permission instead of continuing") with concrete timing triggers. The explicit 'Use' clause satisfies the trigger-guidance requirement, and the when-clause is specific rather than the could-be-more-explicit level of anchor 4.

5 / 5

Trigger Term Quality

Natural phrases users would say appear verbatim ("fixed, done, or 'should work now'", "proof that a change actually works", "wrap-up"), giving good keyword coverage. However the most common natural trigger terms for this need — "verify", "test", "confirm", "end to end" — are absent, so it falls short of anchor 5's comprehensive synonym coverage but is clearly above anchor 3.

4 / 5

Distinctiveness Conflict Risk

The niche is clear and distinctive (verification-before-reporting-done, triggered at wrap-up time), but common words like "change" and "works" leave minor overlap risk with generic testing/debugging skills. It is mostly distinct per anchor 4 — not the minimal-conflict crispness of anchor 5, but well above the broad overlap of anchor 3.

4 / 5

Total

17

/

20

Passed

Validation

75%

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

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 4 missing

Warning

Total

12

/

16

Passed

Repository

BuilderIO/agent-native

Path

.agents/skills/verifying-changes/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.