CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

taskify

Task decomposition expert for breaking technical specifications into atomic, implementable tasks with dependencies and priorities. Use when converting specs into actionable task lists for development teams.

Quality

74%

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 ./plugins/dev-skills/skills/taskify/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured, highly actionable instruction-only skill: complete copy-paste output templates, a real dependency-graph example, effort tables, and a sequenced workflow with a pre-finalization checklist. Its weaknesses are redundancy (effort sizing repeated five times, two overlapping process descriptions), explanations of concepts Claude already knows, and a monolithic ~340-line body whose template catalogs belong in reference files.

Suggestions

State the 2-4 hour effort-sizing guidance once (e.g., in 'Right-Sized Effort') and remove the repetitions from 'Your Role', the GitHub issue template, 'Atomic Tasks', and the size labels.

Merge the duplicated process descriptions ('Task Execution' bullets and the 'When given a specification' numbered list) into a single sequenced workflow, and delete 'Task Decomposition Principles' entries that restate knowledge Claude already has (single responsibility, testable criteria, junior/senior sizing).

Move the Option 1/Option 2 output templates, the Task Categorization label taxonomy, and Common Task Patterns into reference files (e.g., references/issue-template.md, references/labels.md, references/patterns.md) linked from a concise overview, reducing SKILL.md to the workflow and decision rules.

DimensionReasoningScore

Conciseness

The full output templates (GitHub issue format, structured task file with dependency graph and effort table) earn their place as concrete output specifications, but there is real padding: the 2-4 hour effort sizing is restated at least five times ('achievable in 2-4 hours', 'Estimated effort: 2-4 hours', '2-4 hour time boxes', 'Mid-level dev: 2-4 hours', 'size:medium 2-4 hours'); 'Task Execution' repeats the same 8-step process already given in the 'When given a specification' list; and 'Task Decomposition Principles' explains concepts Claude already knows (single responsibility, testable criteria, junior/senior effort sizing). This fits the 3 anchor ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than the 2 anchor, since most sections are structured reference material rather than prose padding.

3 / 5

Actionability

The body provides copy-paste-ready output templates (complete GitHub issue frontmatter with labels, acceptance criteria checkboxes, file paths), a concrete structured-file format with a real dependency-graph example and effort summary table, and a specific command ('Ready for `gh issue create` command'). Per the code_vs_instruction note, absence of code is not penalized for an instruction-only skill, and the guidance here is concrete. It misses the 5 anchor on minor gaps: the actual `gh issue create` invocation is never shown, and `$ARGUMENTS`-based branches describe outcomes ('Show dependency graph visualization') without specifying how (e.g., which format/tool) — above the 3 anchor where guidance would be pseudocode-level.

4 / 5

Workflow Clarity

There is a clear sequenced workflow ('When given a specification: 1. Read Entire Spec … 8. Generate Output'), explicit branching on `$ARGUMENTS` (--github, --analyze, general), and a pre-finalization 'Quality Checklist' acting as a validation checkpoint over the batch output. This matches the 4 anchor ('clear sequence with most checkpoints present; minor validation gaps'): the checklist validates the artifact but there is no verify/retry loop (e.g., re-checking after fixing a task that fails the checklist), which the 5 anchor requires. No destructive operations apply, so the destructive-op cap does not.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so everything is inlined in a ~340-line SKILL.md with good section headers but no external references at all. Large template catalogs that would sit naturally in separate files are inlined — the full Option 1/Option 2 output templates (~140 lines), the Task Categorization label taxonomy, and Common Task Patterns — fitting the 3 anchor ('some structure but could be better organized; content that should be separate is inline'). It is above the 2 anchor because the inlined content is well sectioned and navigable, and below the 4 anchor, which expects most bulk content placed in separate referenced files.

3 / 5

Total

14

/

20

Passed

Description

75%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 with a clear third-person 'what' and an explicit 'Use when' trigger clause, naming concrete outputs (atomic tasks, dependencies, priorities). The main gap is that the 'when' clause covers only one scenario and omits natural synonyms and adjacent capabilities the body actually supports (e.g., GitHub issue generation, dependency-graph analysis).

Suggestions

Broaden the 'Use when' clause to include additional concrete triggers, e.g. 'Use when the user asks to break down a spec, plan implementation phases, create tasks/tickets from requirements, or analyze task dependencies.'

Add natural synonyms users would say — 'task breakdown', 'break down this spec', 'work breakdown structure', 'GitHub issues' — to improve trigger-term coverage toward the top anchor.

DimensionReasoningScore

Specificity

Quotes: 'breaking technical specifications into atomic, implementable tasks with dependencies and priorities' and 'converting specs into actionable task lists'. These name the domain plus several concrete deliverables (atomic tasks, dependency mapping, prioritization), matching the 'several specific actions; minor gaps' anchor rather than the 5 anchor, which requires a broader comprehensive action list (e.g., it omits effort estimation, critical-path analysis, and GitHub issue generation that the body actually supports). It is clearly above the 3 anchor, which covers only 1-2 actions without this level of specificity.

4 / 5

Completeness

Both parts are present: what = 'breaking technical specifications into atomic, implementable tasks with dependencies and priorities'; when = 'Use when converting specs into actionable task lists for development teams'. The 'when' clause is explicit but narrow (a single trigger scenario), fitting the 4 anchor ('when could be more explicit or specific') rather than the 5 anchor, which wants multiple concrete trigger phrases; it is far above the 3 anchor where 'when' is missing or only implied.

4 / 5

Trigger Term Quality

Quotes: 'Task decomposition', 'breaking technical specifications', 'converting specs into actionable task lists'. These are phrases a user would plausibly say when needing this skill, giving good keyword coverage per the 4 anchor. It falls short of the 5 anchor because common variations are missing — e.g., 'break down this spec', 'task breakdown', 'work breakdown structure', 'planning', 'tickets/issues' — while still well above the 3 anchor's 'missing common variations' level.

4 / 5

Distinctiveness Conflict Risk

Quotes: 'Task decomposition expert', 'technical specifications', 'atomic, implementable tasks'. This carves a clear niche (spec-to-task breakdown) with mostly distinct triggers, matching the 4 anchor ('mostly distinct; minor overlap risk') — it could mildly overlap with general planning or project-management skills. It lacks the razor-sharp trigger set of the 5 anchor but is far from the generic breadth of the 2-3 anchors.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

rikdc/ai-skills

Path

plugins/dev-skills/skills/taskify/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.