CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

e2e

Story-to-e2e-test workflow that takes a Jira [QE] Story, discovers the project's e2e testing infrastructure, plans test scenarios, writes e2e tests matching project conventions, validates them, and manages review via GitHub PRs. Use when implementing [QE] stories produced by the design workflow. Activated by commands: /ingest, /plan, /revise, /code, /validate, /publish, /respond.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

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.

The body is an exemplar of lean orchestrator writing: crisp routing logic, explicit error-stop policy, and no wasted tokens. Its one material defect is that all substance lives in referenced files (commands/, skills/controller.md, guidelines.md) that are absent from the bundle, which both weakens progressive disclosure and leaves the actual phase workflow invisible.

Suggestions

Ship the referenced bundle files (commands/{command}.md for each of /ingest, /plan, /revise, /code, /validate, /publish, /respond, plus skills/controller.md and guidelines.md) so the routing pointers resolve — currently every reference in the body dangles.

Add a one-line phase overview (e.g., ingest → plan → code → validate → publish → respond) inline so the workflow shape is visible before the controller is loaded.

Replace the generic `{command}` placeholder with an explicit command-to-file mapping or a note that files follow the `commands/<name>.md` naming convention.

DimensionReasoningScore

Conciseness

The body is ~15 lines with zero padding: it never explains what Jira, e2e testing, or PRs are, and every line does routing or policy work ("read `commands/{command}.md` and follow it", "stop and report the error to the user. Do not advance to the next phase"). This matches the 5 anchor — lean, assumes Claude's competence, every token earns its place.

5 / 5

Actionability

The routing guidance is concrete and executable in form: exact file paths per situation ("read `commands/{command}.md`", "read `skills/controller.md`"), explicit conditionals on user input, and a specific error policy with example failure classes ("Jira MCP errors, test failures, build errors"). It stops short of the 5 anchor because the `{command}` placeholder is generic and the instruction targets cannot be confirmed to exist in the bundle — a minor gap for an otherwise fully specified instruction, fitting the 4 anchor.

4 / 5

Workflow Clarity

The entry sequence is clear and gated: command invocation routes to a command file, otherwise the controller loads with a rule for choosing the first phase, and there is an explicit checkpoint — "If a step fails or produces unexpected output... stop and report the error... Do not advance to the next phase. Offer to retry the failed step or escalate" — which is a genuine validate/feedback loop. It fits the 4 anchor rather than 5 because the multi-phase sequence itself (ingest → plan → code → validate → publish) is never shown inline; it is entirely delegated to files not present, leaving the overall process shape implicit.

4 / 5

Progressive Disclosure

On paper the structure is textbook: a short overview with clearly signaled, one-level-deep references (`commands/{command}.md`, `skills/controller.md`, `guidelines.md`). However, none of these referenced files exist anywhere in the bundle — there are no commands/, skills/, or guidelines.md alongside SKILL.md and no references/scripts/assets directories — so every navigation pointer dangles and the disclosed content cannot actually be reached. Clear signaling but unverifiable/broken targets places this between the well-organized 4 anchor and the structurally deficient 2 anchor.

3 / 5

Total

16

/

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.

A strong description: it lays out the whole workflow as concrete third-person actions, gives an explicit and specific "Use when..." trigger tied to a recognizable artifact, and is tightly scoped so conflict risk is minimal. The only weakness is keyword coverage that stops one synonym layer short (no "end-to-end" spelling or framework names).

DimensionReasoningScore

Specificity

The description enumerates six concrete, distinct actions covering the full pipeline end to end: "takes a Jira [QE] Story", "discovers the project's e2e testing infrastructure", "plans test scenarios", "writes e2e tests matching project conventions", "validates them", and "manages review via GitHub PRs". This matches the 5 anchor (multiple specific concrete actions, comprehensive coverage) rather than 4, since no step of the input-to-review pipeline is missing.

5 / 5

Completeness

Both halves are explicit: the "what" is the fully enumerated story-to-PR pipeline, and the "when" is a concrete trigger clause — "Use when implementing [QE] stories produced by the design workflow" — supplemented by "Activated by commands: /ingest, /plan, /revise, /code, /validate, /publish, /respond". This matches the 5 anchor (clear, explicit what AND when with concrete triggers); the when-clause is specific, not the vaguer form that would warrant a 4.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "e2e tests", "e2e testing infrastructure", "Jira [QE] Story", "GitHub PRs", "test scenarios", plus the slash-command activation list. It falls short of the 5 anchor because common synonyms a user would naturally say — "end-to-end" spelled out, or framework names like Playwright/Cypress — are absent; it is well above the 3 anchor since multiple genuinely natural phrases are present, not just a few relevant keywords.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche keyed to a proprietary artifact — "Jira [QE] Story" stories from a specific "design workflow" — with its own command set, so it would not plausibly trigger for generic test-writing or PR-management skills. Minimal conflict risk, matching the 5 anchor.

5 / 5

Total

19

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

flightctl/ai-workflows

Path

e2e/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.