CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

design

Design-and-decompose workflow that takes a PRD, researches the problem space, drafts a technical design document with a requirement-anchored testplan, decomposes work into Jira-ready epics and stories, and manages review via GitHub PRs. Use when creating design documents, researching external integrations or standards, breaking features into epics/stories, or syncing task breakdowns to Jira. Activated by commands: /ingest, /research, /draft, /decompose, /revise, /publish, /respond, /sync.

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 itself is exemplary — lean, well-structured orchestrator prose with an explicit failure checkpoint. Its fatal weakness is measured against the bundle it ships in: all referenced files are missing and all provided files are orphaned, so the skill's actual content is undiscoverable from its entry point.

Suggestions

Fix the broken references: `commands/{command}.md`, `skills/controller.md`, and `guidelines.md` do not exist in the bundle — either ship them or correct the paths so the routing instructions resolve.

Surface the existing bundle files from SKILL.md (e.g., a line pointing to `references/sync-helper-usage.md` and `scripts/sync_helper.py` for the /sync phase) so the provided content is reachable from the entry point.

Add a one-line overview of the full phase sequence (ingest → research → draft → decompose → publish → respond → sync) so the workflow's shape is visible even before the controller file is loaded.

DimensionReasoningScore

Conciseness

The ~20-line body is pure directive: "read `commands/{command}.md` and follow it", "read `skills/controller.md` to load the workflow controller", with zero concept explanation and no padding. It matches the score-5 anchor (lean, assumes Claude's competence, every token earns its place), including the error-handling paragraph which is operational guidance rather than filler.

5 / 5

Actionability

Routing is concrete — exact paths, explicit conditionals ("If the user invoked a specific command... read `commands/{command}.md`"; "If the user provided a Jira issue key or URL, execute the `/ingest` phase") and a specific failure protocol. It is not score 5 because the body contains no executable commands or examples itself, and its instructions resolve to files absent from the bundle, leaving minor gaps in what can actually be executed.

4 / 5

Workflow Clarity

The entry sequence is clear with an explicit checkpoint: "If a step fails or produces unexpected output... stop and report the error to the user. Do not advance to the next phase. Offer to retry the failed step or escalate" — a real feedback loop. It stays at score 4 rather than 5 because the multi-phase workflow's own sequencing and per-phase validation are entirely delegated to `skills/controller.md`, which is not present in the bundle, so the full process cannot be verified.

4 / 5

Progressive Disclosure

Scored against the actual bundle: every path the body signals (`commands/{command}.md`, `skills/controller.md`, `guidelines.md`) does not exist in the bundle, while the files that do exist (`references/sync-helper-usage.md`, `scripts/sync_helper.py`, `scripts/test_sync_helper.py`) are never referenced from SKILL.md and are therefore unreachable from the entry point. The pointer structure is tidy, but navigation dead-ends in both directions, matching the score-2 anchor (references buried/broken) rather than 3, where references would at least resolve.

2 / 5

Total

15

/

20

Passed

Description

88%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: third-person, dense with concrete pipeline actions, an explicit Use-when clause, and command triggers. The only weaknesses are single-phrasing triggers (no synonyms like "spec" or "tickets") and slight overlap surface with PR-review skills.

DimensionReasoningScore

Specificity

"takes a PRD, researches the problem space, drafts a technical design document with a requirement-anchored testplan, decomposes work into Jira-ready epics and stories, and manages review via GitHub PRs" lists five concrete, object-anchored actions covering the whole pipeline. This matches the score-5 anchor (multiple specific concrete actions, comprehensive coverage); it is well above score 4 because no capability area of the workflow is left unenumerated.

5 / 5

Completeness

The "what" is explicit (the five-action pipeline) and the "when" is an explicit "Use when..." clause with concrete trigger phrases plus "Activated by commands: /ingest, /research, /draft, /decompose, /revise, /publish, /respond, /sync". This clearly matches the score-5 anchor (both what AND when with concrete triggers); score 4 would require the when-clause to be less explicit, which it is not.

5 / 5

Trigger Term Quality

"creating design documents, researching external integrations or standards, breaking features into epics/stories, or syncing task breakdowns to Jira" covers natural phrasings plus "PRD", "Jira", and eight explicit command names. It falls short of the score-5 anchor because each capability has a single phrasing with no synonyms users also say ("spec", "tech doc", "tickets", "architecture").

4 / 5

Distinctiveness Conflict Risk

The PRD-to-epics-to-Jira niche is distinct and the when-clause is well scoped, but "manages review via GitHub PRs" and generic command names (/publish, /respond) create minor overlap with GitHub/PR-review skills. This sits at the score-4 anchor (mostly distinct, minor overlap with closely related skills) rather than 5, whose example has no such overlapping surface.

4 / 5

Total

18

/

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

design/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.