CtrlK
BlogDocsLog inGet started
Tessl Logo

file-todos

Manage file-based todos stored alongside a dossier. Create, triage, and track dependencies. Use when work is tracked in docs/*/todos.

61

Quality

71%

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/00-utilities/file-todos/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 highly actionable with concrete, executable commands and clearly sequenced workflows. It is somewhat verbose and inlines material that could live in separate reference files despite good section organization.

Suggestions

Move the Quick Reference Commands and Key Distinctions blocks into a separate reference file, keeping SKILL.md as an overview that links out.

Trim explanatory rationale (e.g., 'Work logs serve as', 'When to create vs act immediately') to the essential rules.

Add an explicit validation/checkpoint step in the triage rename workflow (e.g., confirm frontmatter status updated before renaming).

DimensionReasoningScore

Conciseness

The body is mostly efficient and action-oriented, but ~250 lines include some padding (e.g., 'Work logs serve as:' rationale list, 'When to create a todo' / 'When to act immediately' guidance) that could be trimmed.

3 / 5

Actionability

Provides copy-paste-ready bash commands (issue ID discovery, file rename, dependency grep, counting by status) and concrete frontmatter examples covering the common cases.

5 / 5

Workflow Clarity

Creating, triaging, and completing workflows are clearly numbered and sequenced with a verification checkpoint in the completion flow, though triage's file-rename step lacks an explicit validate step.

4 / 5

Progressive Disclosure

Good section structure and one clearly-signaled bundle reference (assets/todo-template.md, which exists), but substantial reference-style content (command quick reference, distinctions, structure details) is inlined rather than split into separate files.

3 / 5

Total

15

/

20

Passed

Description

71%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 is third-person, concrete, and explicitly answers both what and when, with a clearly distinct niche. Its main weakness is a path-glob trigger that is not natural user language and lacks synonyms.

Suggestions

Replace or augment the path-glob trigger with natural user phrases (e.g., 'Use when creating, triaging, or tracking review todos, dependencies, or work items').

Add a couple of synonyms or common variations (todos, work items, triage, dependencies) to broaden trigger coverage.

DimensionReasoningScore

Specificity

Names the domain ('file-based todos stored alongside a dossier') and several concrete actions ('Create, triage, and track dependencies'), with only minor coverage gaps.

4 / 5

Completeness

Both 'what' (manage/create/triage/track file-based todos) and 'when' ('Use when work is tracked in docs/*/todos') are present and explicit, though the when clause is a single path-based condition.

4 / 5

Trigger Term Quality

The trigger ('Use when work is tracked in docs/*/todos') is a directory glob rather than natural user phrasing, and lacks synonyms or common variations users would actually say.

3 / 5

Distinctiveness Conflict Risk

The 'file-based todos alongside a dossier' niche tied to a specific docs/*/todos path is clearly distinct with minimal conflict risk against other skills.

5 / 5

Total

16

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
marchatton/agent-skills
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.