CtrlK
BlogDocsLog inGet started
Tessl Logo

testland/living-documentation-publisher

Converts passing Cucumber JSON output into stakeholder-facing living documentation: generates HTML reports via multiple-cucumber-html-reporter (Node) or Serenity BDD aggregate (JVM), applies Gherkin tags to drive report sections, and publishes to GitHub/GitLab Pages in CI. Use when BDD scenarios are in use and the team needs an always-current, non-test-engineer-readable document showing which acceptance criteria pass.

72

Quality

90%

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

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.

A well-structured, largely executable skill body with excellent progressive disclosure: three real, one-level-deep references carry the bulk detail while the body stays an actionable overview, and the publish-only-green validation gate is explicit. The main deductions are redundant scaffolding (How-to list, Worked Example, and References section overlap) and a few steps that are pointers rather than inline executable guidance.

Suggestions

Merge the 'How to use' numbered list with the Steps 1–6 sections (drop the redundant 'Step N' annotations) or cut the list to a one-line pipeline summary, since the steps and the Worked Example already sequence the same workflow.

Trim the bottom References section to just the external Serenity-book links and upstream skills — the three reference-file entries duplicate the inline citations and their descriptions.

Add a brief failure-path note to Step 5 or Step 6 (e.g., what to check when the Pages artifact is stale or serenity:aggregate produces an empty Requirements tab), giving the workflow an explicit error-recovery checkpoint.

DimensionReasoningScore

Conciseness

The body is operational (commands, config snippets, an anti-patterns table, a limitations section) with no padding of concepts Claude already knows, but there is redundant scaffolding: the 'How to use' list re-enumerates Steps 1–6, the Worked Example partially repeats them, and the References section re-lists links already cited inline with their descriptions. Mostly efficient with minor trimmable repetition, so level 4 rather than the tighter level 5 or the noticeably-verbose level 3.

4 / 5

Actionability

Steps 1, 4, and 5 give copy-paste-ready code (package.json formatter config, 'npx cucumber-js features/ --tags "not @wip" --format json:reports/cucumber.json', 'set -e' gate, 'mvn verify serenity:check'), but Steps 2, 3, and 6 are summaries that delegate the actual executable content (generate-report.js, the Maven plugin XML, the CI YAML) to the reference files. This is 'mostly executable guidance with minor gaps' (level 4), not the fully self-contained common-case coverage of level 5.

4 / 5

Workflow Clarity

The six steps are clearly sequenced and validation is explicit — publication is gated on a green exit code ('set -e… only reached if all tests pass') and 'serenity:check' fails the build on any red scenario, so the missing-validation cap at 3 does not apply. It falls short of level 5 only because there are no error-recovery feedback loops (e.g., what to do when the Pages publish or aggregate step fails) beyond the gating.

4 / 5

Progressive Disclosure

The body is a genuine overview: the bulk detail (full generate-report.js, options table, Maven plugin XML, complete CI YAML) is split into three real, one-level-deep reference files (node-reporter.md, serenity-reporter.md, ci-publish.md), each clearly signaled at the point of use with a description of what it contains ('Full install, script, and options table: references/node-reporter.md') and backlinking to SKILL.md. Navigation is easy and nothing that belongs in a reference is inlined.

5 / 5

Total

17

/

20

Passed

Description

100%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 exemplary: it names concrete tools and actions for both the Node and JVM paths, includes an explicit and specific 'Use when…' trigger clause, and stays in third-person voice. Trigger terms map directly onto the phrases a user with this need would naturally say. No changes needed.

DimensionReasoningScore

Specificity

Lists multiple concrete actions with named tools — 'generates HTML reports via multiple-cucumber-html-reporter (Node) or Serenity BDD aggregate (JVM)', 'applies Gherkin tags to drive report sections', 'publishes to GitHub/GitLab Pages in CI' — comprehensively covering the convert/render/tag/publish pipeline across both ecosystems, matching the comprehensive-coverage anchor rather than the 'minor gaps' level 4.

5 / 5

Completeness

Explicitly answers both questions: the 'what' is the four concrete actions, and the 'when' is a full trigger clause — 'Use when BDD scenarios are in use and the team needs an always-current, non-test-engineer-readable document showing which acceptance criteria pass' — with concrete trigger conditions, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Covers the natural vocabulary a user would say when needing this skill — 'Cucumber', 'BDD scenarios', 'Gherkin', 'Serenity', 'living documentation', 'acceptance criteria', 'GitHub Pages', 'stakeholder' — with synonyms across both toolchains; not level 4 since no commonly used natural phrasing for this domain is missing.

5 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (stakeholder-facing living documentation generated from passing Cucumber JSON) with tool-specific triggers (multiple-cucumber-html-reporter, Serenity BDD aggregate, Gherkin tags, Pages) that no generic test-reporting or CI skill would match; written in third person ('Converts… publishes…'), so no voice penalty applies.

5 / 5

Total

20

/

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

Table of Contents