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.

63

Quality

79%

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 ./.gemini/skills/research-summarizer/SKILL.md

The canonical home for this skill is research-summarizer in alirezarezvani/claude-skills

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 teaches its workflows clearly, with an exemplary verification checklist, but it is diluted by marketing-flavored intro text, duplicated script usage, and an Installation section, and it critically depends on bundle files (two scripts, two reference docs) that are not present in the skill as submitted. Fixing the bundle contents and trimming the meta sections would raise both actionability and conciseness substantially.

Suggestions

Ship the referenced bundle files — scripts/extract_citations.py, scripts/format_summary.py, references/summary-templates.md, and references/citation-formats.md — so the commands in Workflow 1, Workflow 3, and the Verification Loop actually execute.

Trim the intro taglines, the Tooling section's duplicated usage examples, and the Installation/Related Skills sections to reclaim tokens; keep one script usage example and link the rest from the script headers.

Move the full inline scaffold templates (academic brief, comparison matrix, synthesis brief) into references/summary-templates.md and keep only one compact example in SKILL.md.

DimensionReasoningScore

Conciseness

The body is mostly dense and useful, but includes padded taglines ("anyone who reads more than they should have to"), a Tooling section that re-lists script usage already demonstrated in Workflow 1 and Workflow 3, and an Installation section that is packaging meta-content rather than operational guidance. Not 4: these are several instances of trimming opportunity, not minor ones; not 2: the bulk is genuinely instruction, not concept explanation Claude already knows.

3 / 5

Actionability

Commands are concrete with exact flags ("python3 scripts/extract_citations.py document.txt --format ieee --output json") and the scaffold templates give copy-ready structures, but the two scripts the workflows depend on are absent from the submitted bundle, so the central commands cannot actually execute as delivered. Not 4: the gap is a missing key dependency, not a minor one; not 2: the guidance is specific and largely executable in form.

3 / 5

Workflow Clarity

Three workflows are clearly numbered with per-step structure, capped by a dedicated 5-item "Verification Loop" checklist that includes an executable check (script exit 0, total matching bibliography count) and explicit recovery instruction ("investigate any gap"). This matches the anchor for explicit validation steps, feedback loops, and checklists; the non-destructive nature of the task means the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

In-body structure is good and references are clearly signaled at one level deep ("See `references/summary-templates.md`" and "See `references/citation-formats.md`"), but all four referenced bundle files — both scripts and both reference documents — are missing from the actual bundle, leaving every reference path dangling. Not 4: broken reference paths are more than a minor organization gap; not 2: the body itself is well-sectioned and the reference structure is correctly designed.

3 / 5

Total

14

/

20

Passed

Description

88%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, concrete about capabilities, with an explicit "Use when:" trigger clause covering the main request phrasings. Its only weaknesses are missing common trigger synonyms and no in-description boundary statement against related research skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Extracts key findings, generates comparative analyses, and produces properly formatted citations" — across four named source types (papers, articles, reports, documentation), which matches the comprehensive-coverage anchor. Not 4: coverage of the skill's capabilities is complete rather than having minor gaps.

5 / 5

Completeness

Both questions are answered explicitly: the "what" is the three named capabilities plus source types, and the "when" is a literal "Use when:" clause with concrete trigger phrases. This matches the anchor for clear and explicit what AND when.

5 / 5

Trigger Term Quality

"Use when: user wants to summarize a research paper, compare multiple sources, extract citations from documents, or create structured research briefs" gives natural phrases users would actually say. Not 5: common variations such as "literature review", "digest", or standalone "brief" are absent.

4 / 5

Distinctiveness Conflict Risk

The citation-extraction and multi-source-comparison niche with supplied documents is mostly distinct from generic skills, with only minor overlap risk against other summarization tools. Not 5: the description itself never states its boundary (e.g., versus literature-discovery or web-research skills), so a "summarize this" request could route here or elsewhere.

4 / 5

Total

18

/

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

referenced_paths_exist

Referenced path issues: 15 missing

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/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.