CtrlK
BlogDocsLog inGet started
Tessl Logo

voice-persona-venus

Route to Venus (sharp executive-assistant voice persona). Used for logistics — calendar, tasks, recent messages, brain lookups — at sub-second phone-call latency. The default voice persona unless DEFAULT_PERSONA=mars is set.

63

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./recipes/agent-voice/skills/voice-persona-venus/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 tight, high-signal persona spec: concrete tool surfaces, exact URLs and file paths, explicit anti-patterns, and a guarantees-backed Contract section, with only minor redundancy (the write-prohibition stated three times) and small navigation oddities. Actionability is exemplary for an instruction-only skill.

DimensionReasoningScore

Conciseness

The body is lean and directive throughout ("1-3 sentences max, lead with the answer, not the process", "SHUT UP. Wait.") with essentially no explanation of concepts Claude already knows. It falls short of anchor 5 only because the read-only/write-prohibition contract is stated three times (the Trust blockquote, the Tool posture section, and the Contract section), which could be consolidated.

4 / 5

Actionability

Guidance is fully concrete and copy-paste ready for an instruction-only skill: an exact example URL ('/call?persona=venus&topicId=q3-planning&topicName=Q3%20Planning'), the exact topicId slug regex, exact tool op names, exact file paths, exact fallback phrasings ("I can't save from voice; tell me again when you're at your screen"), and second-precision timing rules. This matches 'fully executable... specific examples cover the common cases'.

5 / 5

Workflow Clarity

The flow — trigger match, session persona resolution, prompt file, tool surface, timing rules — is clearly sequenced with a stated fallback ('No topicId → Venus uses her generic today-at-a-glance context'). It is anchor 4 rather than 5 because there are no error-recovery/feedback loops (e.g., what to do when a topicId fails the slug validation is unspecified). No destructive or batch operations exist, so the cap-at-3 rule does not apply.

4 / 5

Progressive Disclosure

No bundle files exist, so structure rests on the file itself: sections are well-organized with clear headers, and external references (services/voice-agent/code/tools.mjs, ../voice-persona-mars/SKILL.md) are clearly signaled and one level deep. It is not a 5 because those references point outside the skill bundle (not navigable within it), and the 'Output Format' section exists purely for test compatibility rather than user-facing navigation.

4 / 5

Total

17

/

20

Passed

Description

70%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, distinctive description with an explicit 'used for' clause and natural keywords, weakened mainly by thin action specificity — one routing verb plus a task-area list rather than several concrete capabilities. Trigger coverage would be stronger if the natural synonyms from the frontmatter triggers (schedule, what's on my calendar) were reflected in the description text.

Suggestions

Replace or augment the single 'Route to Venus' verb with 2-3 concrete actions (e.g., 'Reads calendar and tasks, recites recent messages, looks up brain notes by voice') so the capability list is specific rather than domain-naming.

Fold one or two natural trigger phrasings into the description itself (e.g., 'Use when the caller asks what's on my calendar or what their tasks are') so the when-clause carries concrete trigger phrases, not just a domain list.

DimensionReasoningScore

Specificity

The description's only concrete action verb is "Route to Venus"; "calendar, tasks, recent messages, brain lookups" name domain areas rather than distinct actions, matching the anchor for naming a domain with 1-2 concrete actions but not comprehensive coverage. A score of 4 would require several specific listed actions (the way 'extracts, fills, merges' does), which this single-verb description lacks.

3 / 5

Completeness

Both parts are present: "Route to Venus (sharp executive-assistant voice persona)... at sub-second phone-call latency" answers what, and "Used for logistics — calendar, tasks, recent messages, brain lookups" is an explicit when-clause (so the 3-cap does not apply). The when is a domain listing rather than concrete trigger phrasing, and the trailing "default unless DEFAULT_PERSONA=mars" clause dilutes it, keeping this at anchor 4 rather than 5.

4 / 5

Trigger Term Quality

Natural user vocabulary is present — "calendar", "tasks", "recent messages", "phone-call" — but common synonyms a caller would say ("schedule", "agenda", "reminders", "to-dos") appear only in the frontmatter triggers list, not in the description itself. This fits 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

"Sharp executive-assistant voice persona" plus the explicit "unless DEFAULT_PERSONA=mars is set" disambiguation carves a mostly distinct niche and directly handles the closest sibling skill. It is not a 5 because "calendar" and "tasks" are generic words with overlap risk against ordinary productivity/task skills, and a closely related sister persona shares the voice-persona space.

4 / 5

Total

15

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 4 suspicious

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

13

/

16

Passed

Repository
garrytan/gbrain
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.