CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sdlc-plan-tasks

Generates formal, structured, and executable implementation plan documents based on specifications.

Quality

63%

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 ./.agents/skills/sdlc-plan-tasks/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

62%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 a strong, highly actionable planning procedure with excellent workflow sequencing, validation checkpoints, and self-correction loops — the process engineering is top-tier. Its weaknesses are efficiency, not correctness: a persona-override theater section, heavy directive redundancy across sections, and a monolithic structure that inlines large reference material (the plan template, documentation standards) that should be split into bundle files.

Suggestions

Delete the 'Dynamic Persona Activation' section and consolidate duplicated guidance: vertical slicing, task sizing, and the plan-only/handoff rules are each stated in 2-4 places (Phase 1, Core Directives, AI-Optimized Standards, Red Flags) — state each once and cross-reference.

Move the Mandatory Implementation Plan Template and the Documentation Standards (CONTEXT.md/ADR formats) into references/ files (e.g. references/plan-template.md, references/doc-standards.md) so they are loaded only when generating or updating artifacts, keeping SKILL.md as a lean overview.

Trim explanations of concepts Claude already knows (tracer bullets, expand-contract, 'make the change easy then make the easy change') down to the policy decision — that this skill mandates them and how to apply them here — without the tutorial-style good/bad framing.

DimensionReasoningScore

Conciseness

The body is noticeably verbose: the 'Dynamic Persona Activation [CRITICAL SYSTEM OVERRIDE]' section is pure roleplay padding with no planning value, emphasis theater ('YOU ARE HEREBY COMMANDED', pervasive bold/caps 'MUST') inflates every directive, and the same guidance is restated in multiple sections (vertical slicing and task sizing each appear in Phase 1, AI-Optimized Standards, and Red Flags; handoff rules in both Core Directives and Phase 4). It is not a 1 because most content is genuinely skill-specific policy rather than generic explanation.

2 / 5

Actionability

The core deliverable is fully executable: a complete copy-paste-ready Implementation Plan Template, an exact naming convention with example ('plan-feature-user_auth-v1.0.md'), a concrete task-sizing table, verbatim handoff prompts, and step-by-step audit remediation with a ready-made markdown block. It falls short of 5 because several peripheral steps remain high-level ('Clarify goals and identify affected components', 'present a comparison table with trade-offs' with no format specified, 'Review existing codebase patterns and test coverage').

4 / 5

Workflow Clarity

The four phases are clearly sequenced with explicit validation throughout: a Context Check Protocol gating on upstream spec documents, mandatory clarification on ambiguity, an interactive 'Quiz the User' breakdown review before plan generation, a 7-item red-flag self-audit with a mandatory rewrite loop, per-phase APPROVAL checkpoints, and score-threshold routing (>=80 / <80) for remediated plans. This matches the top anchor: explicit validation steps, feedback loops for error recovery, and checklists for a complex process.

5 / 5

Progressive Disclosure

There are no bundle files at all (no references/, scripts/, or assets/), and everything — including the ~90-line Mandatory Implementation Plan Template, the Documentation Standards section, and the Red Flags checklist — is inlined in a ~310-line SKILL.md. Internal header structure is good and navigation within the file is easy, so it is above level 2 ('minimal structure'), but content that clearly belongs in separate on-demand reference files is inlined, matching 'some structure but could be better organized'.

3 / 5

Total

14

/

20

Passed

Description

45%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 communicates a clear and specific deliverable but reads as a half-complete description: it answers 'what' adequately and stops there. It lacks any 'when to use' trigger guidance and natural trigger synonyms, which hurts both completeness and distinctiveness. A single sentence appending use-case triggers would lift most dimensions.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the technical specification is approved and you need to break it down into an actionable, phased task plan, or when creating files in /plan/'.

Enumerate the concrete actions the skill performs (e.g., 'breaks specs into vertically-sliced tasks, sequences the dependency graph bottom-up, sizes tasks, and audits the plan against anti-patterns') instead of stacking adjectives like 'formal, structured, and executable' on one verb.

Include natural user phrasings as trigger terms — 'planning', 'task breakdown', 'implementation roadmap', 'plan the execution of the spec' — so the skill is discoverable from how users actually ask.

DimensionReasoningScore

Specificity

The description names its domain ('implementation plan documents based on specifications') but provides only a single generic action — 'Generates' — with adjectives ('formal, structured, and executable') acting as qualifiers rather than distinct concrete actions. This matches 'Names the domain but actions are minimal or generic' rather than level 3, which requires 1-2 separate concrete actions.

2 / 5

Completeness

The 'what' is clearly stated ('Generates formal, structured, and executable implementation plan documents based on specifications'), but there is no 'Use when...' clause or any equivalent explicit trigger guidance — 'based on specifications' only weakly implies when. Per the judging guideline, a missing 'Use when' clause caps completeness at 3; it is not 4 because the 'when' is not merely under-specified, it is absent.

3 / 5

Trigger Term Quality

'implementation plan' and 'specifications' are relevant keywords a user might say, but common natural variations — 'planning', 'task breakdown', 'roadmap', 'break down the work', 'project plan' — are absent. Good coverage would require several of these synonyms, so this lands at 'some relevant keywords but missing common variations'.

3 / 5

Distinctiveness Conflict Risk

The artifact type ('implementation plan documents') carves a recognizable niche distinct from sibling SDLC skills (clarify-reqs, write-code), but with no trigger phrases the description could still fire for generic planning, roadmap, or task-breakdown requests. It is 'somewhat specific but could still overlap with similar skills' rather than 'mostly distinct with minor overlap risk', since distinctiveness rests entirely on the what-clause.

3 / 5

Total

11

/

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

glenrioariesto/social-content-studio

Path

.agents/skills/sdlc-plan-tasks/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.