CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bdd-with-approvals

Scannable BDD tests written in domain language. Use when doing BDD.

Quality

76%

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/bdd-with-approvals/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.

The body is a well-structured, lean instruction-only skill: it defines the artifact, gives concrete format-design guidance and an implementation checklist, and offloads examples to two well-signaled reference files. Its only weaknesses are a trimmable motivational preamble and the lack of an explicit failure/retry loop in the main workflow.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence, but "The Problem" section ("Specifications live in documents. They drift from reality because nothing enforces them.") restates motivation Claude already knows and could be trimmed to its three requirement bullets. This matches anchor 4 ('efficient; minor instances of over-explanation that could be trimmed') rather than anchor 5.

4 / 5

Actionability

Concrete, specific guidance throughout: the fixture template ("## Input / ## Output"), domain-to-format mappings ("Grid/spatial problems → ASCII art"), the implementation checklist ("1. Parser… 2. Formatter… 3. Single test file discovers and runs all fixtures"), and the '<5 seconds' validation test. Falls short of anchor 5 only because no inline example fixture or runner sketch appears in the body — the concrete examples live in the reference file.

4 / 5

Workflow Clarity

The sequence is clear — write fixtures before implementation, one-time parser/formatter/runner setup, and 'Implementation is driven by making these specs pass' provides an implicit feedback loop, with 'Can someone validate correctness in <5 seconds?' as an explicit design checkpoint. Not anchor 5 because there is no explicit validate/fix/retry guidance in the body for when specs fail; no destructive or batch operations are involved, so no cap applies.

4 / 5

Progressive Disclosure

A clear overview appropriately split across real, one-level-deep references: both [references/approved-fixtures.md] and [references/approved-logs.md] exist as linked files, and related techniques are cleanly delegated to '/approval-tests' and '/nullables' instead of being inlined. This matches anchor 5 ('clear overview with well-signaled one-level-deep references; content appropriately split').

5 / 5

Total

17

/

20

Passed

Description

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

The description is concise, in third person, and answers both what and when, but it is thin: a single trigger term ("BDD") and a deliverable description with no action verbs or mention of the approval-fixture mechanism that defines the skill. It reads as a slightly under-specified version of a good description.

Suggestions

Add explicit actions and the core mechanism, e.g. 'Write scannable BDD specifications as approval-test fixtures in domain language before implementing, so specs stay executable and human-verifiable.'

Broaden trigger coverage with natural synonyms: 'Use when doing BDD, behavior-driven development, spec-first or acceptance testing, or when the user mentions approval tests or executable specifications.'

Mention the artifact type (approved fixtures/logs) in the description so approval-testing requests route to this skill rather than a generic testing skill.

DimensionReasoningScore

Specificity

"Scannable BDD tests written in domain language" names the domain and concretely characterizes the deliverable, but contains no explicit action verbs and omits the approval-fixture technique entirely. It sits between anchors 2 and 3 — the specific characterization of the artifact lifts it above 'actions minimal or generic', but it does not list several concrete actions needed for anchor 4.

3 / 5

Completeness

Both parts are explicit: the what ("Scannable BDD tests written in domain language") and the when ("Use when doing BDD"), matching anchor 4 ('both present; when could be more explicit or specific'). Not anchor 5 because the when-clause lacks concrete trigger phrases and variations; not anchor 3 because the when is explicit rather than merely implied.

4 / 5

Trigger Term Quality

The only natural trigger term is "BDD" ("Use when doing BDD"); common variations like "behavior-driven development", "acceptance tests", "executable specifications", and "approval tests" are all absent. This matches anchor 3 ('some relevant keywords but missing common variations or synonyms') and falls short of anchor 4 because more than a few natural terms are missing.

3 / 5

Distinctiveness Conflict Risk

"Use when doing BDD" carves a distinct niche with only minor overlap risk against general testing or TDD skills, matching anchor 4. Not anchor 5 because the approval-tests angle appears only in the skill name, not the description, so users asking about approval or golden-master testing might not trigger this skill.

4 / 5

Total

14

/

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

saski/arnesto

Path

.agents/skills/bdd-with-approvals/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.