CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

research-summarizer

Structured research summarization agent skill for non-dev users. Handles academic papers, web articles, reports, and documentation. Extracts key findings, generates comparative analyses, and produces properly formatted citations. Use when: user wants to summarize a research paper, compare multiple sources, extract citations from documents, or create structured research briefs. Plugin for Claude Code, Codex, Gemini CLI, and OpenClaw.

68

Quality

85%

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

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 highly actionable, well-sequenced skill with executable commands that match its real scripts, explicit verification loops, and a clean reference structure. Its main weakness is token efficiency: marketing prose, a user-facing Installation section, and templates duplicated between the body and references/summary-templates.md inflate the body.

Suggestions

Trim the positioning prose (tagline, 'Built for product managers...', 'Not a generic summarize this' paragraph) and the user-facing Installation section, or move installation to a separate README — they add tokens without model guidance value.

Remove the inline academic scaffold, comparison matrix, and synthesis-brief templates from the workflow sections; reference references/summary-templates.md for each instead, keeping only a one-line pointer per workflow.

Drop the per-format citation list in the body (APA/IEEE/Chicago/Harvard/MLA descriptions) since references/citation-formats.md already carries that detail; keep only the APA 7 default and a pointer.

DimensionReasoningScore

Conciseness

Mostly efficient — workflows, tooling usage, and the quality table are concrete — but there is more than minor padding: the marketing tagline and positioning prose ("Built for product managers, analysts, founders, and anyone who reads more than they should have to"; "Not a generic 'summarize this' — a repeatable framework"), an Installation section aimed at users rather than the model, and the full academic scaffold inlined in Workflow 1 that duplicates references/summary-templates.md. This fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') better than anchor 4's 'minor instances'.

3 / 5

Actionability

Fully executable guidance: commands like `python3 scripts/format_summary.py --template academic` and `python3 scripts/extract_citations.py document.txt --output json` (flags verified against the actual scripts), fill-in scaffolds for each output type, a concrete High/Med/Low quality table, and specific default behavior (APA 7, 2-5 source comparisons). Anchor 5's 'copy-paste ready commands covering the common cases' is met across all three workflows; it exceeds anchor 4 because no material execution detail is missing.

5 / 5

Workflow Clarity

Three workflows each with a numbered, clearly sequenced process, plus an explicit Verification Loop checklist that includes an executable check ("exits 0 and its `total` matches the bibliography count... investigate any gap") and an anti-hallucination rule ("missing metadata is marked 'not stated', never filled in"). This matches anchor 5's 'explicit validation steps; feedback loops; checklists for complex processes'; anchor 4 would require missing checkpoints, and none are material.

5 / 5

Progressive Disclosure

Good structure with well-signaled, verified one-level-deep references (a 'Summary Templates' section listing exactly what references/summary-templates.md and references/citation-formats.md contain) and a Tooling section documenting both scripts. It falls short of anchor 5 because content that was deferred to the references — the academic template scaffold, the comparison matrix, and the synthesis brief — is also duplicated inline in the workflow sections, and the 275-line body could offload more to the bundle.

4 / 5

Total

17

/

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 that clearly states what the skill does and when to use it, with natural trigger phrases and third-person voice. Minor gaps: it omits the quality-assessment capability and lacks synonyms/file-type terms (PDF, whitepaper) that would sharpen trigger matching.

DimensionReasoningScore

Specificity

Names the domain ("academic papers, web articles, reports, and documentation") and three concrete actions ("Extracts key findings, generates comparative analyses, and produces properly formatted citations"). It falls short of anchor 5's comprehensive coverage because the actions are moderately generic and notable capabilities (quality/credibility assessment, multiple citation styles) go unmentioned; it is clearly above anchor 3's '1-2 concrete actions' since three distinct operations plus four source types are listed.

4 / 5

Completeness

Explicitly answers both what ("Extracts key findings, generates comparative analyses, and produces properly formatted citations") and when ("Use when: user wants to summarize a research paper, compare multiple sources, extract citations from documents, or create structured research briefs") with concrete trigger phrases, matching anchor 5 exactly. Not 4, because the 'when' clause is fully explicit rather than improvable.

5 / 5

Trigger Term Quality

Natural trigger phrases users would actually say: "summarize a research paper", "compare multiple sources", "extract citations from documents", "create structured research briefs". Missing common synonyms and formats — no mention of 'PDF', 'whitepaper', or file extensions — so it fits anchor 4 ('good keyword coverage; a few natural terms missing') rather than anchor 5's comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

The research-summarization niche with citation extraction and comparative analysis is mostly distinct, but generic requests like 'summarize this paper' could overlap with general summarization skills or the research/ family the skill body itself has to disambiguate against — fitting anchor 4 ('mostly distinct; minor overlap risk with closely related skills'). Not 5 since the description does not itself carve out those neighboring skills; not 3 since the scope is clearly bounded to user-supplied documents.

4 / 5

Total

17

/

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

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