CtrlK
BlogDocsLog inGet started
Tessl Logo

task-complete

Mark a devflow task as done — update status, move to done/ folder, and retain learnings.

64

Quality

76%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/task-complete/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%

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

A well-structured, actionable skill that clearly guides task completion with concrete commands and a logical workflow. Minor verbosity in the introduction and hardcoded absolute paths slightly reduce token efficiency, but overall the skill is effective and easy to follow. The explicit output template and guardrails in the 'Important' section are strong additions.

DimensionReasoningScore

Conciseness

Mostly efficient but has some unnecessary explanation (e.g., 'This skill handles the lifecycle transition from in-progress/open to done' is filler). The hardcoded absolute paths add visual noise but are arguably necessary for specificity. The note about `depends_on` is useful context.

2 / 3

Actionability

Every step has concrete, executable commands — find, mv, mkdir, frontmatter edits, and even the retain() call with a template. The output format is explicitly specified. Copy-paste ready with clear placeholders.

3 / 3

Workflow Clarity

Clear 5-step sequence with logical ordering (find → update → move → retain → report). Includes a validation check in step 1 (already in done/), and the 'Important' section provides guardrails. For this non-destructive operation, the level of validation is appropriate.

3 / 3

Progressive Disclosure

This is a simple, single-purpose skill under 50 lines. Content is well-organized with clear sections (Inputs, Steps, Important) and doesn't need external references. The structure is appropriate for the complexity.

3 / 3

Total

11

/

12

Passed

Description

67%

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 specific about what it does, listing three concrete actions within a clearly defined domain (devflow task management). Its main weakness is the absence of an explicit 'Use when...' clause, which limits Claude's ability to match it to user requests. Adding natural trigger terms and explicit usage guidance would strengthen it.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user says a task is done, finished, or complete, or asks to close/complete a devflow task.'

Include common trigger term variations such as 'complete', 'finish', 'close task', 'mark complete' to improve matching against natural user language.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: update status, move to done/ folder, and retain learnings. These are clear, actionable operations.

3 / 3

Completeness

Clearly answers 'what' (update status, move to done/ folder, retain learnings) but lacks an explicit 'Use when...' clause specifying when Claude should select this skill. The 'when' is only implied by the opening phrase 'Mark a devflow task as done'.

2 / 3

Trigger Term Quality

Includes some relevant terms like 'done', 'task', 'status', and 'devflow', but misses common variations users might say such as 'complete', 'finish', 'close task', 'mark complete', or 'task finished'.

2 / 3

Distinctiveness Conflict Risk

Highly specific to the devflow task management system with distinct concepts like 'done/ folder' and 'retain learnings'. Unlikely to conflict with other skills due to the narrow, well-defined niche.

3 / 3

Total

10

/

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.

Repository
AndreJorgeLopes/devflow
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.