CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

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.

98

1.02x
Quality

90%

Does it follow best practices?

Impact

99%

1.02x

Average score across 10 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Overview
Quality
Evals
Security
Files

Quality

Content

82%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 strong, self-contained instructional skill: one worked example is carried through a fully sequenced five-step derivation with concrete tables, named coverage levels, and ready-to-run manual test cases. The main improvements are tightening the repeated citation blocks and adding an explicit end-of-process coverage verification checklist.

Suggestions

Cite each syllabus PDF once (e.g., in the References or Overview section with a short anchor like '[CTFL §4.2.4]') instead of repeating the full URLs inline in Steps 1-5, trimming several hundred tokens.

Add a final verification step after Step 5: a checklist that every chosen coverage item (transition ID or empty cell) maps to exactly one test case, mirroring the 'one invalid transition per test case' rule already stated.

Consider moving the verbatim CTFL/CTAL-TA quote blocks and the anti-patterns table into a references/ file, keeping SKILL.md as the lean overview-plus-worked-example.

DimensionReasoningScore

Conciseness

The body is dense and technique-specific — a single worked example carried through every step, with syllabus quotes serving as authoritative definitions rather than padding of concepts Claude already knows. Minor over-explanation remains: the full CTFL/CTAL-TA PDF URLs are repeated inline in nearly every section and then re-cited in the References section, which could be trimmed to a single citation point.

4 / 5

Actionability

Fully concrete instruction: a complete worked spec, a 4x6 state table with transition IDs and empty cells marked, coverage levels with explicit item counts, three full test cases as step/action/expected tables, two invalid-transition cases, a 1-switch example, and an anti-pattern table each paired with a fix. A tester can execute the derivation directly from this.

5 / 5

Workflow Clarity

Steps 1-5 are clearly sequenced, each producing a checkable artifact (transition table, state table with cell counts, coverage-level choice, test cases), and coverage is quantified ("9/9 = 100% valid-transitions coverage", "24 cells; 9 valid, 15 invalid") with each TC listing the transitions it covers. The gap keeping it below 5 is the absence of an explicit final verification step (e.g., a checklist confirming every coverage item is mapped to a TC before finishing), and the escalation heuristics in Step 3 are stated but not tied back as a decision checkpoint.

4 / 5

Progressive Disclosure

Well-organized standalone file with clear headers (Overview, When to use, Steps 1-5, Anti-patterns, Limitations, References) and clearly signaled cross-references to sibling skills; no bundle files exist and none are needed, so nothing is misfiled. It stays a ~280-line monolith where the syllabus-quote material or anti-patterns could arguably live in a one-level-deep reference file, which is the minor gap against the ideal split.

4 / 5

Total

17

/

20

Passed

Description

92%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.

An excellent description: third person, concrete, comprehensive on both 'what' and 'when', and explicitly disambiguated from sibling techniques. The only improvement is surfacing the natural synonyms 'state machine' and 'state transition testing' inside the description text itself rather than only in metadata keywords.

DimensionReasoningScore

Specificity

"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..., then derive one test case per coverage item as an event sequence with per-step expected states" lists multiple specific concrete actions covering the full pipeline. Voice is third person ("Derives"), so no penalty applies.

5 / 5

Completeness

Explicitly answers both questions: 'what' is the full derivation pipeline (states/events/transitions, state table, coverage level, one test case per coverage item), and 'when' is concrete — "Use for lifecycle entities (accounts, orders, subscriptions), workflows, and UI wizards where the response to an event depends on the current state."

5 / 5

Trigger Term Quality

Good natural terms: "stateful behavior", "state table", "lifecycle entities (accounts, orders, subscriptions)", "workflows", "UI wizards" — phrases a QA user would plausibly say. However the most common natural phrasing "state machine" (and "state transition testing" itself) appears only in the metadata keywords, not the description text, so a few key synonyms are missing from the description proper.

4 / 5

Distinctiveness Conflict Risk

"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" explicitly carves the skill away from adjacent skills, and the state-transition niche with its ISTQB framing has minimal overlap risk with generic test-design skills.

5 / 5

Total

19

/

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