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

90%

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

The canonical home for this skill is design in flightctl/ai-workflows

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exemplary lean orchestrator body: crisp two-branch dispatch with concrete file targets, an explicit stop-and-escalate error-handling loop, and appropriately deferred detail via one-level-deep references. The only deductions are a small ambiguity when no phase is requested and the fact that the referenced bundle files (commands/, skills/controller.md, guidelines.md) were not present to verify.

DimensionReasoningScore

Conciseness

The ~20-line body is lean and assumes Claude's competence — it dispatches via "read `commands/{command}.md` and follow it" and "read `skills/controller.md` to load the workflow controller" with zero padding or explanation of concepts Claude already knows. Every token earns its place, matching the score-5 anchor.

5 / 5

Actionability

Guidance is mostly executable with concrete file paths and unambiguous 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"), matching the score-4 anchor for an instruction-only skill. It is not 5 because "execute the first phase the user requests" leaves a gap when the user requests no phase, and per-phase specifics are delegated without any inline example of what execution looks like.

4 / 5

Workflow Clarity

The dispatch sequence is clear and includes an explicit validation/feedback checkpoint: "If a step fails or produces unexpected output (e.g., Jira MCP errors, network failures...), stop and report the error to the user. Do not advance to the next phase. Offer to retry the failed step or escalate." This matches the score-5 anchor (clear sequence, explicit error-recovery loop); the destructive/batch cap does not apply because the body itself performs no batch operations and includes failure handling.

5 / 5

Progressive Disclosure

The body is a clean overview with well-signaled, one-level-deep references — "read `commands/{command}.md`", "read `skills/controller.md`", and "For principles, hard limits, safety, quality, and escalation rules, see `guidelines.md`" — which structurally matches the score-5 anchor. However, no bundle files were provided (no references/, scripts/, assets/, commands/, skills/, or guidelines.md exist in the skill directory), so the referenced files cannot be verified to exist, keeping this at 4 rather than 5.

4 / 5

Total

18

/

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 in third-person voice that comprehensively enumerates concrete workflow actions and pairs them with an explicit, natural-language "Use when..." trigger clause plus a command list. The only weaknesses are minor: a few missing trigger synonyms and slightly broad triggers (design documents, researching) that create small overlap risk with general writing/research skills.

DimensionReasoningScore

Specificity

The description lists five concrete, specific actions — "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" — covering the full workflow comprehensively. This matches the score-5 anchor (multiple specific concrete actions, comprehensive coverage) rather than 4, since there are no noticeable coverage gaps in what the workflow does.

5 / 5

Completeness

It explicitly answers both questions: "what" via the five enumerated actions and "when" via the explicit trigger clause "Use when creating design documents, researching external integrations or standards, breaking features into epics/stories, or syncing task breakdowns to Jira". This matches the score-5 anchor (both what and when with concrete trigger phrases); a 4 would require the when-clause to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural user phrases like "creating design documents", "breaking features into epics/stories", and "syncing task breakdowns to Jira" give good keyword coverage, matching the score-4 anchor. It falls short of 5 because common synonyms and variations (e.g., "spec", "tech spec", "architecture", "write stories", "project breakdown") are missing; it is clearly above 3 since multiple relevant natural phrases are present.

4 / 5

Distinctiveness Conflict Risk

The PRD-to-Jira design niche with distinct triggers ("PRD", "Jira-ready epics and stories", "requirement-anchored testplan") is mostly distinct, matching the score-4 anchor. It is not 5 because broad triggers like "creating design documents" and "researching external integrations or standards" could overlap with general documentation, writing, or research skills; it is well above 3 given the highly specific Jira/epics/decomposition framing.

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

amir-yogev-gh/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.