CtrlK
BlogDocsLog inGet started
Tessl Logo

researcher-hand-skill

Expert knowledge for AI deep research — methodology, source evaluation, search optimization, cross-referencing, synthesis, and citation formats

58

Quality

68%

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 ./crates/openfang-hands/bundled/researcher/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable with concrete templates, scoring rubrics, and a well-sequenced research workflow, but it is monolithic and includes some explanatory padding Claude already knows. Splitting large reference blocks into bundle files and trimming common-knowledge material would lift conciseness and progressive disclosure.

Suggestions

Move citation formats, output report templates, and domain-specific tips into separate reference files (e.g. CITATION_FORMATS.md, REPORT_TEMPLATES.md) and signal them from SKILL.md to improve progressive disclosure.

Trim common-knowledge content such as the cognitive-bias definitions and generic domain tips, keeping only the non-obvious operational guidance.

Lead the body with a concise quick-start section that shows the end-to-end flow, then reference detailed sections, so the overview is lean.

DimensionReasoningScore

Conciseness

The body is mostly efficient expert reference material (CRAAP scoring, verification levels, search operators) but includes unnecessary explanation Claude already knows, e.g. 'Confirmation bias: Favoring information that confirms your initial hypothesis' and 'Stack Overflow answers may be outdated'; it is not 3 because of this padding, and not 1 because the bulk is genuinely additive, not boilerplate.

2 / 3

Actionability

It provides copy-paste-ready templates (narrative synthesis skeleton, structured synthesis, APA/footnote/numbered citation formats, brief and detailed report templates) and a concrete CRAAP scoring rubric with search operators; it is not 2 because guidance is specific and complete rather than pseudocode, and the instruction-only nature is fully actionable per the scoring notes.

3 / 3

Workflow Clarity

The 5-phase process (Define, Search, Evaluate, Synthesize, Verify) is clearly sequenced with a Verify checkpoint, and contradiction resolution plus gap analysis act as feedback loops; it is not 2 because checkpoints are explicit, and not below 2 because the multi-step process is unambiguous.

3 / 3

Progressive Disclosure

Content is well-organized into sections but is a 328-line monolithic SKILL.md with no bundle files and reference-worthy material (citation formats, output templates, domain tips) kept inline; it is not 3 because the file exceeds the 50-line simple-skill threshold and content that should be split is inline, and not 1 because sections are clearly labeled rather than a nested-reference mess.

2 / 3

Total

10

/

12

Passed

Description

60%

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 specific and lists clear capabilities but lacks an explicit 'Use when...' trigger clause and natural trigger-term coverage, which together cap completeness and trigger quality at 2. Adding a usage trigger with common user phrasings would move it toward the top band.

Suggestions

Append an explicit trigger clause, e.g. 'Use when conducting in-depth research, evaluating source credibility, cross-checking claims, or producing cited research reports.'

Include natural user phrasings users would actually say ('research this', 'find reliable sources', 'verify these claims') alongside the current terminology.

Tighten the niche framing to reduce overlap with generic research/web-search skills, e.g. 'for multi-source, citation-backed deep research reports'.

DimensionReasoningScore

Specificity

The description names six concrete capabilities — 'methodology, source evaluation, search optimization, cross-referencing, synthesis, and citation formats' — matching the anchor for multiple specific concrete actions; it is not below 2 because it is comprehensive, and the actions are too explicitly listed to be merely domain-plus-some.

3 / 3

Completeness

It clearly states what the skill does but has no 'Use when...' clause or equivalent explicit trigger guidance, which per the judging guidelines caps completeness at 2; it is not 3 because the 'when' is entirely absent, and not 1 because the 'what' is explicit and detailed.

2 / 3

Trigger Term Quality

Terms like 'deep research', 'source evaluation', and 'search optimization' are relevant but miss common phrasings a user would actually say ('research this', 'verify these claims', 'find reliable sources'); it is not 3 because natural keyword coverage is partial, and not 1 because the keywords present are reasonable rather than jargon.

2 / 3

Distinctiveness Conflict Risk

'Expert knowledge for AI deep research' carves a recognizable niche but 'research' is broad and could overlap with general web-search or research skills; it is not 3 because the triggers are not distinct enough to rule out conflicts, and not 1 because it is more specific than generic 'helps with research'.

2 / 3

Total

9

/

12

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.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 2 missing

Warning

Total

14

/

16

Passed

Repository
RightNow-AI/openfang
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.