CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

adding-tests-and-ci

Where a new test belongs, how to write a browser E2E test that fails when the feature breaks, and how to scope CI jobs, steps, and workflow triggers so they run only when a change can affect them. Use when adding, moving, or writing a test (including Design E2E specs), adding or changing a CI job, step, or workflow, or when a job is slow or runs on unrelated changes.

Quality

93%

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

92%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 dense, high-signal body: concrete scripts, commands, and APIs back every rule, CI changes get an explicit prove-it loop, and the Design E2E detail is properly deferred to a real, well-signaled reference. The only cost is dated capacity history (specific dates and slot counts) in the motivation section that will age and could be trimmed or moved.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence (no explanation of what CI, Vitest, or E2E testing is) and every rule carries a repo-specific payoff, but time-sensitive facts — "on 2026-09-29 the Fast tests gate waited a median 445 s", "moved to Enterprise Cloud in October 2026, which raises the pool to 500 jobs" — sit in the motivation section rather than a deprecated/old-patterns section and will rot. Efficient with minor trimmable material fits 4; not 3 (no genuinely unnecessary explanation) and not 5 (the dated capacity history costs tokens without guiding action).

4 / 5

Actionability

Guidance is concrete and executable throughout: a copy-paste test command ("node --experimental-strip-types --test scripts/ci-change-scope.test.ts ..."), named scripts and outputs (ci-change-scope.ts, query_budget_apps, script_tests, MIN_SHARD_FILES), exact APIs (testInfo.outputPath, expectOnlyChanged, app.savedNodes), and tooling (actionlint). Specific examples cover the common cases, matching the 5 anchor rather than 4's "minor gaps".

5 / 5

Workflow Clarity

"Proving a CI change" is an explicit validation loop — add classifier test cases, run the test command, verify against real main history and post before/after, run each run: snippet against matching and empty inputs, actionlint, and mind the self-test gap — and "Adding a test" is sequenced from should-it-exist to where-it-lives to what-runs-it. Clear sequences with explicit checkpoints fit the 5 anchor; nothing lands in the destructive/batch cap.

5 / 5

Progressive Disclosure

The bundle is one clearly signaled, one-level-deep reference ("Design's harness ... and its traps are in references/design-e2e.md") that exists and correctly absorbs the harness API table and trap list, while the body keeps the decision-level guidance with well-organized sections. Content is appropriately split with easy navigation, matching the 5 anchor; 4's "minor organization gaps" does not apply.

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: it states three concrete capabilities and pairs them with an explicit, naturally phrased 'Use when' clause covering tests, CI jobs, and slow-or-misaligned runs. Its only weakness is that broad test-writing triggers could collide with the org's other test-governance skills.

Suggestions

Disambiguate against sibling skills (e.g. note that test-audit owns whether a test should exist and this skill owns where it lives and what runs it) so 'adding a test' triggers resolve to one skill.

Add the natural trigger phrase for CI cost complaints (e.g. 'when CI is slow' or 'when runs are cancelled for concurrency') to broaden the slow-job trigger set.

DimensionReasoningScore

Specificity

The description lists three concrete capabilities — "Where a new test belongs", "how to write a browser E2E test that fails when the feature breaks", and "how to scope CI jobs, steps, and workflow triggers" — comprehensively covering the skill's scope with no gaps, matching the 5 anchor rather than 4's "minor gaps in coverage".

5 / 5

Completeness

It explicitly answers both questions: the first sentence states what the skill does, and "Use when adding, moving, or writing a test... or when a job is slow or runs on unrelated changes" gives concrete when-triggers. Clearly the 5 anchor, not 4 where the 'when' is only adequate.

5 / 5

Trigger Term Quality

Triggers span synonyms and natural phrasing: "adding, moving, or writing a test", "Design E2E specs", "CI job, step, or workflow", and complaint-shaped triggers like "when a job is slow or runs on unrelated changes". Coverage is comprehensive, fitting the 5 anchor over 4's "a few natural terms missing".

5 / 5

Distinctiveness Conflict Risk

The combined test-placement and CI-scoping niche is mostly distinct, but triggers like "adding... a test" could overlap with closely related sibling skills the body itself cites (test-audit, design-editor-architecture), so 4's "minor overlap risk with closely related skills" fits better than 5's "minimal conflict risk".

4 / 5

Total

19

/

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: 10 missing

Warning

Total

12

/

16

Passed

Repository

BuilderIO/agent-native

Path

.agents/skills/adding-tests-and-ci/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.