CtrlK
BlogDocsLog inGet started
Tessl Logo

testland/state-transition-test-design

Derives human-readable manual test cases from stateful behavior: identify states, events, transitions, and guard conditions, draw the state table including invalid (empty-cell) transitions, choose a coverage level (all states, valid transitions / 0-switch, transition pairs / 1-switch per Chow, all transitions including invalid ones), then derive one test case per coverage item as an event sequence with per-step expected states (ISTQB CTFL v4.0 section 4.2.4). A deep single-technique walkthrough rather than a broad multi-lens case matrix; the output is manual step/expected cases rather than parameterized test code, and it covers how cases are derived rather than how a case record is structured. Use for lifecycle entities (accounts, orders, subscriptions), workflows, and UI wizards where the response to an event depends on the current state.

74

Quality

93%

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

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A high-quality, citation-driven walkthrough with concrete worked test cases and a clear sequenced process. The only meaningful drag is conciseness: verbatim syllabus quotations and dated fetch provenance add tokens that do not all earn their place.

Suggestions

Trim verbatim ISTQB quote blocks to the operative clause needed for the step (e.g., keep the transition-labeling syntax 'event [guard] / action' and drop the surrounding definitional prose) to tighten conciseness.

Move the syllabus fetch dates and version pins (2026-06-10, v4.0.1 2024-09-15) into a single compact References note instead of repeating provenance inline in the Overview, reducing time-sensitive token overhead.

If verbatim syllabus quotes must stay for citation fidelity, factor the longest ones into a REFERENCES.md file and summarize the rule inline, improving both conciseness and progressive disclosure.

DimensionReasoningScore

Conciseness

Mostly efficient and assumes competence rather than explaining basics, but verbatim ISTQB syllabus quotes ('a state diagram models the behavior of a system by showing its possible states...') and dated provenance notes ('fetched 2026-06-10', 'v4.0.1 (2024-09-15)') add tokens that could be trimmed. It is not anchor 3 because not every token earns its place; it is not anchor 1 because it is not padded with beginner-level concept explanations.

2 / 3

Actionability

Provides concrete copy-ready artifacts: a valid-transition table (t1-t9), a full state table with '--' empty cells, and step-by-step Action/Expected-result tables for TC-ST-1/2/3, TC-INV-1/2, and TC-SW-1. It is not anchor 2 because the guidance is complete and executable rather than pseudocode or missing key details.

3 / 3

Workflow Clarity

A clearly labeled 5-step sequence carries one worked example through every step, with explicit checkpoints: 'Every step asserts the resulting observable state, never just action accepted', the one-invalid-transition-per-TC defect-masking warning, and the anti-patterns table as a checklist. It is not anchor 2 because validation/checkpoint guidance is explicit, not merely listed.

3 / 3

Progressive Disclosure

No bundle files exist, and the body is organized into clearly signaled sections (Overview, When to use, Steps 1-5, Anti-patterns, Limitations, References) with one-level-deep links to sibling skills and external PDFs. Per the simple-skills note, a self-contained well-organized skill scores 3; it is not anchor 2 because it is not a monolithic wall and references are clearly signaled rather than nested.

3 / 3

Total

11

/

12

Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person voice, comprehensive concrete actions, an explicit 'Use for' trigger clause, and active disambiguation from neighboring skills. Minor upside would be surfacing 'state machine/diagram' terms in the prose itself rather than only in metadata keywords.

DimensionReasoningScore

Specificity

Lists multiple concrete actions - 'identify states, events, transitions, and guard conditions', 'draw the state table including invalid (empty-cell) transitions', 'choose a coverage level', 'derive one test case per coverage item' - matching the anchor for multiple specific concrete actions. It is not anchor 2 because the actions enumerate the full derivation workflow comprehensively rather than naming only some.

3 / 3

Completeness

Explicitly answers both what ('Derives human-readable manual test cases...') and when ('Use for lifecycle entities... where the response to an event depends on the current state'), matching the anchor for clearly answering both with explicit triggers. It is not anchor 2 because the 'Use for' trigger clause is present and explicit, not merely implied.

3 / 3

Trigger Term Quality

Includes natural phrasings a QA user would voice - 'lifecycle entities (accounts, orders, subscriptions), workflows, and UI wizards where the response to an event depends on the current state'. It is not anchor 2 because these are common natural variations rather than only jargon, though a few obvious terms like 'state machine testing' live in metadata keywords rather than the prose.

3 / 3

Distinctiveness Conflict Risk

Carves a clear niche - 'A deep single-technique walkthrough rather than a broad multi-lens case matrix; the output is manual step/expected cases rather than parameterized test code' - and the stateful-behavior trigger separates it from stateless skills. It is not anchor 2 because it actively disambiguates from sibling techniques, making wrong-skill triggering unlikely.

3 / 3

Total

12

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Reviewed

Table of Contents