CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

paper-interpretation

从论文 PDF 文件或论文 PDF URL 生成通俗易懂、图文并茂、带批判性评估的中文 Markdown 解读,并保存到当前项目的 markdown 目录。Use when the user asks to interpret,精读,解读,summarize,explain,analyze, or write an article from an academic paper PDF, arXiv PDF, conference paper PDF, journal paper PDF, or local/remote PDF URL.

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

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 delivers a clear, well-sequenced workflow with mostly concrete, executable guidance and commendable source discipline (citation, claim-vs-inference separation, limitation reporting). The main gaps are the unreferenced and duplicated references/article-template.md, a hardcoded personal absolute script path that breaks the one runnable command, and check-list redundancy that inflates token cost without adding guidance.

Suggestions

Replace the hardcoded "/Users/diego/.codex/skills/paper-interpretation/scripts/extract_paper_assets.py" in the Extraction Workflow command with the relative path "scripts/extract_paper_assets.py" so the command is copy-paste executable wherever the skill is installed.

Reference the existing template explicitly — e.g. under Article Structure, "Use the template in references/article-template.md" — and move the inlined glossary template, 5W1H table, and Mermaid snippet there, removing the duplication between the two sources.

Merge the overlapping Reading Checklist and Output Checklist into a single pre-publish checklist to cut redundant tokens while keeping the requirements enforceable.

DimensionReasoningScore

Conciseness

The body is mostly efficient: it instructs only the paper-specific conventions Claude cannot guess (5W1H table, glossary template, citation discipline, save location) without explaining known concepts like what a PDF or Mermaid is. It falls short of anchor 5 because of redundancy across "Reading Checklist", "Article Structure", and "Output Checklist", which restate overlapping requirements that could be consolidated.

4 / 5

Actionability

Guidance is largely executable: a concrete bash invocation of extract_paper_assets.py with its output artifacts (paper.pdf, paper_text.md, paper_tables.md, figures/, manifest.json), plus a filled-in 5W1H table, glossary template, and Mermaid example. It is not anchor 5 because the only runnable command is hardcoded to the author's personal absolute path "python3 /Users/diego/.codex/... /scripts/extract_paper_assets.py" — copy-paste ready only on the original machine, whereas the Intake section correctly uses the relative "scripts/extract_paper_assets.py".

4 / 5

Workflow Clarity

The sequence is clear — intake (local path or URL) → extraction with a manifest.json of "extraction status and warnings" as a checkpoint → reading checklist → structured writing → save under markdown/ → "report the absolute output path and any extraction limitations". There is a feedback loop ("If the PDF is scanned or extraction is incomplete, use OCR... before writing"), but it is implied rather than an explicit validate→fix→retry step, keeping it below anchor 5.

4 / 5

Progressive Disclosure

The body is well-sectioned and references the script, but the bundle's references/article-template.md — which mirrors the article structure almost section-for-section — is never mentioned, and roughly 90 lines of templates and structure requirements that duplicate that file are inlined in SKILL.md. This matches anchor 3 ("references present but not clearly signaled; content that should be separate is inline") more than anchor 4, where such duplication would only be a minor organization gap.

3 / 5

Total

15

/

20

Passed

Description

91%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 strong: it explicitly states what the skill produces (illustrated, critically-evaluated Chinese Markdown saved to markdown/), when to use it, and covers trigger terms comprehensively in both English and Chinese across paper-source variants. The only weakness is mild trigger breadth from generic verbs like "summarize" and "analyze", which slightly raises conflict risk with general summarization skills.

DimensionReasoningScore

Specificity

The description names several concrete actions: "生成通俗易懂、图文并茂、带批判性评估的中文 Markdown 解读" and "保存到当前项目的 markdown 目录" — it specifies the output language, format, evaluation style, and save destination. It stays below anchor 5 because it omits several actual capabilities (text/figure extraction, glossary, knowledge map), and rises above anchor 3 because more than 1-2 specific actions are listed with only minor coverage gaps.

4 / 5

Completeness

Both questions are answered explicitly: what — "从论文 PDF 文件或论文 PDF URL 生成...中文 Markdown 解读,并保存到当前项目的 markdown 目录", and when — "Use when the user asks to interpret, 精读, 解读, summarize, explain, analyze, or write an article from an academic paper PDF..." with concrete trigger phrases, mirroring the anchor-5 good_overall example structure. Neither what nor when is vague or merely implied.

5 / 5

Trigger Term Quality

Trigger coverage is comprehensive and includes synonyms in both languages and source variations: "interpret, 精读, 解读, summarize, explain, analyze, or write an article" across "academic paper PDF, arXiv PDF, conference paper PDF, journal paper PDF, or local/remote PDF URL". This matches the anchor-5 example pattern (multiple synonyms plus file/source-type variants); only the literal ".pdf" extension is absent, which the repeated "PDF" terms effectively cover.

5 / 5

Distinctiveness Conflict Risk

The niche is clear (Chinese-language interpretation of academic paper PDFs) with distinct domain triggers like "arXiv PDF, conference paper PDF, journal paper PDF" and the Chinese-only output framing. It stays below anchor 5 because the generic verbs "summarize, explain, analyze" could also fire for non-paper summarization or general-analysis skills, a minor overlap risk with closely related summarization skills.

4 / 5

Total

18

/

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

digoal/blog

Path

skills/paper-interpretation/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.