CtrlK
BlogDocsLog inGet started
Tessl Logo

ljg-paper

Explain research papers to readers without a specialist background: what the paper studies, what the authors contribute, how the findings follow, and what the evidence does not establish. USE WHEN the user shares an arXiv link, paper URL, PDF, local paper, or paper title, or asks to read, explain, analyze, or understand a paper. Defaults to a saved Org note. NOT FOR reproduction, formal peer review, benchmark tables, or literature surveys.

71

Quality

89%

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

77%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 is a well-structured, efficient instruction document with an unusually strong validation and re-validation workflow. Its main defect is external: the bundle ships without the `ReadingGuide.md` file that the routing table and 保存与检查 sections depend on, which degrades both the executability of the primary workflow and reference navigation.

Suggestions

Ship or fix the `ReadingGuide.md` reference: it is listed as 必读材料 in every workflow route and as the source of 具体写法, but no such file exists in the bundle. Either add the file or inline/redirect its content to an existing reference.

Deduplicate guidance across 三个目标, 容易出错的地方, and references/template.org (e.g., reader-background rules and 换例子 guidance appear in multiple places) to improve conciseness without losing information.

Promote the validation and independent-reading-check sequence (currently prose in 保存与检查) into an explicit numbered step list so the validate → check → re-validate feedback loop is scannable at a glance.

DimensionReasoningScore

Conciseness

The body is dense, skill-specific guidance — audience model, three goals, failure modes, routing table, validation loop — with essentially no explanation of concepts Claude already knows (no 'what is a PDF' padding). Not 5 because the three goals, the nine-item 容易出错的地方 list, and the 示例 section overlap noticeably with each other and with references/template.org, so a pass could trim repetition without losing information.

4 / 5

Actionability

Concrete executable detail: an input-routing table, the exact Denote filename pattern with `date +%Y%m%dT%H%M%S`, and a copy-paste-ready `bun {skill_dir}/scripts/validate_note.ts ... --map ...` command. Not 5 (and nearly 3) because the body repeatedly defers its core writing instructions to `ReadingGuide.md` ("具体写法见 `ReadingGuide.md`") — a file that does not exist in the bundle, so the primary instruction path cannot actually be executed.

4 / 5

Workflow Clarity

The workflow is explicitly sequenced with validation checkpoints and a feedback loop: route input → read required files → write from template → run the validation script → real-Emacs checks (identifier, org-lint, consult-notes) → independent reading check with four recorded outcomes → re-run the script to confirm final consistency. Failure handling is explicit ("验证器或独立评估不可用时,明确报告哪项尚未完成"; script accepts incomplete records for diagnosis but returns failure).

5 / 5

Progressive Disclosure

Structure and signal are good — one-level-deep references, a routing table mapping inputs to required files — and `references/template.org`, `references/paper-map.md`, and `scripts/validate_note.ts` all exist. But `ReadingGuide.md`, cited as 必读材料 in every workflow route and as the location of the concrete writing method, is absent from the bundle (no `ReadingGuide.md` anywhere in the skill directory), breaking navigation to the most-referenced file. This is more than a minor organization gap, so it sits between the 'good structure' (4) and 'buried references' (2) anchors.

3 / 5

Total

16

/

20

Passed

Description

95%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: concrete capabilities, an explicit USE WHEN clause with natural trigger terms, a stated output default, and clear NOT FOR boundaries. The only weakness is that the capability list, while specific, decomposes one core action and omits secondary outputs.

DimensionReasoningScore

Specificity

Quotes like "what the paper studies, what the authors contribute, how the findings follow, and what the evidence does not establish" plus "Defaults to a saved Org note" list several concrete, distinct capabilities with a concrete output default. Not 5 because the four explanation facets all unpack a single core action, and secondary outputs (e.g., the paper-map research record) are not mentioned — minor gaps in coverage.

4 / 5

Completeness

The first sentence explicitly answers 'what' (explain papers to non-specialists across four concrete dimensions) and "USE WHEN..." explicitly answers 'when' with concrete trigger phrases; it even adds scope boundaries ("NOT FOR reproduction, formal peer review, benchmark tables, or literature surveys"). Both what and when are explicit and concrete.

5 / 5

Trigger Term Quality

"USE WHEN the user shares an arXiv link, paper URL, PDF, local paper, or paper title, or asks to read, explain, analyze, or understand a paper" covers natural user phrasing comprehensively, including synonyms (read/explain/analyze/understand) and concrete input forms (arXiv link, URL, PDF, local file, title). Nothing common is missing, matching the top anchor.

5 / 5

Distinctiveness Conflict Risk

A clear niche (explaining research papers to non-specialist readers) with distinct triggers (arXiv, paper URL, paper title) and an explicit exclusion list that fences off adjacent skills (reproduction, formal peer review, literature surveys) — minimal conflict risk.

5 / 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
lijigang/ljg-skills
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.