CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

golden-word

Use when testing the word golden build

Quality

41%

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 ./tests/golden/phase2/word/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

21%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 auto-generated documentation index rather than skill instructions: it catalogs sections, statistics, and scraped snippets but never tells Claude what to do. Navigation to the two real reference files is its only structural strength; the rest is padded, partially broken filler.

Suggestions

Replace the metadata, statistics, quick-reference, and code-example sections with a short task-oriented guide: what questions this skill answers and the 2-3 step lookup workflow (check references/index.md for the topic, then read the relevant section of references/manual.md).

Delete the dummy 'x0 = 0 ... x37' filler example and the empty 'From section: API Usage' table stub — they consume tokens and misrepresent the documentation.

Move the extracted code examples and table contents into references/manual.md or a dedicated examples file, keeping SKILL.md to a concise overview with one-level-deep, clearly labeled links.

DimensionReasoningScore

Conciseness

The body is padded with auto-generated boilerplate — document metadata (author, created/modified dates), a statistics section that duplicates the section overview, and a ~40-line dummy Python example ('x0 = 0 ... x37 = 37') that ends mid-token with '...' and teaches nothing. It is noticeably verbose with several padded sections, though it does not explain concepts Claude already knows, placing it at anchor 2 rather than 1.

2 / 5

Actionability

The body is entirely descriptive metadata — section counts, topic lists, scraped code snippets like 'pip install thing' and "print('hello')" — with no instruction on what to do with any of it. It describes rather than instructs, matching anchor 1 (no concrete code or commands in service of the skill's task).

1 / 5

Workflow Clarity

No sequenced process exists; the only implied path is 'consult references/index.md, then references/manual.md', which is a rough, implicit sequence with major gaps and no checkpoints. It does not fall to anchor 1 because a navigable structure and section numbering do exist, but it lacks anything resembling anchor 3's explicit step list.

2 / 5

Progressive Disclosure

References are real (references/index.md and references/manual.md both exist), one level deep, and clearly signaled in a Navigation section. However, large content that belongs in those files — full code examples, table dumps (one of which is empty), and statistics — is inlined in SKILL.md, matching anchor 3 (some structure, content that should be separate is inline) rather than 4.

3 / 5

Total

8

/

20

Passed

Description

32%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 a bare 'Use when...' clause with no statement of what the skill actually does. Its only strength is a somewhat distinctive domain term; it fails on capability specificity, trigger coverage, and completeness.

Suggestions

Add a concrete 'what' statement before the trigger, e.g. 'Indexes and serves the Golden_Word documentation: getting-started, API usage, and troubleshooting. Use when testing the word golden build or when the user asks about Golden_Word setup, API usage, or common errors.'

Include natural trigger synonyms users would actually say (e.g. 'golden word', 'golden build', 'installing golden word', 'golden word errors') rather than the single cryptic phrase.

Clarify the domain so 'word' does not read as Microsoft Word documents, reducing conflict risk with word-processing skills.

DimensionReasoningScore

Specificity

The description names a domain ('testing the word golden build') but names no concrete capability actions — 'testing' alone is generic with no operations specified. It sits below the midpoint between anchor 1 (no concrete actions at all) and anchor 3 (domain plus 1-2 concrete actions), since the domain is named but no action beyond the vague verb 'testing' appears.

2 / 5

Completeness

Only the 'when' half is present ('Use when testing the word golden build') with no 'what' — exactly matching anchor 2's example 'Use when working with documents'. It cannot score 3 (clear 'what' present) or 4 (both what and when).

2 / 5

Trigger Term Quality

Only a couple of keywords ('testing', 'word', 'golden build') appear, with no synonyms, file extensions, or natural phrases a user would actually say. It matches anchor 2 ('one or two generic keywords; missing the natural phrases users say') better than anchor 3, which expects a fuller set of relevant keywords.

2 / 5

Distinctiveness Conflict Risk

'golden build' is a distinct niche term unlikely to trigger unrelated skills, but the word 'word' creates minor overlap risk with Word-document skills and the trigger phrasing is thin. This places it at anchor 4 (mostly distinct, minor overlap) rather than 5 (clear niche with distinct, concrete triggers).

4 / 5

Total

10

/

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

yusufkaraaslan/Skill_Seekers

Path

tests/golden/phase2/word/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.