CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ov-resources

Search and read documents, repos, URLs, and other resources stored in OpenViking under viking://resources/. Use whenever the user asks about docs, specs, codebases, papers, or notes that were added to OpenViking ("check the docs", "what does our design doc say", "find it in OpenViking"), or when a task needs reference material this session does not have. Covers picking between find, grep, glob, and list, and drilling from a hit down to the exact file.

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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, well-organized instruction skill: domain-specific knowledge only, a concrete tool-selection table, and a clear search workflow with fallbacks. The main gaps are semi-placeholder tool signatures instead of fully executable call examples, and error-recovery guidance that is separated from the drill-down sequence rather than integrated as checkpoints.

Suggestions

Show one fully literal example call chain (e.g. find → read .overview.md → scoped grep → read with offset/limit) so the signatures in the table become copy-paste ready.

Fold the no-hits and low-score recovery guidance into the Drill down steps as explicit checkpoints (e.g. step 2b: 'if all scores < 0.4, rephrase with the domain's terms') instead of deferring it to Tips.

DimensionReasoningScore

Conciseness

The body is lean and imperative throughout — the .abstract.md/.overview.md convention, the tool-selection table, the "Low scores (under ~0.4) are usually noise" threshold — all OpenViking-specific knowledge Claude does not already have, with no padding or explanation of known concepts. Matches anchor 5: every token earns its place.

5 / 5

Actionability

Concrete invocation patterns are given ("find(query, target_uri=\"viking://resources\")", "glob(pattern, uri) e.g. **/*.pdf", "read(uris=[...])") plus a numbered drill-down, but several entries are signature placeholders rather than fully copy-paste-ready calls — mostly executable with minor gaps, matching anchor 4 rather than anchor 5.

4 / 5

Workflow Clarity

The drill-down gives a clear 4-step sequence with a stopping rule ("Stop as soon as you have what the task needs") and feedback loops (no-hits → "list viking://resources"; low scores → rephrase), but the recovery guidance lives in a separate Tips section rather than as explicit checkpoints inside the sequence — fits anchor 4 (clear sequence, minor validation gaps). No destructive/batch cap applies since this is a read-only search skill.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files and no need for external references; the body is cleanly organized into "Pick the tool", "Drill down", and "Tips" sections with no dangling file references. Per the rubric's simple-skill guideline, well-organized sections alone merit anchor 5.

5 / 5

Total

18

/

20

Passed

Description

91%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 capabilities, an explicit "Use whenever" trigger clause with natural quoted phrases, and a clearly-scoped niche. The only weaknesses are slightly generic core verbs and a broad "needs reference material" catch-all that could occasionally fire outside the OpenViking niche.

DimensionReasoningScore

Specificity

"Search and read documents, repos, URLs" plus "picking between find, grep, glob, and list, and drilling from a hit down to the exact file" name several concrete actions, but the core verbs ("search", "read") remain fairly generic, leaving minor coverage gaps — above anchor 3 (only 1-2 actions), below anchor 5's comprehensive action list.

4 / 5

Completeness

Explicitly answers what ("Search and read documents, repos, URLs, and other resources stored in OpenViking under viking://resources/") and when ("Use whenever the user asks about docs, specs, codebases, papers, or notes that were added to OpenViking") with concrete quoted trigger phrases — a clear match to anchor 5.

5 / 5

Trigger Term Quality

"docs, specs, codebases, papers, or notes" covers the natural synonyms, and quoted user utterances ("check the docs", "what does our design doc say", "find it in OpenViking") capture exactly what users would say — comprehensive for this domain, matching anchor 5 rather than the "a few natural terms missing" of anchor 4.

5 / 5

Distinctiveness Conflict Risk

The "OpenViking" / "viking://resources/" niche and named triggers are clearly distinct, but the broad catch-all "or when a task needs reference material this session does not have" creates minor overlap risk with general search/reference skills — fits anchor 4 (mostly distinct, minor overlap) rather than anchor 5's minimal conflict risk.

4 / 5

Total

18

/

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

volcengine/OpenViking

Path

agent-plugins/skills/ov-resources/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.