MCPInstall

tech-paper-template

Structures a technical paper's full logical skeleton using a thinking-template table (research background, limitations, key idea or goal, challenges, methodology modules, contributions), positions the paper as Technique or New Problem/Setting, and runs a four-point self-consistency check. Use when the user is brainstorming a paper, discussing progress with an advisor, or planning the paper before drafting. Also use for 'paper skeleton', 'paper logic chain', 'thinking template', 'paper-structure planning'.

Installs
708
Last 24h
+8
Trending rank
#9716
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/hkustdial/supervisor-skills --skill tech-paper-template
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads tech-paper-template automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Tech Paper Template

Overview

Before drafting any prose, a technical paper needs a full logical skeleton: the research background, the specific limitations of prior work, the key idea or research goal, the technical challenges that prevent a naive solution, the methodology modules that address each challenge, and the contributions that the paper will claim. This skill fills in that skeleton via a standardised thinking-template table, positions the paper type, and runs four self-consistency checks on the logic chain.

The output is a filled-in thinking template plus a consistency report. It is suitable for advisor-student brainstorming sessions, weekly progress meetings, and the final planning step before writing begins. It does not draft Introduction prose (use intro-drafter for that); it operates at the logical-skeleton layer.

When to use this skill

  • Early brainstorming of a paper project.
  • Weekly progress meeting with an advisor or collaborator.
  • Pre-drafting planning after idea-evaluator returns Strong Accept.
  • The paper's logic chain feels incoherent and needs an audit.
  • The user asks for 'paper skeleton', 'paper logic chain', 'thinking template', or 'paper-structure planning'.
  • The user is unsure whether their paper is Technique or New Problem/Setting.

When NOT to use this skill

  • The paper is a benchmark paper. Use benchmark-paper-template (separate plugin).
  • The user needs an Introduction-specific paragraph outline. Use intro-drafter (typically run this skill first, then intro-drafter).
  • The user has a written draft and wants review feedback. Use pre-submission-reviewer.
  • The idea itself is not yet vetted. Use idea-evaluator first.

Core procedure

Step 1: Paper-type positioning

See: references/paper-types.md for the positioning criteria and worked examples.

Decide Technique versus New Problem/Setting. In Technique, the Key Idea carries the narrative and Our Goal is a short bridge. In New Problem/Setting, Our Goal is the contribution and the Key Idea justifies feasibility.

If the user's inputs describe a benchmark, stop and redirect to benchmark-paper-template (separate plugin).

Step 2: Fill the thinking template

See: references/thinking-template.md for each template cell's content contract, what a strong cell looks like, and common failure modes.

Fill the seven cells:

  1. Research background. Scenario, importance, motivation.
  2. Limitations 1 through 3 (2 is acceptable; more than 3 is not).
  3. Key idea or Our Goal. One sentence.
  4. Challenges 1 through 3 (similar cap).
  5. Methodology modules. One module per challenge.
  6. Contributions (3 or 4, each mapped to a section).

If a cell is incomplete given the user's inputs, mark it as a gap with severity.

Step 3: Run four self-consistency checks

See: references/consistency-checks.md for the detailed checking procedure and examples of chain breaks.

Run each check:

  1. Limitations to Key Idea: does the Key Idea or Goal address the stated Limitations? If not, either the Limitations are wrong or the Key Idea is misaligned.
  2. Key Idea to Challenges: do the Challenges arise naturally from implementing the Key Idea? If not, the challenges are invented to justify modules rather than derived from the idea.
  3. Challenges to Methodology: does each methodology module address one challenge? If not, there is a module without justification or a challenge without a fix.
  4. Methodology to Contributions: do the contributions cover each module or experimental result? If not, contributions are vague or promising more than the paper delivers.

Every failure is CRITICAL.

Step 4: Generate methodology outline

See: references/thinking-template.md for the methodology-outline template.

