CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl-fe/writing-plans

Use when you have a spec or requirements for a multi-step task, before touching code

72

Quality

90%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

This version of the plugin could not be moderated
Moderation could not be completed for this version. Please contact support@tessl.io.
Overview
Quality
Evals
Security
Files

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a strong, actionable skill that provides concrete templates and clear workflows for generating implementation plans. Its main strength is the fully executable task structure template with TDD cycle and the thorough self-review checklist. The primary weakness is moderate verbosity — some sections explain general software engineering principles Claude already knows (file decomposition, single responsibility) and the 'No Placeholders' section could be more concise.

Suggestions

Trim the 'File Structure' section to remove general software design advice (single responsibility, clear boundaries) that Claude already knows — keep only the codebase-specific guidance about following existing patterns.

Condense the 'No Placeholders' section into a compact bullet list or a single 'banned patterns' line rather than explaining each anti-pattern separately.

DimensionReasoningScore

Conciseness

The skill is mostly efficient but includes some unnecessary elaboration. The 'No Placeholders' section lists many examples that could be condensed, and the 'File Structure' section includes general software design advice (single responsibility, clear boundaries) that Claude already knows. The 'Scope Check' section is somewhat redundant. However, the task structure template and plan header are appropriately detailed.

2 / 3

Actionability

The skill provides fully concrete, copy-paste-ready templates including the exact plan header format, task structure with markdown code blocks, specific pytest commands, git commit examples, and checkbox syntax. The task granularity examples are specific and executable. The self-review checklist gives concrete verification steps.

3 / 3

Workflow Clarity

The workflow is clearly sequenced: scope check → file structure mapping → task decomposition → plan writing with header → self-review → execution handoff. Each task follows an explicit test-driven cycle (write failing test → verify failure → implement → verify pass → commit). The self-review section serves as a validation checkpoint with specific checks (spec coverage, placeholder scan, type consistency), and the execution handoff provides clear branching paths.

3 / 3

Progressive Disclosure

The skill references two sub-skills (subagent-driven-development, executing-plans) and a git worktrees skill appropriately, but all content is inline in a single file. The 'No Placeholders' section, 'File Structure' guidance, and 'Bite-Sized Task Granularity' section could potentially be split into referenced files for better organization. However, the content is well-structured with clear headers and the total length is manageable.

2 / 3

Total

10

/

12

Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong skill description that excels across all dimensions. It provides specific concrete outputs, includes a comprehensive set of natural trigger terms, has an explicit 'Use when' clause with clear trigger scenarios, and carves out a distinct niche in the pre-implementation planning space. The description is well-structured and concise without being verbose.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'analyzes specifications and requirements', 'step-by-step implementation plans', 'discrete tasks', 'exact file paths', 'ready-to-run code and test examples', and 'commit checkpoints'. These are detailed and actionable outputs.

3 / 3

Completeness

Clearly answers both 'what' (analyzes specs to produce detailed implementation plans with tasks, file paths, code examples, and commit checkpoints) and 'when' (explicit 'Use when' clause specifying trigger scenarios like having a spec/PRD/requirements and needing a concrete plan before writing code).

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'spec', 'PRD', 'requirements document', 'feature description', 'task breakdown', 'implementation steps', 'decompose requirements', 'project planning'. These are all terms users would naturally use when requesting this kind of work.

3 / 3

Distinctiveness Conflict Risk

Occupies a clear niche: pre-implementation planning from specifications. The focus on specs/PRDs as input and implementation plans as output, combined with the explicit 'before writing any code' qualifier, distinguishes it well from general coding skills or documentation skills.

3 / 3

Total

12

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Reviewed

Table of Contents