CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

veomni-fix-docs

Audit and correct VeOmni documentation links, Markdown, language, and technical claims against repository sources. Use for documentation scans, broken links, typos, or stale instructions in README, docs, examples, and agent guidance.

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

85%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 lean, well-sequenced instruction-only skill: concrete enumeration and validation commands, explicit checkpoints, and decision loops for ambiguity, all in a tight, well-sectioned body without bundle overhead. The main improvement space is supplying the actual search patterns it enumerates and tightening repeated overclaim warnings.

Suggestions

Provide ready-to-use ripgrep patterns (or a short parser one-liner) for the enumerated candidates — Markdown links/images, HTML a[href]/img[src], headings, code fences, repeated words — so the enumeration is directly executable.

Consolidate the three repetitions of the do-not-overclaim guidance (scope item 3, the candidate-list caveat, and the final reporting rule) into one clearly placed rule to trim tokens.

Replace 'Run applicable formatting/quality checks' with the specific commands the target repository uses (or state how to discover them), matching the specificity already shown for the two ci/doc check scripts.

DimensionReasoningScore

Conciseness

The body is dense and prescriptive with no explanations of concepts Claude already knows, but the do-not-overclaim theme is repeated three times (scope item 3, 'Search output is a candidate list, not proof that all links were found', and 'Never state that all documentation is error-free') and several layered sentences could be trimmed, fitting efficient-with-minor-overexplanation rather than every-token-earns-its-place.

4 / 5

Actionability

Concrete copy-paste commands are provided (`git ls-files --cached --others --exclude-standard -- '*.md' '*.mdx'`, `python scripts/ci/docs/check_doc_task_paths.py`, `git diff --check`) along with concrete procedures for relative-path resolution, fragment/permalink checks, and line-anchor verification; however, no actual search patterns are given for the enumerated link/heading types, and 'Use an available Markdown parser or renderer' and 'Run applicable formatting/quality checks' are vague, keeping it below fully-executable.

4 / 5

Workflow Clarity

A clear phase sequence (Scope and baseline → Mechanical checks → Meaning and language → Edit and validate) with numbered checklists, explicit validation steps (`git status --short` before editing, recheck each changed link, Sphinx build warnings, `git diff --check`, inspect the final diff), and feedback loops for error recovery ('Fix only when the destination is clear; otherwise report the uncertainty with file and line'); the batch nature of the work is covered by validation, so no cap applies.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent) and the ~37-line body has no need for external references; per the simple-skill guideline, the six well-organized section headers and absence of nested or buried references earn the top score.

5 / 5

Total

18

/

20

Passed

Description

92%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 strong description: concrete, third-person, VeOmni-scoped capabilities paired with an explicit 'Use for...' clause listing natural trigger terms and target locations. The only improvement space is broader synonym coverage in the trigger terms.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — audit and correct links, Markdown, language, and technical claims 'against repository sources' — covering the full audit domain, matching the comprehensive-coverage anchor; it leaves no minor gaps that would place it at 4.

5 / 5

Completeness

It explicitly answers both what ('Audit and correct VeOmni documentation links, Markdown, language, and technical claims against repository sources') and when ('Use for documentation scans, broken links, typos, or stale instructions in README, docs, examples, and agent guidance') with concrete trigger phrases, matching the top anchor exactly.

5 / 5

Trigger Term Quality

'documentation scans', 'broken links', 'typos', and 'stale instructions' are natural phrases users would say, plus concrete locations (README, docs, examples, agent guidance); common synonyms like 'docs review', 'dead links', or 'documentation check' are missing, so it fits good-but-not-comprehensive keyword coverage rather than 5.

4 / 5

Distinctiveness Conflict Risk

It is scoped to a named project (VeOmni) with distinct trigger contexts and verification sources, forming a clear niche with minimal conflict risk; generic documentation terms alone would risk overlap, but the VeOmni anchoring keeps it distinct.

5 / 5

Total

19

/

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: 2 missing, 2 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

ByteDance-Seed/VeOmni

Path

.agents/skills/veomni-fix-docs/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.