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

80%

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

Quality

Content

73%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: concrete templates for every artifact, an explicit reviewer feedback loop with bounded polling, and fallbacks for missing inputs. The main costs are token efficiency — key rules are repeated up to three times across Constants, Step 2, and Key Rules — and reliance on external ../../shared-references/ files that are not part of the bundle.

Suggestions

State each page-budget and section-count rule once (in Constants) and drop the repetitions in Step 2 and Key Rules to reclaim tokens without losing clarity.

Either vendor the three shared output-protocol files into the skill's references/ directory or inline one-line summaries, since ../../shared-references/ links fall outside the bundle and cannot be relied on.

Consider moving the three venue-specific section templates and the citation rules into a references/ file, keeping SKILL.md as a decision guide for which template applies.

DimensionReasoningScore

Conciseness

The body is mostly efficient templates rather than concept explanation, but key rules are stated redundantly: MAX_PAGES scope is defined in Constants, restated in Step 2 ('The total page budget MUST sum to MAX_PAGES'), and repeated twice in Key Rules ('Page budget is hard' and 'MAX_PAGES counts main body only'); section-count flexibility also appears in both Step 2 and Key Rules. This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened'; a 4 would need only minor trims.

3 / 5

Actionability

Every step ships a concrete, fill-in markdown template (Claims-Evidence Matrix, section-by-section plan, Figure Plan, Citation Plan, output document), plus an explicit MCP call for review with polling instructions — mostly executable guidance. Minor gaps: the review prompt is a template with placeholders rather than a fully worked example, and citation verification delegates to unspecified search tooling, keeping it just below 'copy-paste ready' 5.

4 / 5

Workflow Clarity

A clear 7-step sequence with defined inputs and fallbacks (AUTO_REVIEW.md → ./AUTO_REVIEW.md, ask the user if nothing exists), an explicit validation/feedback loop (send outline to reviewer, poll with bounded waitSeconds until done=true, apply feedback before finalizing), and hard checkpoints (page budget must sum to MAX_PAGES, citations must be verified or flagged [VERIFY]). This matches the top anchor: clear sequence, explicit validation, feedback loops, and checklists.

5 / 5

Progressive Disclosure

Good structure: the body is organized into scannable step sections with templates inline where they're needed at use time, and output protocols are delegated via clearly signaled one-level links ('[Output Versioning Protocol](../../shared-references/output-versioning.md)'). Minor organization gaps: those shared-references paths live outside the skill bundle and cannot be verified to exist, and the three full venue templates plus citation rules could arguably live in a references file. Not a 3, because references are clearly signaled and most content is appropriately placed.

4 / 5

Total

16

/

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 well-formed description: third-person voice, explicit 'Use when' trigger clause with natural bilingual phrases, and a clear statement of what the skill produces. The main weakness is that only the top-level action is described, leaving the skill's concrete capabilities under-enumerated.

Suggestions

Enumerate 2-3 concrete sub-actions in the description, e.g., 'Build a claims-evidence matrix, plan sections and page budgets for ICLR/NeurIPS/ICML venues, and scaffold figures and citations.'

Add common trigger variations such as 'outline the paper', 'draft an outline', or '论文大纲' to broaden natural keyword coverage.

DimensionReasoningScore

Specificity

The description names the domain and one concrete action — "Generate a structured paper outline from review conclusions and experiment results" — but stops at the top-level action without mentioning sub-capabilities (figure planning, citation scaffolding, venue budgeting). This matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'; a 4 would require several specific listed actions.

3 / 5

Completeness

It explicitly answers both questions: what it does ("Generate a structured paper outline from review conclusions and experiment results") and when to use it ("Use when user says … or wants to create a paper plan before writing") with concrete trigger phrases. This directly matches the anchor 'Clearly and explicitly answers both what AND when with concrete trigger phrases'.

5 / 5

Trigger Term Quality

Triggers include natural phrases users would say — "paper outline", "plan the paper", "论文规划", "写大纲" — with good bilingual synonym coverage. A few natural variations are missing (e.g., "outline the paper", "draft the outline", "论文大纲"), so it falls just below the comprehensive-synonyms anchor of 5.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — planning a paper outline from review/experiment artifacts — with distinct triggers unlikely to fire for other skills. Minor overlap risk remains with adjacent paper-writing skills (e.g., paper-write/figure) in the same pipeline, which keeps it below the minimal-conflict anchor of 5.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 3 suspicious

Warning

Total

15

/

16

Passed

Repository

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

Path

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