CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

paper-plan

Generate a structured paper outline from review conclusions and experiment results. Use when user says "写大纲", "paper outline", "plan the paper", "论文规划", or wants to create a paper plan before writing.

Quality

76%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/paper-plan/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 dense, highly actionable skill with a well-sequenced workflow, concrete templates, and explicit error handling. Its weaknesses are duplication of venue/page-budget rules, an opaque reviewer-routing preamble, and — most seriously — total dependence on shared-reference and helper files that are not present in the bundle, leaving all of its progressive-disclosure links broken.

Suggestions

Ship the referenced files (shared-references/*.md and tools/extract_paper_style.py) in the bundle, or inline the essential content — every cross-reference from SKILL.md is currently a broken path.

Deduplicate the venue and MAX_PAGES rules: 'Constants' and 'Key Rules' both state the IEEE references-counted rule and venue citation norms; state each rule once and cross-reference it.

Rewrite the 'Before each reviewer slot' preamble as a short numbered procedure or move it into the (currently missing) reviewer-backends.md file it points to; its current compressed phrasing ('resolve invocation → .aris/reviewer.json → Claude Code default') forces re-reading.

DimensionReasoningScore

Conciseness

Mostly efficient procedural content (templates, tables, page budgets), but it could be tightened: the venue/page-count rules are duplicated between 'Constants' and 'Key Rules' ('For IEEE venues: references ARE included in page count' appears in both), and the reviewer-routing preamble ('Before each reviewer slot, follow Selectable Reviewers...') is dense and partially redundant with Step 6's resolution note. Not the anchor-4 case, since these are more than trivial trims; not anchor 2, since there is no concept-explaining filler.

3 / 5

Actionability

Fully executable guidance throughout: a copy-paste-ready bash block for the style-ref helper with explicit exit-code handling (case 0/2/3/*), a concrete MCP invocation with model and config ('model: gpt-6-astra, config: {"model_reasoning_effort": "xhigh"}'), and concrete output templates (Claims-Evidence Matrix table, section-by-section plan, Figure Plan table, GAP_REPORT.md skeleton, PAPER_PLAN.md skeleton). Not score 4: the common cases (with/without style-ref, with/without CLAIMS_FROM_RESULTS.md) are each covered with specific instructions.

5 / 5

Workflow Clarity

A clear 7-step sequence (extract claims → structure → section planning → figure plan → citations → cross-review → output) with a feedback loop ('Apply feedback before finalizing') and error handling in the style-ref block. Minor validation gaps keep it below 5: there is no explicit final check that the section page budgets sum to MAX_PAGES after reviewer feedback is applied, and Step 6's reviewer resolution depends on external machinery ('.aris/reviewer.json', 'reviewer_route.py') that is referenced but not defined here. Above anchor 3 because validation checkpoints (helper exit codes, verdict: REVIEW_UNAVAILABLE handling, [VERIFY] citation flags) are explicit.

4 / 5

Progressive Disclosure

The skill practices disclosure discipline in text ('Only load these references when needed; do not paste their full contents into the working draft'), but every referenced file is missing from the bundle: '../shared-references/writing-principles.md', 'venue-checklists.md', 'reviewer-backends.md', 'reviewer-independence.md', 'output-versioning.md', 'output-manifest.md', 'output-language.md', 'integration-contract.md', and 'tools/extract_paper_style.py' — the bundle contains only SKILL.md. Anchor 2 fits ('references are buried' / broken): a consumer of this bundle cannot navigate to any of the core detail the workflow depends on.

2 / 5

Total

14

/

20

Passed

Description

78%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: it clearly states what the skill does and gives explicit, natural, bilingual trigger phrases for when to use it. The only real gap is specificity — it names the single top-level action without listing the concrete artifacts the skill produces.

Suggestions

Enumerate the concrete outputs to raise specificity, e.g., 'Generate a structured paper outline — claims-evidence matrix, section-by-section plan, figure plan, and citation plan — from review conclusions and experiment results.'

DimensionReasoningScore

Specificity

The 'what' is concrete but singular: 'Generate a structured paper outline from review conclusions and experiment results' names the domain and one action with its inputs, but does not enumerate the concrete outputs the skill actually produces (claims-evidence matrix, figure plan, citation plan, gap report). Fits anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive'); not 4, which requires several specific actions listed.

3 / 5

Completeness

Explicitly answers both questions with concrete trigger phrases: what — 'Generate a structured paper outline from review conclusions and experiment results'; when — 'Use when user says "写大纲", "paper outline", "plan the paper", "论文规划", or wants to create a paper plan before writing.' This is a direct match for anchor 5; anchor 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Good natural trigger coverage including bilingual synonyms: '"写大纲"', '"paper outline"', '"plan the paper"', '"论文规划"', and 'wants to create a paper plan before writing'. A few natural English variations ('outline the paper', 'draft an outline', 'paper structure') are missing, which matches anchor 4 ('good keyword coverage; a few natural terms missing') rather than 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Clear niche (paper outlining from research artifacts) with distinct triggers ('paper outline', '写大纲', 'plan the paper') unlikely to fire for wrong skills. Minor overlap risk with sibling writing skills in the same pack (e.g., paper-write/paper-figure, where 'paper' alone could be ambiguous), matching anchor 4 rather than 5's 'minimal conflict risk'.

4 / 5

Total

16

/

20

Passed

Validation

75%

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

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 4 suspicious

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

12

/

16

Passed

Repository

wanshuiyin/Auto-claude-code-research-in-sleep

Path

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