CtrlK
BlogDocsLog inGet started
Tessl Logo

writing-plans

Write a detailed implementation plan for a feature, spec, or ticket, breaking the work into bite-sized, testable tasks with exact file paths, code samples, and test commands an engineer can follow step by step. This is the internal planning stage of the delivery-flow workflow, run after delivery-flow splits the work into multiple meaningful implementation units. It is not a standalone entry point, so do not activate it directly for a one-off user request or a narrow change; use delivery-flow for those instead.

70

Quality

86%

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 tessleng/sdlc-planning

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.

The body is a lean, highly actionable instruction skill: complete templates, exact commands, expected test outcomes, and a self-review checklist with feedback loops. Its only real gaps are minor — slight redundancy between the task-sizing sections and no use of external reference files to move the large templates out of the main body.

DimensionReasoningScore

Conciseness

The body is directive and assumes competence ("DRY. YAGNI. TDD. Frequent commits.", "Assume they are a skilled developer") with no padding explaining known concepts, but the Task Right-Sizing and Bite-Sized Task Granularity sections overlap and a few rationale sentences ("You reason best about code you can hold in context at once") could be trimmed, matching the efficient-with-minor-trimmables anchor.

4 / 5

Actionability

Full copy-paste-ready templates give exact file paths (`Create: exact/path/to/file.py`), runnable commands (`pytest tests/path/test.py::test_name -v`, `git commit -m "feat: ..."`), expected outcomes ("Expected: FAIL with 'function not defined'"), and an explicit ban on placeholders — fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

The process is clearly sequenced (announce → scope check → file structure → task sizing → header → tasks → self-review → handoff) with explicit validation checkpoints baked into every task template (run the test to verify it fails, then verify it passes) and a fix-and-continue feedback loop in Self-Review ("If you find issues, fix them inline... If you find a spec requirement with no task, add the task").

5 / 5

Progressive Disclosure

The skill is a single self-contained file with clear section headers and no nested references (no references/, scripts/, or assets/ bundles exist), but the two substantial markdown templates are inlined and there are no external reference files at all, leaving minor organization/split opportunities — matching the good-structure-with-minor-gaps anchor rather than the clear overview with well-signaled references.

4 / 5

Total

18

/

20

Passed

Description

83%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 specific, concrete, and highly distinctive, with explicit workflow positioning that prevents mis-triggering against the parent delivery-flow skill. Its only weakness is that the "when" guidance is expressed as workflow placement and negative instruction rather than natural positive trigger phrases, leaving trigger coverage slightly incomplete.

DimensionReasoningScore

Specificity

"breaking the work into bite-sized, testable tasks with exact file paths, code samples, and test commands an engineer can follow step by step" lists multiple concrete actions with concrete deliverable artifacts, matching the comprehensive-coverage anchor rather than the minor-gaps anchor below it.

5 / 5

Completeness

The "what" is explicit and concrete, and the "when" is present ("run after delivery-flow splits the work into multiple meaningful implementation units"), but the trigger guidance is workflow-positional and negative ("do not activate it directly") rather than concrete positive trigger phrases, so it does not reach the anchor 5 example.

4 / 5

Trigger Term Quality

"implementation plan", "feature, spec, or ticket" are natural terms users would say, but common variations such as "design doc", "planning", or "break down this work" are missing, so coverage is good but not comprehensive.

4 / 5

Distinctiveness Conflict Risk

"It is not a standalone entry point, so do not activate it directly for a one-off user request or a narrow change; use delivery-flow for those instead" carves out a clear niche and explicitly disambiguates against the nearest conflicting skill, giving minimal conflict risk.

5 / 5

Total

18

/

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
tesslio/tessl-eval-demo
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.