CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/bats-testing

Use whenever the code under test is a shell script, a CLI binary or anything run from Bash: argument parsing, flags, exit codes and output. Sets up Bats-core with @test blocks, run, status and output assertions, setup/teardown, shared helpers and TAP output for CI.

Quality

89%

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

Overview
Quality
Evals
Security
Files

Quality

Content

86%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 content is a strong, example-driven guide: every step has executable code, the sequence is explicit and cross-referenced, and CI details are cleanly deferred to a real one-level-deep reference file. The only trimming opportunities are the duplicated overview quote and repetitive source-attribution lines, plus the absence of failure-triage guidance after a failing run.

DimensionReasoningScore

Conciseness

The body is dominated by dense, executable examples with little concept explanation, but the Overview quotes the identical 'TAP-compliant testing framework for Bash 3.2 or above' sentence from two sources, and repeated 'Per [bats][bats]' attribution lines pad several sections. These are minor instances of over-explanation that could be trimmed, matching the 4 anchor rather than 5.

4 / 5

Actionability

Install one-liners (npm/brew/git submodule), complete runnable .bats files for every feature, exact run commands, skip guards, and CI YAML are all copy-paste ready and cover the common cases. Fully executable guidance matching the 5 anchor.

5 / 5

Workflow Clarity

Steps 1-9 are clearly sequenced, cross-referenced from the 'How to use' summary, and the worked example shows expected output as a checkpoint. It falls short of 5 only because there is no failure-triage guidance (what to do when a test fails); the destructive/batch cap does not apply since testing is itself validation.

4 / 5

Progressive Disclosure

The body is a well-organized overview with CI output-format details appropriately split into references/ci-integration.md, which exists in the bundle and is clearly signaled via markdown links in the 'How to use' list, Step 9, and the References section. One level deep with a back-link to SKILL.md, matching the 5 anchor.

5 / 5

Total

18

/

20

Passed

Description

88%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 strong: it names a clear niche (Bats-core shell/CLI testing), enumerates concrete capabilities, and opens with an explicit 'Use whenever...' trigger covering shell scripts, CLI binaries, and Bash-run commands. The only weaknesses are a few missing natural synonyms (e.g., 'bash script', '.sh') and slightly broad phrasing in 'anything run from Bash' that could overlap with other testing skills.

DimensionReasoningScore

Specificity

"Sets up Bats-core with @test blocks, run, status and output assertions, setup/teardown, shared helpers and TAP output for CI" lists multiple specific concrete actions with comprehensive coverage of the skill's capabilities. It exceeds the 4 anchor because there are no meaningful gaps in the action inventory.

5 / 5

Completeness

Explicitly answers both questions: "Use whenever the code under test is a shell script, a CLI binary or anything run from Bash" (when, with concrete triggers) and the Bats-core setup sentence (what). Not 4, because the when-clause is fully explicit and specific rather than needing more detail.

5 / 5

Trigger Term Quality

Natural phrases like "shell script", "CLI binary", "run from Bash", and "argument parsing, flags, exit codes and output" match what users would say, but common variations such as "bash script", ".sh", or "shell" are missing. Good coverage with a few natural terms absent, matching the 4 anchor rather than 5.

4 / 5

Distinctiveness Conflict Risk

The Bats-core/shell-testing niche is clear and mostly distinct, but the trigger "anything run from Bash" is broad enough to overlap with language-specific CLI or integration-test skills. Minor overlap risk matches the 4 anchor; it is well above 3 since the tooling named is unmistakable.

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.

Reviewed

On this page