Mark a devflow task as done — update status, move to done/ folder, and retain learnings.
64
76%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/task-complete/SKILL.mdQuality
Discovery
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 actions it performs, clearly scoping to a devflow task completion workflow. Its main weakness is the absence of an explicit 'Use when...' clause, which limits Claude's ability to know when to trigger this skill. Adding natural trigger terms and explicit usage conditions would strengthen it.
Suggestions
Add a 'Use when...' clause, e.g., 'Use when the user wants to mark a task as done, complete a task, or finish a devflow task.'
Include common trigger term variations such as 'complete', 'finish', 'close task', 'mark complete', or 'task finished' to improve matching.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: update status, move to done/ folder, and retain learnings. These are clear, actionable steps. | 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. | 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 | The description is clearly scoped to a specific workflow action within 'devflow' — marking tasks as done with a specific folder structure. This is a narrow niche unlikely to conflict with other skills. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A solid, actionable skill with clear step-by-step instructions and concrete commands. The workflow is well-sequenced with appropriate checks. Minor verbosity in the introduction and hardcoded absolute paths slightly reduce token efficiency, but overall the skill is well-crafted for its purpose.
| Dimension | Reasoning | Score |
|---|---|---|
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 — bash find, mv, mkdir, YAML frontmatter changes, and a specific retain() call with format. The output template is copy-paste ready. No ambiguity in what Claude should do. | 3 / 3 |
Workflow Clarity | Clear 5-step sequence with logical ordering (find → update → move → retain → report). Includes validation: step 1 checks if already done, step 2 must happen before step 3 (explicitly noted in 'Important'). For a non-destructive operation (moving a file), this level of workflow clarity is sufficient. | 3 / 3 |
Progressive Disclosure | This is a simple, single-purpose skill under 50 lines with no need for external references. Content is well-organized with clear sections (Inputs, Steps, Important) and doesn't need to be split across files. | 3 / 3 |
Total | 11 / 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
b0b1bb6
Table of Contents
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.