write-ok

Write a deterministic OK file to out/ok.txt.

Quality

17%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./examples/evaluation/skill/skills/write-ok/SKILL.md

Quality

Discovery

17%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This description is extremely terse and narrowly scoped, describing a single mechanical action without explaining its purpose or when it should be triggered. It lacks natural trigger terms and a 'Use when...' clause, making it very difficult for Claude to know when to select this skill from a pool of options.

Suggestions

Add a 'Use when...' clause explaining the circumstances that should trigger this skill, e.g., 'Use when a health check, build verification, or smoke test output is needed.'

Include natural trigger terms a user might say, such as 'health check', 'smoke test', 'build verification', or 'status file'.

Expand the 'what' to explain the purpose of writing this file, e.g., 'Generates a deterministic OK status file at out/ok.txt to confirm successful build or test completion.'

Dimension	Reasoning	Score
Specificity	It names a specific action ('write a deterministic OK file') and a specific output path ('out/ok.txt'), but describes only a single narrow action rather than listing multiple concrete capabilities.	2 / 3
Completeness	It partially answers 'what' (write an OK file) but provides no 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per the rubric, a missing 'Use when' clause caps completeness at 2, and the 'what' is also minimal, warranting a 1.	1 / 3
Trigger Term Quality	The description lacks natural keywords a user would say. Terms like 'deterministic OK file' and 'out/ok.txt' are highly specific internal jargon unlikely to match user queries naturally.	1 / 3
Distinctiveness Conflict Risk	The very specific file path 'out/ok.txt' makes it somewhat distinctive, but the purpose is so unclear that it could be confused with other file-writing or testing skills without clearer context.	2 / 3
	Total	6 / 12 Passed

Implementation

N/A

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Something went wrong

Validation

100%

Warnings & errors only

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.

Repository: trpc-group/trpc-agent-go
Commit: cdd7db9

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.