CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

implement

Story-to-code workflow that takes a Jira Story, plans the implementation, writes contract-based tests and production code via TDD, validates against the project's CI expectations, and manages review via GitHub PRs. Use when implementing Jira stories produced by the design workflow. Activated by commands: /ingest, /plan, /revise, /code, /validate, /publish, /respond.

Quality

90%

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

86%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 lean, well-structured orchestrator body: unambiguous dispatch logic, an explicit failure checkpoint with retry/escalate options, and clean one-level-deep delegation to commands/, skills/controller.md, and guidelines.md. The main gaps are the underspecified fallback branch, the implicit command-file naming, and the fact that none of the referenced files exist in the provided bundle.

Suggestions

Name the exact command files (e.g., `commands/plan.md`, `commands/code.md`) instead of 'the matching file in commands/' so dispatch is fully unambiguous.

Define the fallback branch when no command, issue key, or phase is given — e.g., default to `/ingest` or explicitly ask the user which phase to run.

Include the referenced files (`commands/`, `skills/controller.md`, `guidelines.md`) in the skill bundle; as provided, every reference in the body is a dangling path.

DimensionReasoningScore

Conciseness

The ~15-line body is lean and assumes Claude's competence: it contains only dispatch rules, conditional branches, and failure handling — no concept explanations, no padding, nothing to trim. Every token earns its place, matching anchor 5 exactly.

5 / 5

Actionability

Guidance is mostly executable: concrete dispatch ("read the matching file in commands/", "read `skills/controller.md`", "execute the `/ingest` phase") and explicit failure protocol ("stop and report the error... Do not advance to the next phase. Offer to retry... or escalate"). It falls short of anchor 5 because the fallback branch "execute the first phase the user requests" is underspecified when no phase is requested, the exact command filenames are implicit, and the referenced files (commands/, skills/controller.md, guidelines.md) are absent from the bundle.

4 / 5

Workflow Clarity

The dispatch sequence is clear with an explicit stop-on-failure checkpoint and a retry/escalate feedback loop covering Jira MCP errors, test failures, and build errors — matching anchor 4's 'clear sequence with most checkpoints present'. It is not anchor 5 because the actual multi-phase sequencing and any checklists are delegated to the controller rather than present here, and the no-command/no-issue-key branch is loose.

4 / 5

Progressive Disclosure

Exemplary progressive disclosure for an orchestrator: a lean overview with three clearly signaled, one-level-deep references, each with its purpose stated ("principles, hard limits, safety, quality, and escalation rules, see `guidelines.md`"). No bundle files are provided, so scoring on the references alone, the structure matches anchor 5's 'well-signaled one-level-deep references; easy navigation'.

5 / 5

Total

18

/

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: third-person, concise, and concrete, enumerating the full story-to-code pipeline with an explicit 'Use when' clause and named activation commands. The only weakness is trigger-term breadth — synonyms like 'ticket', 'issue', or 'user story' are absent, and the trigger is qualified to stories from the design workflow.

DimensionReasoningScore

Specificity

The description lists five concrete pipeline actions — "takes a Jira Story, plans the implementation, writes contract-based tests and production code via TDD, validates against the project's CI expectations, and manages review via GitHub PRs" — with comprehensive coverage from ingestion through review. It exceeds anchor 4 ('several specific actions; minor gaps') because no part of the workflow is left unspecified.

5 / 5

Completeness

Both questions are answered explicitly: 'what' via the detailed action list, and 'when' via "Use when implementing Jira stories produced by the design workflow" plus "Activated by commands: /ingest, /plan, /revise, /code, /validate, /publish, /respond" — concrete trigger phrases, matching the anchor 5 example pattern. It is above anchor 4 because the 'when' is specific and explicit, not merely present.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "Jira Story", "implementing Jira stories", "TDD", "GitHub PRs", "CI", plus seven activation commands. It falls short of anchor 5's 'comprehensive coverage of natural terms including synonyms' because common user variations like "ticket", "issue", "user story", or "pull request" (spelled out) are missing, and the trigger is narrowed by 'produced by the design workflow'.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Jira-story-to-PR implementation pipeline tied to a specific design workflow) with distinct command triggers, so conflict risk with generic coding or TDD skills is minimal. It matches anchor 5's 'clear niche with distinct triggers' and is more distinctive than anchor 4's 'minor overlap risk with closely related skills'.

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

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