CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

file-search

Perform fast file name and content searches with ripgrep (rg); use it when you need to locate files by glob/regex, find keywords across directories, or replace common find/grep workflows.

Quality

73%

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 ./scientific-skills/Other/file-search/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

46%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 core usage guidance is concrete and executable, but the body is padded with redundant sections and generic template boilerplate, references a nonexistent script, and never points to its own bundled reference file. Trimming the boilerplate and fixing bundle navigation would substantially improve it.

Suggestions

Fix the broken script reference: 'python scripts/test_skill.py' in Example Usage should point to the actual bundled script, scripts/validate_skill.py.

Cut the generic template sections ('Deterministic Output Rules', 'Validation and Safety Rules', 'Failure Handling', 'Completion Checklist', 'Required Inputs', 'Scope Reminder') that add no file-search-specific value, and merge 'Key Features' and 'Implementation Details' into the examples to remove triple repetition of the same rg commands.

Link references/quick-reference.md from the body (e.g., a 'Quick reference: See references/quick-reference.md' line) so the bundled reference is discoverable instead of duplicating its content inline.

DimensionReasoningScore

Conciseness

The body is noticeably verbose: the same commands appear three times across 'Key Features', 'Example Usage', and 'Implementation Details', and 'Implementation Details' explains ripgrep flags ('-C N prints N lines of leading and trailing context', '--type restricts scanning') that Claude already knows. Roughly half the document ('Deterministic Output Rules', 'Validation and Safety Rules', 'Failure Handling', 'Completion Checklist', 'Scope Reminder', 'Output Contract') is generic boilerplate not specific to file searching.

2 / 5

Actionability

The 'Example Usage' block gives concrete, executable, copy-paste-ready commands (rg --version, rg --files --glob "*.rs", rg "TODO|FIXME", rg -C 3 "fn main" --type rust) covering common cases. It falls short of 5 because the example invokes 'python scripts/test_skill.py', which does not exist in the bundle (the actual script is validate_skill.py), and several boilerplate sections offer only vague direction.

4 / 5

Workflow Clarity

A pre-check sequence exists ('ensure ripgrep is installed' before running searches) and 'Recommended Workflow' lists four steps, but those steps are generic template language ('Produce the expected output using the documented file format, schema, or narrative structure') not tied to actual search commands. There are also validation contradictions: 'Quick Validation' states 'No local script validation step is required' while the example runs a self-check script, leaving checkpoints implicit and inconsistent.

3 / 5

Progressive Disclosure

The bundle contains references/quick-reference.md and scripts/validate_skill.py, but the body never links the quick-reference (its command list is duplicated inline in 'Example Usage'/'Implementation Details'), and its only bundle pointer — scripts/test_skill.py — does not exist. Navigation from SKILL.md to the actual bundle files effectively fails, fitting the anchor where content that belongs in separate files is inlined and references are buried.

2 / 5

Total

11

/

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 when...' trigger clause, and natural synonyms (find/grep/ripgrep/rg/glob/regex). Minor improvements possible by mentioning context-line and type-filtering capabilities and sharpening the niche against generic search skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'fast file name and content searches with ripgrep (rg)', 'locate files by glob/regex', 'find keywords across directories', 'replace common find/grep workflows'. It does not reach 5 because the actions partially overlap (file name search ≈ locate by glob; content search ≈ find keywords) and notable capabilities from the body (context lines, type filtering) are absent.

4 / 5

Completeness

It explicitly answers both questions: what it does ('Perform fast file name and content searches with ripgrep (rg)') and when to use it ('use it when you need to locate files by glob/regex, find keywords across directories, or replace common find/grep workflows') with concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

Trigger terms are comprehensive and include synonyms users naturally say: 'locate files', 'find keywords', 'glob/regex', 'find/grep workflows', and both 'ripgrep (rg)' tool names. These map directly onto phrases like 'find all .rs files' or 'grep for TODO'.

5 / 5

Distinctiveness Conflict Risk

Naming the tool (ripgrep/rg) and the find/grep replacement niche makes it mostly distinct, but the generic 'file search' domain means a user saying 'search my code for X' could plausibly trigger other search-related skills, so minor overlap risk remains — between anchors 4 and 5, noticeably above midpoint but not a clear-cut anchor-5 niche.

4 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

aipoch/medical-research-skills

Path

scientific-skills/Other/file-search/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.