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/harness/adapters/antigravity/skills/aven/SKILL.md

The canonical home for this skill is aven in phatblat/dotfiles

SKILL.md
Quality
Evals
Security

Quality

Content

58%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 body is an extremely lean stub whose entire content is a redirect to an external skill file outside the bundle. While token-efficient and unambiguous as an instruction, it provides no actual task guidance, no workflow, and its single reference cannot be verified from the skill's own files, leaving a reader dependent on an unresolvable path.

Suggestions

Inline a minimal quick-start (how to list/find aven tasks and update status) instead of delegating 100% of the guidance to an external path that is not part of the skill bundle.

If delegation is intentional, reference a file that ships inside the skill bundle (e.g. references/SKILL-core.md) so the pointer is resolvable and verifiable, and briefly state what the reader will find there.

Add at least a one-line summary of the core workflow (find task → update status → leave handoff note) so the skill body stands on its own if the external file is unavailable.

DimensionReasoningScore

Conciseness

The body is two lines — an HTML generation comment and "Load and follow the shared skill at `~/.agents/skills/aven/SKILL.md`" — with zero padding or explanation of concepts Claude already knows. Every token present is doing work; this matches the "lean and efficient; every token earns its place" anchor exactly.

5 / 5

Actionability

"Load and follow the shared skill at `~/.agents/skills/aven/SKILL.md`" is a concrete, specific directive with a real path, but the body itself contains none of the actual task guidance — no commands, examples, or steps for finding tasks, updating status, or leaving handoff context. Not 4 because the executable guidance is only the redirect itself, leaving major gaps; not 2 because the one instruction given is specific and unambiguous rather than a high-level hint.

3 / 5

Workflow Clarity

The only step present is a single delegation instruction; the workflows for the capabilities named in the description (find tasks, update status, write handoff context) are entirely absent, with no sequencing and no validation checkpoints. The simple-skill exception does not apply because the description covers multiple capabilities, not one unambiguous single task. Not 3 because there is no sequence of steps listed at all beyond the redirect — only a degenerate one-step body with large gaps.

2 / 5

Progressive Disclosure

The single reference is clearly signaled and one level deep, but it points outside the skill bundle to an absolute home-directory path (`~/.agents/skills/aven/SKILL.md`) rather than to files in references/, and no bundle files exist to verify. The body provides no overview content of its own — it is a bare redirect, which is "some structure" but not well-organized progressive disclosure. Not 4 because content placement cannot be assessed and the reference is unresolvable from the bundle; not 2 because the reference is not buried and there is no inlined content that belongs elsewhere.

3 / 5

Total

13

/

20

Passed

Description

66%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 concise, third-person description that names the tool and three concrete capabilities, with decent natural trigger terms. Its main weakness is the complete absence of a "Use when..." clause, so Claude gets no explicit guidance on when to invoke it, and some common task-management synonyms are missing.

Suggestions

Add an explicit trigger clause, e.g. "Use when working with aven tasks, updating task status, or preparing handoff/standup notes."

Include common synonyms users would say — todo, ticket, task list, standup, handoff — to broaden natural trigger coverage.

Briefly anchor what aven is (e.g. "the aven task tracker") so the description is self-contained and less likely to be skipped by readers unfamiliar with the tool.

DimensionReasoningScore

Specificity

"find tasks, update status, and leave durable handoff context" lists several concrete actions (find, update, leave) tied to the aven tool. Not 5 because coverage has minor gaps — e.g., it never says what aven is (a task tracker) or what "durable handoff context" concretely involves; not 3 because more than 1-2 specific actions are named.

4 / 5

Completeness

The "what" is clear (find tasks, update status, leave handoff context) but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric guidelines. Not 4 because the "when" is entirely absent rather than merely implicit or underspecified.

3 / 5

Trigger Term Quality

"tasks", "status", and "handoff" are natural phrases a user would say when needing this skill. Not 5 because common synonyms and variations (todo, ticket, assignment, task queue, standup/handoff notes) are missing; not 3 because multiple relevant natural keywords are present, not just one generic one.

4 / 5

Distinctiveness Conflict Risk

Naming the specific tool "aven" gives a clear niche, and the actions (task finding, status updates, handoff context) are distinctive. Not 5 because "find tasks" and "update status" could overlap with generic todo-list or project-management skills; not 3 because the named tool plus the handoff-context angle keep it mostly distinct.

4 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.agents/harness/adapters/antigravity/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.