CtrlK
BlogDocsLog inGet started
Tessl Logo

paper-explain-figures

解读论文 Figure 的含义并输出一份“教会人类如何读图”的高可读性 Markdown 报告;支持输入 1 个或多个 figure 文件绝对路径与人工解读,自动尝试从图附近检索生成该图的源代码,并采用类似 parallel-vibe 的方式通过 `codex exec`/`claude -p` 以进程级隔离解读每张图(并发上限默认 3,可在 config.yaml 调整)。⚠️ 不适用:用户只是想改图尺寸/裁剪/改格式;或要求直接修改图片/源代码(本 skill 对图片与源代码全程只读,严禁修改)。

56

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Critical

Do not install without reviewing

Fix and improve this skill with Tessl

tessl review fix ./skills/paper-explain-figures/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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-structured, actionable body that delegates implementation to a bundled script, held back by path repetition and the absence of explicit validation feedback loops for a batch operation.

Suggestions

Add an explicit validation/verification checkpoint in the workflow (e.g. verify each figure produced a report section and that jpg conversion succeeded) with a fix→retry loop.

Define the hidden workspace path once and reference it by name afterward to remove the repeated verbatim path strings.

Document the full set of valid --runner values and their tradeoffs in one place rather than only noting --runner shell is disabled.

DimensionReasoningScore

Conciseness

Mostly efficient and free of basic-concept padding, but the hidden workspace path ".bensz-api/task-{...}/paper-explain-figures/" is repeated verbatim across 目标, 强约束, 输出, 使用方式, and 清理方式, which could be tightened by defining it once.

3 / 5

Actionability

Provides concrete copy-paste commands ("python3 paper-explain-figures/scripts/paper_explain_figures.py --fig ... --note ...") with documented flags (--parallel, --max-parallel, --runner) and a full report template; minor gaps in covering every runner variant.

4 / 5

Workflow Clarity

The sequence is laid out (convert to jpg, retrieve source code, three-source interpretation, report) but this batch/multi-figure operation lacks explicit validate→fix→retry feedback loops, capping workflow_clarity at 3 per the rubric.

3 / 5

Progressive Disclosure

Clear ## sections organize the overview and the bulk of logic is appropriately delegated to scripts/paper_explain_figures.py (a real bundle file referenced one level deep); minor gap is no separate advanced/reference doc, though not strictly required for a code-driven skill.

4 / 5

Total

14

/

20

Passed

Description

71%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 specific, capability-rich description in third-person voice with strong distinctiveness, weakened only by the absence of an explicit positive trigger ("Use when...") clause and slightly incomplete keyword coverage.

Suggestions

Add an explicit positive trigger clause, e.g. "Use when the user wants to understand or interpret figures from a paper."

Include common synonyms and figure file extensions (e.g. 配图, 图表, .png/.pdf/.svg) to broaden trigger-term coverage.

Tighten the long single sentence by splitting capabilities from the inapplicability caveat for easier scanning.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "解读论文 Figure 的含义并输出...Markdown 报告", "自动尝试从图附近检索生成该图的源代码", "通过 codex exec/claude -p 以进程级隔离解读每张图(并发上限默认 3...可调整)" — giving comprehensive coverage of capabilities.

5 / 5

Completeness

The "what" is clearly stated, but there is no explicit positive "Use when..." trigger clause — only negative guidance ("⚠️ 不适用:..."), which per the rubric caps completeness at 3.

3 / 5

Trigger Term Quality

Good natural keyword coverage ("解读论文 Figure", "读图", "figure 文件", codex exec, claude -p) a user would say, but missing common synonyms/extensions like "论文配图", "图表", or figure file extensions.

4 / 5

Distinctiveness Conflict Risk

Clear niche (paper-figure interpretation + source-code retrieval + process isolation + read-only), with explicit boundary guidance; minor overlap risk with general image/vision skills keeps it just below 5.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository
huangwb8/ChineseResearchLaTeX
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.