CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bdd-bun-test

BDD-first testing with bun:test in this repository — scenario-oriented examples, describe/it layout rules, library-integration testing, and no Cucumber. Use when writing or changing tests, adding fixtures, mocking libraries, or when the user mentions BDD, TDD, bun:test, or Vitest.

Quality

88%

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

The canonical home for this skill is bdd-bun-test in williamrjribeiro/bun-agentic-starter

SKILL.md
Quality
Evals
Security

Quality

Content

80%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, well-structured conventions skill: every line is a repo-specific rule, sections are cleanly organized, and the only external pointer is a single one-level reference. Its weaknesses are the absence of any executable code example illustrating the required test layout and an implicit rather than explicit red/green verification loop.

Suggestions

Add a minimal copy-paste-ready bun:test example (root describe with declarations inside, an it, and a beforeEach) to make the 'Test files' layout rules concrete and lift actionability to fully executable.

Make the red/green checkpoint explicit in the BDD loop, e.g. 'Write the scenario, run `bun test`, confirm it fails (red), implement until `bun test` passes (green), then refactor' — this adds the missing validation/feedback loop.

Clarify the 'See also: `repo-conventions`' pointer with a relative path or one-phrase scope note so navigation to the related skill is unambiguous.

DimensionReasoningScore

Conciseness

The body is ~35 lines of dense, rule-style bullets with zero padding — it never explains what BDD/TDD are beyond a one-line framing ('Same red → green → refactor rhythm as TDD, oriented around user-facing outcomes') and every token carries a project-specific rule Claude could not infer. This matches the 'lean and efficient; assumes Claude's competence' anchor; a 4 would require noticeable over-explanation that is absent.

5 / 5

Actionability

Guidance is concrete and executable in the instruction-only sense: exact APIs ('`describe` / `it` from `bun:test` (not `test`)', 'describe.each / it.each', 'beforeAll / beforeEach'), a concrete path convention ('test/support/ modules that export functions'), and a measurable policy ('a few happy paths plus one or two errors'). It falls short of the top anchor because there is no copy-paste-ready example (e.g., a minimal describe/it block showing the required root-describe layout), which is the one gap for an instruction-only skill.

4 / 5

Workflow Clarity

The core sequence is named ('concrete examples of desired behaviour first, then implement until they pass... refactor is required after green') but the checkpoints are implicit — it never states how to verify green (e.g., run `bun test` and see failures before/after), matching 'sequence present but checkpoints missing or implicit'. Not a 4 because no explicit verification step or feedback loop (fail → fix → re-run) is spelled out; not a 2 because the rhythm and its ordering are clearly stated.

3 / 5

Progressive Disclosure

The skill is under 50 lines with well-organized sections (Test files, Testing library code) and no content that warrants external files; the single 'See also: `repo-conventions`' pointer is one level deep and clearly signaled. Per the rubric's simple-skill guidance this matches the top anchor.

5 / 5

Total

17

/

20

Passed

Description

91%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 names concrete capabilities, gives an explicit and well-structured 'Use when' clause with natural trigger terms and synonyms, and scopes itself to this repository with a helpful Cucumber exclusion. The only soft spot is minor trigger overlap on the generic terms TDD and Vitest.

DimensionReasoningScore

Specificity

The description lists several concrete capabilities — 'scenario-oriented examples, describe/it layout rules, library-integration testing, and no Cucumber' — which map directly to the skill's actual scope. It stops short of comprehensive coverage (no mention of the refactor requirement or shared-helper conventions), matching the 'several specific actions; minor gaps' anchor rather than the fully comprehensive anchor above.

4 / 5

Completeness

It explicitly answers both parts: what it does ('BDD-first testing with bun:test in this repository — scenario-oriented examples, describe/it layout rules, library-integration testing, and no Cucumber') and when to use it ('Use when writing or changing tests, adding fixtures, mocking libraries, or when the user mentions BDD, TDD, bun:test, or Vitest'). This matches the top anchor with concrete trigger phrases, so a 4's 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

Triggers cover natural phrasings users would say — 'writing or changing tests, adding fixtures, mocking libraries' — plus synonyms and adjacent tool names 'BDD, TDD, bun:test, or Vitest', comprehensively covering the domain's natural vocabulary (including the Vitest disambiguation). Not a 4 because no common variation of how a user would request this work is conspicuously missing.

5 / 5

Distinctiveness Conflict Risk

The niche is clear — repo-scoped BDD with bun:test, with an explicit exclusion ('no Cucumber') that sharpens boundaries. It does not hit the top anchor because triggering on 'TDD' and 'Vitest' creates minor overlap risk with a generic TDD skill or a true Vitest skill, fitting the 'mostly distinct; minor overlap risk with closely related skills' anchor.

4 / 5

Total

18

/

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

williamrjribeiro/resume

Path

.agents/skills/bdd-bun-test/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.