CtrlK
BlogDocsLog inGet started
Tessl Logo

research

Build a structured research outline (items + field definitions) on a topic, mixing model knowledge with a single web-search supplement pass. Writes outline.yaml and fields.yaml to a topic-named subdirectory. Entry point of the 5-phase research pipeline.

59

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 ./plugins/ultra-research/skills/research/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 content is a well-structured, actionable workflow with a genuine validation checkpoint and clean one-level-deep reference disclosure. It is held back only by minor verbosity and the lack of explicit error-recovery feedback loops.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — it gives workflow control, YAML schemas, and a routing rubric without explaining concepts Claude already knows; only minor phrasing (e.g., the 'Dispatch-only' rationale) could be trimmed.

4 / 5

Actionability

Provides concrete executable guidance — exact `date +%Y-%m-%d` command, full outline.yaml/fields.yaml schemas, named AskUserQuestion options with descriptions, and a dispatch rule pointing to a verbatim template — with only minor gaps (the YAML blocks are templates rather than fully runnable artifacts).

4 / 5

Workflow Clarity

A clear 5-step sequence with an explicit validation checkpoint in Step 5 ('Before asking, Read the two files you just wrote and apply this thinness rubric') and a routing checklist; minor gaps in error-recovery feedback keep it just below 5.

4 / 5

Progressive Disclosure

Well-organized sections (Trigger, Pipeline Context, Workflow, Output, References) with a single, clearly signaled one-level-deep reference to references/prompt-templates.md, which exists as a real bundle file.

5 / 5

Total

17

/

20

Passed

Description

58%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 is specific and third-person with concrete outputs, but lacks any explicit trigger/usage guidance, capping completeness and trigger-term quality. Adding a 'Use when...' clause with natural user phrases would lift the weaker dimensions.

Suggestions

Add an explicit 'Use when...' clause naming natural user phrases (e.g., 'Use when the user wants to plan or scope a research project before fanning out searches').

Include common trigger synonyms such as 'research plan', 'research outline', 'scoping a topic', or 'prepare a research framework' to improve trigger-term coverage.

Briefly note when NOT to use it (e.g., not for ad-hoc single-question lookup) to further reduce overlap with the deep-research phase.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'Build a structured research outline (items + field definitions)', 'mixing model knowledge with a single web-search supplement pass', 'Writes outline.yaml and fields.yaml to a topic-named subdirectory' — with only minor coverage gaps (no mention of the merge/confirm interactions).

4 / 5

Completeness

The 'what' is clearly stated (build outline, write outline.yaml/fields.yaml), but there is no 'Use when...' clause or equivalent explicit 'when' guidance, which per the rubric caps completeness at 3.

3 / 5

Trigger Term Quality

Contains relevant keywords ('research outline', 'topic', 'web-search') but misses common natural variations or synonyms a user would actually say, and offers no explicit trigger phrases.

3 / 5

Distinctiveness Conflict Risk

The niche is fairly distinct — 'research outline (items + field definitions)' with specific YAML outputs and a stated 5-phase pipeline role — with only minor overlap risk against other research-oriented skills.

4 / 5

Total

14

/

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

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

Warning

Total

15

/

16

Passed

Repository
seanGSISG/claude-depot
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.