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

75%

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

Quality

Content

63%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 genuinely actionable, well-sequenced planning workflow grounded in non-obvious venue knowledge. Its weaknesses are redundancy (page-count rules restated in three places), a dense reviewer-routing preamble that dilutes focus, and external references that are well-signaled but unverifiable or inconsistently pathed.

Suggestions

State the MAX_PAGES counting rules (ML vs. IEEE vs. AAAI) once in a single 'Page budget' section and reference it from Steps 2, 6, and Key Rules instead of repeating the full rules three times.

Replace the 9-line reviewer-routing preamble with a short pointer (e.g., 'Reviewer selection: see ../shared-references/reviewer-backends.md') and keep only the paper-specific review prompt in Step 6.

Move the three per-type page-budget templates into a reference file (e.g., references/structures.md) and standardize all shared-reference paths to a single consistent depth so they resolve reliably from the skill directory.

DimensionReasoningScore

Conciseness

The venue-specific knowledge (page limits, IEEE vs. ML citation styles, AAAI CFP caveat) is genuinely non-obvious and earns its tokens, but MAX_PAGES counting rules are stated three times (Constants, Step 6 prompt, Key Rules), IEEE/natbib citation norms twice, and the 9-line reviewer-routing preamble about backends and invocation resolution is dense jargon largely orthogonal to paper planning. This is 'mostly efficient but could be tightened', not the severely padded anchor 1-2 nor the trim anchor 4.

3 / 5

Actionability

The guidance is largely executable: fill-in templates for the Claims-Evidence Matrix, section-by-section plans, figure/citation tables, an exact output format, and a concrete reviewer prompt with a scoring rubric. It stops short of 5 because the `spawn_agent:` block is pseudocode rather than a runnable command and the reviewer-slot resolution instructions are procedural hints rather than concrete commands.

4 / 5

Workflow Clarity

Seven clearly numbered steps with input fallbacks (e.g., "fall back to ./AUTO_REVIEW.md if not found", "If none exist, ask the user"), a genuine feedback loop in Step 6 ("Apply feedback before finalizing"), and validation checks like the REVIEW_UNAVAILABLE verdict handling and "total page budget MUST sum to MAX_PAGES". It misses 5 because some checkpoints are implicit — "section count must match" appears only inside the output template — and the reviewer-routing preamble obscures how to actually execute Step 6.

4 / 5

Progressive Disclosure

Shared material (writing principles, venue checklists, output protocols) is consistently offloaded to external files with clear when-to-read signaling ("Read ... when framing the Abstract", "Load these references only when they help"), and references are one level deep. It does not reach 5 because the referenced `../shared-references/*.md` files do not exist in this bundle, the reference paths use two inconsistent depths (`../shared-references/` vs `../../shared-references/`), and the three full page-budget templates could live in a reference file.

4 / 5

Total

15

/

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.

The description is well-formed with an explicit what-and-when structure and good bilingual trigger coverage. Its main limitation is thin action coverage — it advertises only the single top-level action rather than the several concrete capabilities the skill performs.

DimensionReasoningScore

Specificity

The description names the domain and exactly one concrete action — "Generate a structured paper outline from review conclusions and experiment results" — which matches the anchor for 1-2 concrete actions without comprehensive coverage. It is not a 4 because it does not list several distinct actions (e.g., extracting claims, planning figures, or citation scaffolding are absent).

3 / 5

Completeness

It clearly answers both questions: the 'what' is "Generate a structured paper outline from review conclusions and experiment results" and the 'when' is an explicit "Use when user says..." clause with concrete trigger phrases. This directly matches the anchor-5 example structure and cannot be the 4 anchor since the 'when' is fully explicit rather than improvable.

5 / 5

Trigger Term Quality

It includes natural trigger phrases users would actually say: "paper outline", "plan the paper", "create a paper plan", plus the bilingual "写大纲" and "论文规划". It falls short of a 5 because common variations like "outline the paper", "paper structure", or "draft the outline" are missing.

4 / 5

Distinctiveness Conflict Risk

"Paper outline" and "plan the paper" establish a clear paper-planning niche that is unlikely to grab generic document or writing tasks, but "wants to create a paper plan before writing" could mildly overlap with adjacent paper-writing/outlining skills. It is more distinct than anchor 3's 'somewhat specific but overlapping' and less than anchor 5's minimal-conflict niche.

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.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 4 suspicious

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

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

Path

skills/skills-codex/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.