CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/living-documentation-publisher

Use when BDD scenarios pass in CI and stakeholders need an always-current, readable report of which acceptance criteria pass. Turns Cucumber JSON into HTML living documentation (multiple-cucumber-html-reporter or Serenity BDD) and publishes it to GitHub or GitLab Pages.

Quality

87%

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 well-structured, executable guide: six sequenced steps with copy-paste commands for both renderer paths, a green-run publication gate, an anti-patterns table, and honest limitations. Detail is correctly pushed to three genuine one-level-deep reference files, with only minor conciseness trimming and no explicit error-recovery loop keeping it from top marks.

DimensionReasoningScore

Conciseness

The body is dense and task-focused (commands, snippets, an anti-patterns table, limitations) with only minor trimming opportunities: the Serenity-book quote framing in the Overview and mild redundancy between the "How to use" list and the Step 1-6 sections. It is not noticeably verbose enough for the level below.

4 / 5

Actionability

Guidance is fully executable and copy-paste ready: the package.json formatter snippet, `npx cucumber-js features/ --tags "not @wip" --format json:reports/cucumber.json`, `mvn clean verify -Dcucumber.options=...` tag filtering, the `set -e` publish gate, `mvn verify serenity:check`, and a concrete 22-scenario worked example cover the common Node and JVM cases.

5 / 5

Workflow Clarity

Steps 1-6 are clearly sequenced with an explicit validation checkpoint for the risky publish operation (Step 5's exit-code gate and serenity:check, reinforced by the anti-patterns table), but there is no explicit error-recovery loop (e.g., what to inspect if the report fails to generate), so it falls just short of the feedback-loop anchor.

4 / 5

Progressive Disclosure

The body is a clear overview that defers detail to three real, one-level-deep, clearly signaled references (node-reporter.md, serenity-reporter.md, ci-publish.md — verified to exist with no nested internal references), each introduced inline at the relevant step and indexed in the References section with descriptions.

5 / 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.

The description explicitly states both what the skill does (renders Cucumber JSON to HTML living documentation via two named tools and publishes to GitHub/GitLab Pages) and when to use it (green BDD runs in CI with stakeholder readers). It is concrete and third-person, with only minor keyword-coverage and sibling-skill overlap gaps.

DimensionReasoningScore

Specificity

"Turns Cucumber JSON into HTML living documentation (multiple-cucumber-html-reporter or Serenity BDD) and publishes it to GitHub or GitLab Pages" names the domain plus several concrete actions with specific tools and targets, sitting above the 1-2-action anchor; minor gaps remain (tag-based section routing and WIP filtering are uncovered).

4 / 5

Completeness

Both parts are explicit: the trigger "Use when BDD scenarios pass in CI and stakeholders need an always-current, readable report of which acceptance criteria pass" answers when with concrete conditions, and the render-and-publish sentence answers what. It clearly matches the both-what-and-when anchor rather than the level below where 'when' is only adequate.

5 / 5

Trigger Term Quality

Natural phrases like "BDD scenarios", "acceptance criteria", "Cucumber JSON", "living documentation", and "GitHub or GitLab Pages" are present, but common variations such as "test report" or "publish the report" are missing, so coverage is good rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

The BDD/Cucumber stakeholder-documentation niche with named tools is mostly distinct, but there is minor overlap risk with closely related reporting skills (e.g., generic 'generate a test report' requests or the junit-xml-analysis concern named in the body), keeping it just below the minimal-conflict anchor.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 4 missing

Warning

Total

15

/

16

Passed

Reviewed

On this page