CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

research

Default entry point for any research request — a hybrid router that classifies the question deterministically and either delegates to a specialist research skill (pulse for trends/sentiment, grants for NIH funding, litreview for academic literature, syllabus for course reading, patent for prior-art + IP landscape, dossier for entity research, deepread for evidence-first reading of supplied documents) or runs its own plan-decompose-multi-source-search-synthesize-cite fallback workflow when no specialist matches. Always surfaces the routing decision so users can override. Use when the user makes any research request that doesn't obviously match a more-specific specialist skill (e.g., "research [topic]", "look into [topic]", "what do we know about [topic]", "investigate [topic]", "find me information on [topic]", "do some research on [topic]", "I need to understand [topic]"). Output is a markdown briefing (default) or .docx document (on request) with full citations and an audit log.

72

Quality

90%

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

81%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-engineered router skill with excellent actionability and workflow clarity — executable script invocations, verbatim intake scripts, explicit routing rules, feedback loops, and a thorough failure-mode table. Its weakness is token efficiency: the SIGNALS map is maintained in three places (registry table, Phase 2 code block, classifier.py), the anti-patterns section rehashes the integrity rules and failure modes, and maintainer-taxonomy notes occupy runtime context.

Suggestions

Collapse the Phase 2 SIGNALS code block to the scoring rules only and delegate the phrase list to scripts/classifier.py as the single source of truth (keeping one summary row per specialist in the registry table), removing ~40 duplicated lines.

Merge 'Anti-Patterns Rejected' into the 'Failure Modes' table (or drop rows that restate Agent Integrity Rules, e.g. 'Silent delegation' vs 'Routing discipline: Never delegate silently').

Move the 'Distinct From engineering/autoresearch-agent' taxonomy note and the version/build-pattern footer into a maintainer reference file — they document the skill pack, not the runtime workflow.

DimensionReasoningScore

Conciseness

Mostly operational but noticeably redundant: the Phase 2 SIGNALS dict ("pulse: [reddit, hn, x.com, buzz…]", ~45 lines with comments) duplicates the Specialist Registry table and scripts/classifier.py verbatim; "Anti-Patterns Rejected" rows like "Silent delegation (always surface routing decision)" and "Refusing to route to a specialist when ≥2 signals match" restate the Agent Integrity Rules and Failure Modes table; and the maintainer-taxonomy section "Distinct From engineering/autoresearch-agent… No overlap. They coexist." is not runtime instruction. This exceeds the minor-trimming of the 4 anchor, but the bulk is genuinely operational — not the padded explanations of known concepts that define the 2 anchor.

3 / 5

Actionability

Fully executable guidance: copy-paste-ready commands ("scripts/classifier.py --question '...' --output json", "routing_transparency_logger.py --action record_delegation"), verbatim intake question scripts with refusal follow-ups ("What about AI specifically — adoption, safety, capability, funding, regulation, comparison?"), concrete audit-log templates, and specific budgets ("1 q/sec", "2–4 queries per source"). The pseudocode classifier block is justified because the executable script exists and the body mandates "Use it; don't re-implement."

5 / 5

Workflow Clarity

The multi-phase sequence is explicit with skip and stop conditions ("Most invocations exit intake after Q1 + Q2", "Skip if classification produced a silent route", "Stop condition: After Q4… commit and start Phase 2"), feedback loops for error recovery ("On failure → wait 3s → retry once → log. After 3 consecutive failures: stop, alert user"; "Specialist delegation fails → Offer to retry or fall back to general research"), and a ten-row failure-mode checklist covering edge cases like missing specialist skills and thin search results.

5 / 5

Progressive Disclosure

Bundle structure matches the body: all three scripts and all three references (hybrid_router_architecture.md, deterministic_classification_canon.md, fallback_workflow_canon.md) exist, are clearly signaled under "Tooling" and "Reference Docs" with one-line descriptions, and references are one level deep (they point only to SKILL.md and scripts, not to further docs). The gap keeping it below 5: the full signal list is inlined in the body duplicating classifier.py instead of living solely in the script with a pointer — content that could be appropriately split remains inline.

4 / 5

Total

17

/

20

Passed

Description

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

An exemplary description: it states the router's concrete mechanics, names all seven specialists with their domains, specifies both output formats, and provides seven natural user trigger phrases plus an explicit 'Use when' clause. Its only softness is inherent to a router role — broad triggers that intentionally overlap the specialists it delegates to, mitigated by the explicit specialist carve-out.

DimensionReasoningScore

Specificity

Lists multiple concrete actions with comprehensive coverage: "classifies the question deterministically", "delegates to a specialist research skill (pulse for trends/sentiment, grants for NIH funding, litreview for academic literature…)" naming all seven specialists with their domains, "runs its own plan-decompose-multi-source-search-synthesize-cite fallback workflow", and "Output is a markdown briefing (default) or .docx document (on request)". This matches the anchor-5 example's breadth of specific actions; no meaningful capability is left unstated.

5 / 5

Completeness

Explicitly answers both questions: what (deterministic classification → specialist delegation or own fallback workflow, with output formats and an audit log) and when ("Use when the user makes any research request that doesn't obviously match a more-specific specialist skill (e.g., 'research [topic]', 'look into [topic]'…)"). Both are concrete and explicit, matching the 5 anchor; the third-person voice requirement is also satisfied.

5 / 5

Trigger Term Quality

Comprehensive natural trigger phrasings users would actually say: "research [topic]", "look into [topic]", "what do we know about [topic]", "investigate [topic]", "find me information on [topic]", "do some research on [topic]", "I need to understand [topic]", plus domain synonyms (trends/sentiment, NIH funding, prior-art + IP landscape). Coverage including variations matches the 5 anchor, not the 4 anchor which expects a few missing natural terms.

5 / 5

Distinctiveness Conflict Risk

It names the seven specialist skills it routes to and carves out its own trigger space ("any research request that doesn't obviously match a more-specific specialist skill"), making the boundary explicit. However, its triggers ("investigate [topic]", "research [topic]") intentionally overlap the same trigger space as the specialists it delegates to, and whether a request "obviously matches" is left to judgment — minor, deliberate overlap risk rather than the minimal-conflict 5 anchor.

4 / 5

Total

19

/

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

alirezarezvani/claude-skills

Path

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