test-catalogue

Generate a stakeholder-facing PDF catalogue of Playwright test scenarios grouped by section and priority.

5|2|Updated May 19, 2026
One-click install
npx skills add https://github.com/civitas-cerebrum/achilles --skill test-catalogue-civitas-cerebrum
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-catalogue
Source: https://github.com/civitas-cerebrum/achilles/tree/main/skills/test-catalogue
Command: npx skills add https://github.com/civitas-cerebrum/achilles --skill test-catalogue-civitas-cerebrum

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pdf-lib, @playwright/test, and includes scripts (resource) and references (resource) components.

What problem does it solve? Stakeholders and product owners cannot read Playwright spec files, so they have no transparent answer to "what scenarios are we running, and why?". This Skill turns an existing E2E suite into a printable, non-technical inventory document. ## Core Features & Use Cases - Scenario Extraction & Cross-Referencing: Parses tests/e2e/**/*.spec.ts files and cross-references each test against the sentinel-bearing journey-map.md to attach priority, category, section, and purpose metadata. - Runtime-Derived Taxonomy: Groups scenarios by primary section (URL-prefix or file-name clusters) and page area derived from the journey map, with priority, type, and status chips per scenario — never hardcoded app sections. - PDF Rendering with Verification: Renders an A4-landscape dark-mode HTML catalogue to PDF via per-slide Chromium rendering merged with pdf-lib, with mandatory page-count verification and exhaustive visual inspection of every page. - Use Case: Before a client review, ask the agent to produce a test catalogue; it outputs a cover page with headline totals, per-section scenario tables, an adversarial-regression section, and a transparent skipped-with-reason section. ## Quick Start Ask the agent to produce a test catalogue for the client from the existing Playwright suite and journey map.

Frequently Asked Questions about test-catalogue

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a test scenario report from Playwright specs?

Invoke the skill with a phrase like "produce a test catalogue". It parses every tests/e2e/**/*.spec.ts file, cross-references journey-map.md for priority and section metadata, then renders an A4-landscape HTML and PDF inventory at the repo root.

What inputs does the test catalogue generator require?

It requires at least one Playwright spec file under tests/e2e/ and a journey-map.md that starts with the <!-- journey-mapping:generated --> sentinel. Optional inputs include app-context.md for the cover summary and adversarial-findings.md for regression boundary codes.

Why does my rendered PDF have fewer pages than the HTML slides?

Chromium's single-pass PDF engine truncates documents beyond roughly 25-30k CSS pixels of stacked content. The skill avoids this by rendering each slide individually and merging with pdf-lib, then verifying the final page count matches the slide count.

Can I customize the branding or output filename of the catalogue?

Yes. Pass a brand argument matching a row in the skill's palette table to override the cover and accent colors, and an output argument to change the default test-catalogue.pdf filename. Custom brands are added by appending a palette row.

What happens to tests that don't match any journey in the map?

Unmatched tests are placed in a visible Unmapped bucket rather than dropped or fabricated. If the bucket exceeds 10 tests, the skill warns that the journey map is stale and suggests re-running journey-mapping instead of auto-repairing it.

When should I not use the test catalogue skill?

Do not use it during test writing, coverage expansion, repair, or debugging — it is on-demand only and never auto-activates. It also refuses to run without a valid journey map, since inferring one would fabricate priority and section metadata.