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

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

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.

The body is an exemplary lean orchestrator overview: tight routing logic, an explicit stop-on-failure policy, and clearly purpose-labeled one-level-deep references. Its only weaknesses are minor — the command-to-file mapping and per-phase validation details are delegated to files not present in this bundle.

DimensionReasoningScore

Conciseness

The ~25-line body is a lean router: a two-step quick start, a four-sentence failure policy, and one pointer line. Every sentence instructs rather than explains, assumes Claude's competence, and contains no padding or background concepts. It matches the score-5 anchor ("lean and efficient; every token earns its place").

5 / 5

Actionability

For an instruction-only orchestrator the guidance is concrete: exact paths to read ("read the matching file in commands/", "read `skills/controller.md`"), explicit conditionals ("If the user provided a Jira issue key or URL, execute the `/ingest` phase"), and a specific error policy. It falls short of 5 only because the command-to-filename mapping in commands/ and what each phase does are left implicit, leaving a minor gap per the score-4 anchor.

4 / 5

Workflow Clarity

Dispatch is clearly sequenced (numbered steps with nested conditionals) and includes an explicit failure checkpoint with a feedback path ("If a step fails... stop and report the error... Do not advance to the next phase. Offer to retry... or escalate"). It sits at score 4 rather than 5 because the actual multi-phase sequence and per-phase validation are delegated to commands/ and the controller, so checkpoints within the body cover only dispatch, not the phases themselves.

4 / 5

Progressive Disclosure

No bundle files exist under references/, scripts/, or assets/, so scoring is on the references as written: commands/ (per-command instructions), `skills/controller.md` (workflow controller), and `guidelines.md` (each with its purpose stated, e.g., "For principles, hard limits, safety, quality, and escalation rules"). These are well-signaled, one level deep, and the body is an appropriately split overview, matching the score-5 anchor; score 4 would require buried or poorly labeled references, which these are not.

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: concrete third-person action list, explicit 'Use when' guidance, and named activation commands give it a clear, distinct trigger surface. The only gap is missing synonyms for 'Jira story' (ticket, issue, user story) that would broaden natural keyword coverage.

DimensionReasoningScore

Specificity

The description enumerates six concrete 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" — giving comprehensive coverage of the workflow in third-person voice. It exceeds the score-4 anchor ("several specific actions; minor gaps") because no meaningful capability of the workflow is left unnamed.

5 / 5

Completeness

It explicitly answers both questions: what ("Story-to-code workflow that... manages review via GitHub PRs") and when ("Use when implementing Jira stories produced by the design workflow"), with concrete activation triggers ("Activated by commands: /ingest, /plan, /revise, /code, /validate, /publish, /respond"). This is a direct match to the score-5 anchor with explicit trigger phrases; score 4 would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

Natural trigger terms are present — "implementing Jira stories", "Jira Story", "design workflow", plus seven explicit slash commands — but common synonyms like "Jira ticket", "Jira issue", or "user story" are missing. This matches the score-4 anchor ("good keyword coverage; a few natural terms missing") rather than 5, which requires synonyms and variations.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct — Jira story implementation specifically for stories "produced by the design workflow", gated by named slash commands — so conflict with generic coding or document skills is minimal. It matches the score-5 anchor ("clear niche with distinct triggers; minimal conflict risk"); score 4 would imply overlap with closely related skills, which the narrow Jira/design-workflow scoping avoids.

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

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