CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

paper-write-sci

根据 LaTeX 论文项目撰写、修订和润色 SCI 期刊论文,默认 AI 自主模式,也支持人机协作仅输出审查计划;提供作者风格化写作、数字事实核验、逻辑树多轮审查与 PDF/Word 渲染闭环。⚠️ 不适用:仅改格式/样式参数、纯参考文献管理、图片处理、非论文写作任务。

Quality

72%

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 ./skills/paper-write-sci/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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, information-dense process skill with a clear phased workflow, explicit validation checkpoints, and genuinely good on-demand reading guidance for its reference bundle. The main quality issues are duplication (reference list and output-path pattern repeated multiple times), a dead reference to scripts/manuscript_tool.py, and a vague final 校验 step.

Suggestions

Deduplicate the reference-file list: keep the "读取建议" list with its when-to-read guidance and delete the verbatim repeat under 阶段 5, cutting a dozen redundant lines.

Fix or remove the dead build-chain reference to `scripts/manuscript_tool.py` (not present in the bundle), and state the output-path convention once (e.g., in 输出管理) instead of four times.

Make the "校验" section concrete: name the actual static checks or script invocations and their pass criteria, so the final validation step is executable rather than descriptive.

DimensionReasoningScore

Conciseness

The body is dense, prescriptive, and almost entirely project-specific knowledge Claude would not know (hidden output directories, style tables, guards) — no space is wasted explaining known concepts. However, there is real duplication: the full reference-file list appears twice ("优先只读取当前任务所需的参考文件" and again under 阶段 5), the output directory pattern `<paper_dir>/.bensz-api/task-.../` is repeated in four places, and "### 输入" appears twice (once top-level, once under 流程). That fits anchor 3 ('mostly efficient but could be tightened') better than anchor 4.

3 / 5

Actionability

Most guidance is executable: a concrete invocation "python3 scripts/prepare_workspace.py --paper-dir <paper_dir> [--mode ...] [--style ...]", exact output paths and filename patterns, a prioritized build-chain detection list (project script -> scripts/manuscript_tool.py -> Makefile -> latexmk -> xelatex), and named templates for each review type. Minor gaps keep it below anchor 5: manuscript_tool.py and latexmk/xelatex are named without any invocation example, and the "校验" step says only "执行 Skill 已有的静态检查" without naming the checks.

4 / 5

Workflow Clarity

The phased sequence (阶段 0–5) is explicit with per-phase numbered steps, hard checkpoints ("在写入任何新数字前,必须先过数字审查"), a dedicated 终审 phase running section-role/consistency/logic-tree reviews, and a feedback loop ("若有阻塞性问题,修复后再复审"), plus a 失败与恢复 section. It falls short of anchor 5 because a few checkpoints are implicit or vague — the 校验 section never names the actual validation commands, and render-success criteria are unstated.

4 / 5

Progressive Disclosure

Long rules are correctly pushed to one-level-deep bundle files with clear purpose labels and a "读取建议" section telling exactly when to read which file — strong structure. Scored against the actual bundle: all listed reference files exist, but `scripts/manuscript_tool.py` is referenced in the build chain yet absent from the bundle, `config.yaml` is cited as the source of many defaults but is not in the bundle, and the reference list is duplicated verbatim, which muddies navigation. Good but not clean enough for anchor 5.

4 / 5

Total

15

/

20

Passed

Description

66%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, domain-anchored description with good keyword coverage and an unusually helpful explicit non-applicability list. Its main weakness is the absence of an affirmative 'Use when...' trigger clause, which both caps completeness and slightly weakens distinctiveness.

Suggestions

Add an affirmative trigger clause, e.g. "适用于:需要撰写/修订/润色 SCI 期刊论文(LaTeX 项目)、重写 Discussion、全文逻辑或数字一致性审查时" — this would lift completeness from 3 and sharpen distinctiveness.

Include a few more natural synonyms users would say, such as "manuscript"、"投稿准备"、"论文润色/改稿", to broaden trigger-term coverage.

Spell out what the two modes do in one short clause (e.g., "autonomous 直接改稿并渲染;collaborative 只输出审查计划") so the mode distinction is concrete rather than condensed.

DimensionReasoningScore

Specificity

The description lists several concrete capabilities — "撰写、修订和润色 SCI 期刊论文", "作者风格化写作", "数字事实核验", "逻辑树多轮审查与 PDF/Word 渲染闭环" — covering the full pipeline with only minor gaps (e.g., the two modes are named but their behavior is condensed). It falls just below anchor 5 because phrasings like "逻辑树多轮审查" and "渲染闭环" are semi-abstract labels rather than fully concrete actions, but it is clearly above anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

The 'what' is explicit and multi-part, but the only 'when' guidance is the negative boundary list "⚠️ 不适用:仅改格式/样式参数、纯参考文献管理、图片处理、非论文写作任务"; there is no affirmative 'Use when...' or equivalent trigger clause. Per the judging guideline, a missing 'Use when...' clause caps completeness at 3 ('when' missing or only weakly implied), and the exclusion list alone is not enough to reach anchor 4.

3 / 5

Trigger Term Quality

Natural terms a user would say are present: "LaTeX", "SCI 期刊论文", "撰写", "修订", "润色", plus mode words like "人机协作". A few common variations are missing (e.g., "manuscript", "投稿", "论文投稿", "Discussion/Results" section names), so it fits anchor 4 ('good keyword coverage; a few natural terms missing') rather than anchor 5's comprehensive synonym coverage, and is well above anchor 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

The "SCI 期刊论文" + "LaTeX 论文项目" framing carves a clear niche, and the ⚠️ 不适用 list explicitly separates it from format-tweaking, reference management, and image-processing skills. Minor overlap risk remains with generic academic-writing/editing skills since no affirmative trigger distinguishes them, so anchor 4 ('mostly distinct; minor overlap risk') fits better than anchor 5.

4 / 5

Total

15

/

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.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

referenced_paths_exist

Referenced path issues: 1 missing, 17 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

huangwb8/ChineseResearchLaTeX

Path

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