From the challenges, derive a methodology outline: topic sentence, per-module subsection names, and per-module one-sentence summary. This becomes the skeleton for Section 3 or 4 of the paper.

Step 5: Integrity gate

Before emitting, run the checks in the Integrity gate section below.

Step 6: Output

Emit the filled template plus the consistency report in the Output format below.

Integrity gate

All seven bullets are [inspection] class: the LLM verifies each directly from the filled template (counting, pattern-matching, or comparing cells). No user-side attestation required.

Before returning the filled template:

  1. [inspection] Paper-type positioning is consistent with the user's actual contribution (Technique paper not shoehorned into New Problem framing, or vice versa).
  2. [inspection] Limitations are specific and cited-able, not vague.
  3. [inspection] Key Idea or Goal is a single sentence a reviewer could quote.
  4. [inspection] Challenges derive from implementing the Key Idea; they are not invented.
  5. [inspection] Methodology modules have one-to-one mapping with challenges.
  6. [inspection] Contributions map to methodology modules and to specific sections.
  7. [inspection] All four self-consistency checks pass.

If any check fails, mark the skeleton as "needs user attention".

Output format

1. Paper-type positioning

  • Type: <Technique Paper or New Problem/Setting Paper>
  • Rationale: <one sentence>

2. Thinking template

StageYour content
Research background...
Limitation 1...
Limitation 2...
Limitation 3 (if applicable)...
Key Idea / Our Goal...
Challenge 1...
Challenge 2...
Challenge 3 (if applicable)...
Methodology topic sentence...
Module A (addresses Challenge 1)...
Module B (addresses Challenge 2)...
Module C (addresses Challenge 3)...
Contribution 1... (Section <X>)
Contribution 2... (Section <Y>)
Contribution 3... (Section <Z>)

3. Self-consistency checks

  • Check 1 Limitations -> Key Idea: <pass or fail>
  • Check 2 Key Idea -> Challenges: <pass or fail>
  • Check 3 Challenges -> Methodology: <pass or fail>
  • Check 4 Methodology -> Contributions: <pass or fail>

4. Severity summary

  • <n> CRITICAL, <m> MAJOR, <k> MINOR.
  • Top three fixes first: ...

5. Next suggested skill

  • If all checks pass: intro-drafter to produce the Introduction paragraph outline.
  • If checks fail: address the flagged chain breaks first.

FAQ

What does the tech-paper-template skill do?

Structures a technical paper's full logical skeleton using a thinking-template table (research background, limitations, key idea or goal, challenges, methodology modules, contributions), positions the paper as Technique or New Problem/Setting, and runs a four-point self-consistency check. Use when the user is brainstorming a paper, discussing progress with an advisor, or planning the paper before drafting. Also use for 'paper skeleton', 'paper logic chain', 'thinking template', 'paper-structure planning'.

How do I install tech-paper-template?

Run npx skills add https://github.com/hkustdial/supervisor-skills --skill tech-paper-template in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/tech-paper-template/ (personal) or .claude/skills/tech-paper-template/ (project).

Which AI agents can use tech-paper-template?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is tech-paper-template safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains tech-paper-template?

It is published by hkustdial in hkustdial/supervisor-skills. It has 708 recorded installs.

More from hkustdial/supervisor-skills

View all →

figure-designer

hkustdial/supervisor-skills

Advises on the design of the three core figures in a technical paper: the Motivated Example (Figure 1), the Solution Overview (Methodology), and the Experimental Results figures. Recommends the right design paradigm, layout, labelling, and tool for each figure type, then runs a quality-control audit. Use when the user asks to 'design a figure', 'draw Figure 1', 'plot experiment results', 'choose the right chart type', 'which figure tool to use', or 'figure looks unprofessional'.

Frontend & Design747 installs

idea-evaluator

hkustdial/supervisor-skills

