CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

reference-searcher

Systematic external reference searching across documentation, open-source repositories, and web resources. Use when working with unfamiliar libraries, APIs, or when needing production-quality implementation examples.

58

Quality

73%

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 ./skills/reference-searcher/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 delivers a well-structured, genuinely additive methodology: a three-layer search strategy with concrete search commands, source-quality criteria, an output template, and anti-patterns. Its main weaknesses are redundancy with the frontmatter description and comment-only pseudo-code blocks instead of executable example commands.

Suggestions

Remove or drastically shrink the 'When to Use This Skill' section — it duplicates the frontmatter description that is always loaded alongside the skill.

Convert the comment-only bash blocks into actual executable example commands (e.g. a real web-search query and a real 'gh search code' invocation) instead of commented illustrations.

Wire the Result Evaluation criteria into the Search Workflow as an explicit checkpoint step (e.g. '4. Evaluate each source against the criteria table before synthesizing').

DimensionReasoningScore

Conciseness

The body is mostly efficient — the grep.app URL pattern, the '(?s)' regex tip, the 1000+ stars heuristic, and the evaluation table all earn their tokens — but the 'When to Use This Skill' section duplicates the frontmatter description and the three bash blocks contain only comments, fitting anchor 3 ('could be tightened') more than anchor 4's minor instances.

3 / 5

Actionability

Concrete, usable guidance throughout: a real grep.app URL pattern, an executable 'gh search code "getServerSession(" --language=TypeScript' command, site: query examples, a complete output-format template, and a worked rate-limiting example. The example queries sit in comment-only blocks rather than ready-to-run commands and 'Synthesize' is underspecified, so it falls short of anchor 5.

4 / 5

Workflow Clarity

The Search Workflow is a clear numbered 4-step sequence (docs → GitHub → web → synthesize), and the Result Evaluation table plus the 'Over-researching — stop when you have enough' anti-pattern supply quality criteria and a stopping rule. Evaluation is not wired into the workflow as an inline checkpoint step, so it does not reach anchor 5's explicit validation steps.

4 / 5

Progressive Disclosure

A single-file skill with no bundle files and no external references; sections are well-organized with clear headers and nothing that belongs in a separate reference file. The body exceeds 50 lines, so the simple-skill exception to anchor 5 does not strictly apply — anchor 4 ('good structure; most content appropriately placed') is the best fit.

4 / 5

Total

15

/

20

Passed

Description

66%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 has an explicit and well-structured 'Use when' trigger clause with fairly natural terms, and it clearly names its three source domains. Its main weaknesses are a single abstract action verb in the 'what' portion and moderate overlap risk with general research/web-search skills.

Suggestions

Replace the abstract 'Systematic external reference searching' with concrete action verbs, e.g. 'Searches official docs, open-source repositories, and the web to find production-quality implementation patterns and best practices.'

Add natural trigger synonyms users would actually say — 'docs', 'examples', 'best practices', 'how to implement X' — to broaden keyword coverage.

Sharpen the niche (e.g. 'for informing implementation decisions when adopting or debugging external libraries') to reduce conflict with general web-search skills.

DimensionReasoningScore

Specificity

The only concrete action is 'searching'; 'across documentation, open-source repositories, and web resources' names the domain's targets but adds no distinct action verbs, matching anchor 3 ('Names domain and 1-2 concrete actions') rather than anchor 4's several specific actions.

3 / 5

Completeness

Both parts are present: 'Systematic external reference searching across documentation, open-source repositories, and web resources' (what) and an explicit 'Use when working with unfamiliar libraries, APIs, or when needing production-quality implementation examples' (when). The 'what' is process-abstract rather than listing concrete actions, keeping it below anchor 5.

4 / 5

Trigger Term Quality

'unfamiliar libraries', 'APIs', 'production-quality implementation examples', and 'documentation' are phrases users would naturally say, giving good keyword coverage; common variations like 'docs', 'examples', or 'best practices' are missing, so it does not reach anchor 5.

4 / 5

Distinctiveness Conflict Risk

'searching across ... web resources' and 'working with unfamiliar libraries' would plausibly also trigger general web-search or research skills, so it fits anchor 3 ('could still overlap with similar skills') rather than anchor 4's minor overlap risk.

3 / 5

Total

14

/

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

ArabelaTso/Skills-4-SE

Path

skills/reference-searcher/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.