CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aven

Use aven to find tasks, update status, and leave durable handoff context.

Quality

69%

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/aven/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 strong, largely executable command reference with good safety and validation guidance for destructive and batch operations. Its main weaknesses are inline reference-manual bulk (attachments, sync, recurring internals) that belongs in separate files, and the absence of one explicit end-to-end workflow tying the per-topic guidance together.

Suggestions

Move the attachment lifecycle, sync internals, and recurring-task grammar deep detail into one-level-deep reference files (e.g., references/attachments.md, references/recurring.md) linked from a concise SKILL.md overview.

Trim agent-irrelevant detail such as TUI keybindings (Tab/Enter/o) and full JSON field inventories, keeping only what an agent needs to issue commands and interpret output.

Add a short 'Typical workflow' section that sequences the existing pieces explicitly (e.g., list --ready -> context/show --full -> edit -> note) so the multi-step process is not left implicit.

DimensionReasoningScore

Conciseness

The body is dense reference material with no re-teaching of known concepts, but sections like the attachment JSON field inventory ("attachment_id, task_id, sha256, byte_size, media_type, filename..."), sync transfer round limits ("up to 16 unique blobs and 64 MiB"), and TUI keybindings ("Tab focuses locally available images... Enter opens the large TUI preview") are detail that could be tightened or trimmed. It fits anchor 3 ('mostly efficient but could be tightened') rather than anchor 4 because several sections read as a product manual rather than agent instructions.

3 / 5

Actionability

The command catalog is largely copy-paste ready ("aven add \"Fix conflict display\" --status todo --priority high --label bug", "aven edit APP-7KQ9 --due \"in 2 weeks\"") and covers common cases, matching anchor 4. It falls short of anchor 5 because a few commands appear only in prose without syntax examples (e.g., "Use bulk-update --dry-run before broad mutations", "blocked_by=[REFS]" in aven prime).

4 / 5

Workflow Clarity

Validation checkpoints are explicit for risky operations ("Use bulk-update --dry-run before broad mutations", attachment prune --dry-run before --apply, "Inspect dependency context with show <ref> --full before changing task order or status"), satisfying the batch/destructive validation requirement. It is anchor 4 rather than 5 because the implied find -> inspect -> update -> handoff flow is never assembled into one explicit sequenced workflow; guidance is organized per-topic instead.

4 / 5

Progressive Disclosure

The file has clear section headers and code blocks, but roughly 350 lines of reference-manual detail (attachment lifecycle internals, sync blob transfer mechanics, recurring-grammar rules, export/import invariants) that clearly belongs in separate reference files is inlined, and no bundle files exist to offload it. This matches anchor 3 ('some structure but content that should be separate is inline'), not anchor 2, because organization within the file is reasonable.

3 / 5

Total

14

/

20

Passed

Description

58%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 concrete, tool-specific 'what' in third person with three named actions, but it entirely lacks a 'when to use this' trigger clause and natural trigger vocabulary. Adding explicit usage triggers would move completeness and trigger-term quality up substantially.

Suggestions

Add a 'Use when...' clause with concrete triggers, e.g., 'Use when managing tasks in aven, finding or triaging work, updating task status, or leaving handoff notes between sessions.'

Include natural synonyms users would actually say — 'todo', 'to-do list', 'task tracking', 'backlog' — so the skill triggers on everyday task-management language.

Mention task creation and recurring tasks in the capability list so the 'what' covers the skill's full scope, not just lookup and updates.

DimensionReasoningScore

Specificity

"find tasks, update status, and leave durable handoff context" lists three concrete actions, matching anchor 4 ('several specific actions; minor gaps'). It is below anchor 5 because coverage omits creating tasks, recurring work, attachments, and projects, and above anchor 3 because it goes beyond 1-2 actions.

4 / 5

Completeness

The 'what' is clear (find tasks, update status, leave durable handoff context) but there is no 'Use when...' clause or equivalent trigger guidance, which the rubric explicitly caps at anchor 3. It is not anchor 2 because the 'what' half is concrete and specific.

3 / 5

Trigger Term Quality

"tasks" and "status" are relevant natural keywords, but common variations users would say — "todo", "to-do list", "task tracking", "backlog" — are entirely absent, matching anchor 3 ('some relevant keywords but missing common variations or synonyms') rather than anchor 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

"Use aven" anchors the skill to a specific named tool, making it mostly distinct with only minor overlap risk against other task-tracker skills — anchor 4. It is not anchor 5 because the generic phrasing 'find tasks, update status' could describe many task-management tools and no distinctive trigger phrases further differentiate it.

4 / 5

Total

14

/

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

phatblat/dotfiles

Path

.agents/skills/aven/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.