CtrlK
BlogDocsLog inGet started
Tessl Logo

engram-sdd-flow

Spec-Driven Development workflow for Engram. Trigger: When user requests SDD or multi-phase implementation planning.

61

Quality

71%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/sdd-flow/SKILL.md
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 content is exceptionally concise and well-structured with a clear phase sequence and exit checklist, but it stays at a structural level without executable per-phase guidance. Adding concrete steps or examples for each phase would raise actionability.

Suggestions

For each phase, add 1-2 concrete actions or example commands (e.g., how 'explore' gathers findings, what 'verify' runs) to move from structure to execution.

Add an explicit per-phase validation checkpoint (e.g., 'Exit explore when findings + risks are documented') to complement the final Exit Criteria checklist.

Optionally link to a reference file with phase-by-phase templates so the SKILL.md stays lean while providing depth.

DimensionReasoningScore

Conciseness

The body is a lean set of bullet lists and a checklist with no padding and no explanation of concepts Claude already knows; every line earns its place.

5 / 5

Actionability

It names concrete phases and per-phase artifacts plus exit criteria, but gives no executable steps, commands, or specifics on how to perform each phase, fitting the 'some concrete guidance but incomplete' anchor.

3 / 5

Workflow Clarity

The five phases are clearly numbered in canonical order with a 'Never skip a phase' guard and an Exit Criteria checklist acting as checkpoints, but per-phase validation is only implied rather than explicit, leaving minor gaps below anchor 5.

4 / 5

Progressive Disclosure

Under 50 lines with no external references needed and well-organized into clearly headed sections (When to Use, Phase Order, Artifacts, Exit Criteria), matching the simple-skill exception for a 5.

5 / 5

Total

17

/

20

Passed

Description

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

The description is concise and supplies an explicit trigger, but it describes a generic 'workflow' without concrete capabilities, leaving the what somewhat vague. Adding 1-2 concrete actions would lift specificity and completeness.

Suggestions

Replace 'workflow' with 1-2 concrete actions, e.g. 'Coordinates spec, design, implementation, and validation phases for Engram changes'.

Add natural synonyms to the trigger, e.g. 'spec-driven development', 'multi-phase implementation', or 'phased change planning'.

Clarify what Engram-specific outcomes the skill produces so the 'what' is as concrete as the 'when'.

DimensionReasoningScore

Specificity

The description names the domain ('Spec-Driven Development workflow for Engram') but 'workflow' is generic and no concrete actions are listed, matching the anchor for naming the domain with minimal or generic actions.

2 / 5

Completeness

Both 'what' (SDD workflow for Engram) and 'when' (explicit Trigger clause) are present, but the 'what' is generic rather than enumerating concrete actions, so it does not reach the fully concrete anchor 5.

4 / 5

Trigger Term Quality

It includes an explicit trigger clause ('Trigger: When user requests SDD or multi-phase implementation planning') with natural phrases a user would say, though synonyms are limited, fitting the 'good keyword coverage' anchor above the midpoint.

4 / 5

Distinctiveness Conflict Risk

Scoping to 'Engram' and 'SDD' gives it a distinct niche with minimal conflict risk within that system, though 'workflow' language leaves minor overlap with general planning skills.

4 / 5

Total

14

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Gentleman-Programming/engram
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.