CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-research-process

Builds a skill from official documentation through categorized research, citation review, integration, and final validation. Use when researching a tool or library before creating a skill, when "research for skill" or "create comprehensive skill" is requested, or when extensive multi-source documentation gathering is needed.

68

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

85%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.

A well-structured authoring workflow: stages are clearly sequenced with explicit gates, validation checklists, feedback loops, and failure recovery, while detailed worker prompts are properly offloaded to one-level-deep reference files. The only deductions are minor repetition of the relay-exactness instruction and a couple of deliberately abstract commands.

DimensionReasoningScore

Conciseness

The body is lean with no explanation of concepts Claude already knows and every section carries procedure, but the preserve-exact-failure theme recurs ~5 times ("Preserve each structured worker result and its exact failure reason", "relay the exact reason", "Relay worker results without interpretation"), leaving minor trim opportunities — anchor 4 rather than 5.

4 / 5

Actionability

Concrete guidance dominates: exact scratch path ".tmp/scratch/plans/{skill-name}-research-plan.md", structured result fields "STATUS", "ARTIFACTS", "SOURCES", "GAPS", "WARNINGS", a filled-in final report template, and anchor-linked handoffs. Minor gaps remain: "Run the package-appropriate existing validator" names no command, and "Use the host's available worker mechanism" is deliberately abstract — anchor 4, not quite copy-paste-ready 5.

4 / 5

Workflow Clarity

A clear three-stage sequence with an explicit overview diagram, three validation gates with checklists ("Gate 2: Source and Citation Review" enumerates per-category confirmations), feedback loops ("Return a category with unsupported claims to the same worker with the exact claims, not a summary"; "revalidate their citations before integration"), and a dedicated Failure Recovery section — matches anchor 5.

5 / 5

Progressive Disclosure

The body is an overview; worker handoff details are offloaded to references/agent-prompts.md via anchor links that resolve to real headings (## Categorization Handoff, ## Research Handoff, ## Integration Handoff), plus mcp-tools.md and gaps-analysis.md in a References section — all one level deep, all files verified to exist, matching the anchor-5 structure.

5 / 5

Total

18

/

20

Passed

Description

83%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: third-person, concise, no fluff, with an explicit 'Use when...' clause containing quoted trigger phrases. It clearly states both what the skill does and when to invoke it, with only minor abstractness in its action naming and one slightly broad trigger.

DimensionReasoningScore

Specificity

"Builds a skill from official documentation through categorized research, citation review, integration, and final validation" lists several specific actions with comprehensive pipeline coverage, but the actions are process-stage labels ('citation review', 'integration') rather than fully concrete operations, so it sits between the 4 and 5 anchors — closer to 4.

4 / 5

Completeness

The 'what' is explicit ("Builds a skill from official documentation through categorized research, citation review, integration, and final validation") and the 'when' is explicit with concrete trigger phrases ("Use when researching a tool or library before creating a skill, when 'research for skill' or 'create comprehensive skill' is requested..."), matching the anchor-5 example.

5 / 5

Trigger Term Quality

Natural phrases users would say are present — "researching a tool or library", "research for skill", "create comprehensive skill", "multi-source documentation gathering" — but common variants like "build a skill" or "document a library" are missing, matching 'good keyword coverage; a few natural terms missing'.

4 / 5

Distinctiveness Conflict Risk

The skill-creation niche with distinct triggers like "research for skill" is mostly distinct, but the broader trigger "when extensive multi-source documentation gathering is needed" could overlap with generic research skills — minor overlap risk, matching anchor 4.

4 / 5

Total

17

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

Jamie-BitFlight/claude_skills

Path

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