Evaluates a preliminary research idea against a five-dimension framework (Higher, Faster, Stronger, Cheaper, Broader) plus idea-lifecycle and student-capability matching, paradigm-shift probing, and a fatal-flaws audit. Returns a reviewer-style verdict; non-STEM ideas route to substitute frameworks. Use when the user has a draft research idea and asks whether it is worth pursuing, asks to 'evaluate this idea', 'score this idea', 'assess feasibility', 'novelty check', 'is this a good research direction', or before committing to a paper scope.

pre-submission-reviewer

hkustdial/supervisor-skills

Runs a pre-submission review of a technical paper across five dimensions: macro logic, writing details, English grammar, LaTeX formatting, and figure quality. Uses a reviewer-style severity taxonomy (CRITICAL / MAJOR / MINOR) and flags banned AI-tone vocabulary and em-dash misuse. Use when the user asks to 'review this paper', 'audit before submission', 'check the draft', 'find issues', 'proofread', or within one week of a submission deadline.

intro-drafter

hkustdial/supervisor-skills

Drafts the Introduction prose for a technical paper, guided internally by a six-paragraph flowchart: background and running example, existing limitations, problem essence and goal, key challenges, solution overview, contributions. Positions the paper as Technique or New Problem/Setting, aligns contributions with challenges, and weaves verified citations. Outputs flowing prose by default, or an outline on request. Use when the user asks to draft, outline, or restructure an Introduction.

vibe-research-workflow

hkustdial/supervisor-skills

Guides AI-assisted research across three sub-flows, Vibe Coding, Vibe Figure, and Vibe Writing, with behavioural rules that keep the user in charge of academic judgment while delegating mechanical work to AI. Recommends the right tool (Cursor, Claude Code, Codex, Figma, Gemini) for the current stage. Use when the user asks 'how to use AI for research', 'Vibe Coding tips', 'AI-assisted writing workflow', 'which AI tool for this', or starts an AI-assisted work session.

benchmark-paper-template

hkustdial/supervisor-skills

Structures Benchmark and Evaluation papers using the five-pillar framework (Research Gap, Construction Pipeline, Evaluation Framework, Empirical Findings, optional Companion Method). Returns a completeness audit, a six-part Introduction logic chain, a Section 2-7 skeleton, and a pre-submission checklist. Use when writing a benchmark paper, structuring a benchmark paper, checking whether a benchmark idea is substantive, drafting a benchmark Introduction, or planning the data-construction pipeline or experiments.

Popular education & science skills

View category →

teach

mattpocock/skills

Teach the user a new skill or concept, within this workspace.

Education & Science874K installs

scaffold-exercises

mattpocock/skills

Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.

Education & Science488.2K installs

paper-context-resolver

lllllllama/rigorpilot-skills

Rigor Paper Context helper for README-first deep learning repo reproduction. Use only when the README and repository files leave a narrow reproduction-critical gap and the task is to resolve a specific paper detail such as dataset split, preprocessing, evaluation protocol, checkpoint mapping, or runtime assumption from primary paper sources while recording conflicts. Do not use for general paper summary, repo scanning, environment setup, command execution, title-only paper lookup, or replacing README guidance by default.

Education & Science478.3K installs

caveman-learn

juliusbrussee/caveman

Act on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and report what those fixes returned. Use when asked to lower an agent's token cost, what caveman has saved, to trim a heavy CLAUDE.md, or to offload re-pasted context into cavemem.

Education & Science107.9K installs

gsap-plugins

greensock/gsap-skills

Official GSAP skill for GSAP plugins — registration, ScrollToPlugin, ScrollSmoother, Flip, Draggable, Inertia, Observer, SplitText, ScrambleText, SVG and physics plugins, CustomEase, EasePack, CustomWiggle, CustomBounce, GSDevTools. Use when the user asks about a GSAP plugin, scroll-to, flip animations, draggable, SVG drawing, or plugin registration.

Education & Science67.9K installs

teach-impeccable

pbakaus/impeccable

DEPRECATED: Use /impeccable teach instead. This command has been folded into the impeccable skill.