CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

octopus-research

Thorough research across multiple sources — use for complex topics needing broad synthesis

Quality

68%

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

Quality

Content

62%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's core strength is its rigorously gated workflow with genuine validation and error-recovery loops, backed by concrete executable commands. Its weaknesses are heavy repetition of the same enforcement rule (six restatements), a copy-paste artifact in the banner, and references to files that are not part of the bundle.

Suggestions

Consolidate the repeated enforcement language into the single HARD-GATE block at the top and remove the redundant restatements in Step 3, Step 4, and the Error Handling section — one authoritative statement plus the step sequence carries the same force at a fraction of the tokens.

Remove the duplicated Antigravity CLI line in the provider banner template.

Either ship the referenced files (skills/blocks/codex-host-adapter.md, skill-security-framing.md) in the bundle or inline their essential content — dangling references in a monolithic SKILL.md make navigation unreliable; the question set and banner template are also natural candidates for a separate reference file.

DimensionReasoningScore

Conciseness

The same enforcement instruction — must call orchestrate.sh, never research directly — is restated at least six times (the HARD-GATE block, the "CRITICAL: You are PROHIBITED" list, "This is NOT optional", Step 4's "DO NOT substitute", the Error Handling section, and "Never fall back to direct research"), which is noticeable padding. The banner template also carries a duplicated line (Antigravity CLI appears twice), and the Error Handling section largely re-lists per-step rules already stated inline, though the content itself never explains concepts Claude already knows.

2 / 5

Actionability

Concrete, mostly copy-paste-ready commands are given: the check-providers.sh invocation with status parsing, the orchestrate.sh call with explicit --intensity mapping rules, and the find-based synthesis-file validation script. Minor gaps keep it from a 5: TaskUpdate uses a placeholder `taskId: "..."`, and the AskUserQuestion/TaskCreate snippets assume host tooling and ${HOME}/.claude-octopus install paths without fallback guidance.

4 / 5

Workflow Clarity

The five steps are explicitly sequenced with blocking gates ("DO NOT PROCEED TO STEP 2 until all questions are answered", "DO NOT PROCEED TO STEP 3 until banner displayed") and a dedicated validation gate (Step 4's synthesis-file check with a failure branch, plus a per-step Error Handling section with feedback loops). This matches the top anchor: clear sequence, explicit validation, and error-recovery paths.

5 / 5

Progressive Disclosure

The step-based section headers give reasonable structure, but no bundle files ship with this skill while the body references two files that are not present ("skills/blocks/codex-host-adapter.md" and "skill-security-framing.md"), and content that would naturally live in reference files (the full question set, the banner template) is inlined. This lands on score 3 — structure present but references dangle and separable content is inline — rather than score 4's 'references mostly clear, most content appropriately placed'.

3 / 5

Total

14

/

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 grammatically clean, third-person, and includes both a what and a when-clause, but every element is stated at a high level of abstraction. It would benefit from naming the skill's actual differentiator (multi-provider/multi-AI research orchestration) and concrete trigger phrases.

Suggestions

Name the concrete capability that distinguishes this skill, e.g., 'Dispatches research probes to external AI provider CLIs (Codex, Antigravity) and synthesizes their findings into a single report' instead of generic 'thorough research'.

Add natural trigger phrases and synonyms users would actually say: 'Use for deep dives, investigations, or multi-source comparisons', covering 'deep dive', 'investigate', 'look into'.

Make the 'when' clause concrete by tying it to the workflow, e.g., 'use when a question needs parallel perspectives from multiple AI providers rather than a quick single-source lookup'.

DimensionReasoningScore

Specificity

"Thorough research across multiple sources" and "broad synthesis" name the research domain with roughly two actions, but they stay generic — no concrete mechanism (e.g., multi-provider probing or orchestration) is stated. It sits above score 2 ('actions are minimal') because two actions and their scope are given, and below score 4 because no list of specific actions appears.

3 / 5

Completeness

Both parts are present: the 'what' ("Thorough research across multiple sources ... broad synthesis") and an explicit 'when' ("use for complex topics needing broad synthesis"). The 'when' clause is explicit but not concrete — 'complex topics' is not a specific trigger phrase, so it falls short of score 5 while clearly exceeding score 3's 'when is missing or only weakly implied'.

4 / 5

Trigger Term Quality

"research", "complex topics", and "synthesis" are relevant natural keywords, but common user phrasings like "deep dive", "investigate", "look into", or "compare sources" are missing. This matches the anchor 'some relevant keywords but missing common variations or synonyms' rather than score 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

"Thorough research across multiple sources" could apply to almost any web-research or search skill; nothing in the description signals this skill's distinct multi-provider orchestration niche. It is somewhat specific ('research', 'broad synthesis') but overlaps with the many similar research skills — matching score 3, not score 2's 'helps with document files' level of genericness.

3 / 5

Total

13

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

nyldn/claude-octopus

Path

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