CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

research-workflow

Systematic research workflow orchestrating multi-source research operations for comprehensive domain investigation. Sequential workflow from web search through GitHub exploration and documentation analysis to research synthesis. Use when researching new domains, gathering patterns, investigating technologies, or conducting comprehensive multi-source research for skill development.

Quality

69%

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 ./.claude/skills/research-workflow/SKILL.md

The canonical home for this skill is research-workflow in fernandezbaptiste/Skrillz

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 body presents a clearly sequenced 5-step research workflow with good structure, but it is thin on executable guidance (no queries, finding formats, or synthesis template) and repeats the same step information three times. It reads more as a process overview than an operational skill.

Suggestions

Consolidate the triplicated step listings (Overview, per-step sections, Quick Reference table) into a single canonical listing with the table as the only summary, cutting roughly a third of the body.

Add concrete per-step guidance: example search queries for Step 1, what to record from each GitHub repo/doc source, and a structure or template for the research-synthesis.md output.

Insert validation checkpoints before synthesis, e.g., 'proceed only when at least 3 credible sources have been collected; verify official docs are primary sources for claims' with a retry loop if insufficient.

DimensionReasoningScore

Conciseness

The 5-step workflow is restated nearly verbatim three times (Overview list, per-step sections, Quick Reference table), e.g., 'Find best practices, recent information' vs 'Search for best practices, recent blog posts, community knowledge'. Not score 2 because there is no padding with concepts Claude already knows, and not score 4 because the triple repetition is avoidable over-explanation that could be consolidated into one listing.

3 / 5

Actionability

Steps are one-line high-level directions ('Search for best practices, recent blog posts, community knowledge') with no example search queries, no format for recording findings per step, and no synthesis document template; the only concrete artifact is 'research-synthesis.md with 3-5 sources'. Not score 3 because there is no partially-executable guidance like pseudocode or concrete sub-steps, and not score 1 because the step outputs and result artifact are named.

2 / 5

Workflow Clarity

The 5-step sequence is clearly ordered with time budgets and the optional step explicitly flagged, but validation checkpoints are absent (e.g., a source-credibility or minimum-source check before synthesis). Not score 4 because checkpoints are entirely missing rather than having minor gaps, and not score 2 because the sequence itself is coherent, well-sequenced, and includes outputs per step.

3 / 5

Progressive Disclosure

A single, well-organized file with clear section headers, a summary table, and no nested or buried references; no bundle files exist, and the short content does not need external files. Not score 5 because the redundancy across Overview, step sections, and Quick Reference indicates organization could be tighter and the 'Use in: development-workflow Step 1' cross-reference is unlinked, and not score 3 because structure and navigation are genuinely good.

4 / 5

Total

12

/

20

Passed

Description

80%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 with an explicit 'Use when...' clause and a clearly enumerated multi-source workflow. Its main weaknesses are trigger terms that overlap with generic research skills and actions described at the source level rather than as concrete capabilities.

DimensionReasoningScore

Specificity

The description enumerates several concrete actions in sequence ('web search through GitHub exploration and documentation analysis to research synthesis'), but the actions are named sources rather than concrete capabilities, leaving minor gaps in coverage. It is not score 5 because the actions lack the comprehensiveness and concreteness of the top anchor, and not score 3 because it clearly lists multiple specific operations rather than just 1-2.

4 / 5

Completeness

It explicitly answers both what ('orchestrating multi-source research operations... from web search through GitHub exploration and documentation analysis to research synthesis') and when ('Use when researching new domains, gathering patterns, investigating technologies...') with concrete trigger phrases. Not score 4 because the 'when' clause is already explicit and specific, meeting the top anchor.

5 / 5

Trigger Term Quality

'researching new domains, gathering patterns, investigating technologies' are natural phrases a user would say, giving good keyword coverage. It is not score 5 because common variations and synonyms (e.g., 'look up', 'find best practices', 'explore a codebase') are missing, and not score 3 because the included terms are natural and relevant rather than partially missing.

4 / 5

Distinctiveness Conflict Risk

The skill is scoped to research for skill development, but trigger phrases like 'gathering patterns, investigating technologies' are broad and overlap with general web-search or research skills. Not score 4 because the overlap risk extends beyond closely related skills, and not score 2 because the multi-source workflow framing gives it some distinct identity.

3 / 5

Total

16

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/research-workflow/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.