Agent skill

Tech Paper Template

by HKUSTDial in HKUSTDial/Supervisor-Skills

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…

CC-BY-4.0Auto-check passedAgent Workflows

Install Tech Paper Template

skills CLI
$ npx skills add HKUSTDial/Supervisor-Skills --skill tech-paper-template -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install HKUSTDial/Supervisor-Skills tech-paper-template --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/HKUSTDial/Supervisor-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/tech-paper-template .claude/skills/tech-paper-template && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tech-paper-template
GitHub stars
8.7k
Token cost
~1.7k tokens
SKILL.md length
870 words
Files
5 (incl. references)
Skills in repo
12
Repo updated
First seen
Licence
CC-BY-4.0

At a glance

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…

  • Works in 11 steps: Paper-type positioning → Fill the thinking template → Run four self-consistency checks → …
  • The user is brainstorming a paper
  • SKILL.md covers Overview, When to use this skill, When NOT to use this skill and Core procedure, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Tech Paper Template is an agent skill from HKUSTDial/Supervisor-Skills. 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'.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/consistency-checks.md`, `references/paper-types.md` and `references/thinking-template.md`).

It sits in Agent Workflows, covering Brainstorming. The repository describes itself as: 将博导十年科研经验炼化为可直接调用的 AI 技能。从 Idea 构思到论文投稿,你的 AI 科研副导师。 The licence is CC-BY-4.0.

When your agent uses it

  • The user is brainstorming a paper
  • Discussing progress with an advisor
  • Planning the paper before drafting
  • Paper logic chain

Example prompts

  • “paper skeleton”
  • “paper logic chain”
  • “thinking template”
  • “/tech-paper-template”

Workflow steps

11 steps, taken from the step headings in SKILL.md.

  1. Paper-type positioning
  2. Fill the thinking template
  3. Run four self-consistency checks
  4. Generate methodology outline
  5. Integrity gate
  6. Output
  7. Paper-type positioning
  8. Thinking template
  9. Self-consistency checks
  10. Severity summary
  11. Next suggested skill

What it can do on your machine

Read from SKILL.md and the folder at commit 207bc6f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tech Paper Template loads about 1.7k tokens when it runs, and up to ~7.2k if it reads all its reference files. Until then it costs about 133 tokens; SKILL.md has 870 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~133
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from HKUSTDial/Supervisor-Skills at commit 207bc6f, republished under its CC-BY-4.0 licence (© HKUSTDial). 870 words, ~1,744 tokens.

Download SKILL.mdSave it as .claude/skills/tech-paper-template/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
tech-paper-template
description
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'.
license
CC-BY-4.0

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.

Show full SKILL.md (340 more words)Show less
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.

© HKUSTDial, CC-BY-4.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in skills/tech-paper-template of HKUSTDial/Supervisor-Skills.

  • SKILL.md
  • references/consistency-checks.md
  • references/paper-types.md
  • references/thinking-template.md
  • references/worked-examples.md

Open the folder on GitHubat commit 207bc6f

Compare with similar skills

Tech Paper Template next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tech Paper Template compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tech Paper Template this skillHKUSTDial/Supervisor-Skills8.7k—~1.7kAutomated safety check: PassCC-BY-4.0
Brainstormingxpinjection/test-driven-spring-boot11254 repos~2.6kAutomated safety check: PassMIT
Typesafe AIOpenAgentsInc/openagents4559 repos~2.5kAutomated safety check: PassMIT
Yao Meta Skillyaojingang/yao-meta-skill2.7k—~768Automated safety check: PassMIT
Trellis StartROYIANS/foliq-print-template-designer1356 repos~646Automated safety check: PassMIT
Brainstorming Before BuildingjnMetaCode/superpowers-zh8.3k—~1.8kAutomated safety check: PassMIT

Similar skills

  • Brainstorming

    xpinjection/test-driven-spring-boot

    You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior.

    112 GitHub starsUsed in 54 repos~2.6k tokens
    Agent WorkflowsAuto-check passed
  • Typesafe AI

    OpenAgentsInc/openagents

    Build AI-powered software with TypeSafe: small units of AI intelligence you can use like programming primitives.

    455 GitHub starsUsed in 9 repos~2.5k tokens
    Agent WorkflowsAuto-check passed
  • Yao Meta Skill

    yaojingang/yao-meta-skill

    Create, improve, or evaluate an existing skill from workflows, prompts, SOPs, scripts.

    2.7k GitHub stars~768 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Trellis Start

    ROYIANS/foliq-print-template-designer

    Initializes an AI development session by reading workflow guides, developer identity, git status, active tasks, and project guidelines from .trellis/.

    135 GitHub starsUsed in 6 repos~646 tokens
    Agent WorkflowsAuto-check passed
  • Brainstorming Before Building

    jnMetaCode/superpowers-zh

    Turns a rough idea into an approved design before any code is written, sorting the request into spike, bounded or architectural and enforcing an approval gate.

    8.3k GitHub stars~1.8k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Om Brainstorm

    go-musicfox/go-musicfox

    Divergent conversation before any artifact exists — open questions one at a time, alternatives including building nothing, converging on a routing decision and a handoff brief for the next skill.

    2.6k GitHub starsUsed in 1 repo~1.6k tokens
    Agent WorkflowsAuto-check passed

More from HKUSTDial/Supervisor-Skills

All 12 skills in this repo
  • Benchmark Paper Template

    HKUSTDial/Supervisor-Skills

    Structures benchmark and evaluation papers around five pillars, with a completeness audit, an Introduction logic chain, a section skeleton and a pre-submission checklist.

    8.7k GitHub stars~2.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Draw.io Diagram Reconstruction

    HKUSTDial/Supervisor-Skills

    Rebuilds a reference diagram image as an editable, high-fidelity Draw.io file, mixing native elements, SVG icons and cropped PNGs, with a batch workflow for a folder of images.

    8.7k GitHub stars~5.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Paper Introduction Drafter

    HKUSTDial/Supervisor-Skills

    Drafts the Introduction of a technical paper as six paragraphs of flowing prose, positioning the work and matching contributions to challenges, with an outline on request.

    8.7k GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Rebuttal Guidance

    HKUSTDial/Supervisor-Skills

    Turns pasted peer-review comments into a per-concern rebuttal plan, with reviewer mindset matching and strategy priorities, but not the final rebuttal text.

    8.7k GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Deep Research Literature Survey

    HKUSTDial/Supervisor-Skills

    Runs a survey-grade literature investigation: fixes the research questions, searches from adversarial angles, verifies citations and writes an evidence-first report.

    8.7k GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Paper Figure Designer

    HKUSTDial/Supervisor-Skills

    Advises on designing the three core figures of a technical paper, then audits them against rules for format, fonts, color and captions.

    8.7k GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Tech Paper Template

What does Tech Paper Template 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…. Tech Paper Template is an agent skill from HKUSTDial/Supervisor-Skills. 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.

When should I use Tech Paper Template?

Tech Paper Template fits situations like: the user is brainstorming a paper; discussing progress with an advisor; planning the paper before drafting; paper logic chain.

How do I install Tech Paper Template in Claude Code?

Run `npx skills add HKUSTDial/Supervisor-Skills --skill tech-paper-template -a claude-code`. Or copy the skill folder (skills/tech-paper-template in HKUSTDial/Supervisor-Skills) into .claude/skills/tech-paper-template in your project. Claude Code loads it when a task matches its description.

How do I install Tech Paper Template in Codex?

Run `npx skills add HKUSTDial/Supervisor-Skills --skill tech-paper-template -a codex`. Or copy the skill folder (skills/tech-paper-template in HKUSTDial/Supervisor-Skills) into .agents/skills/tech-paper-template in your project. Codex loads it when a task matches its description.

Can I use Tech Paper Template in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HKUSTDial/Supervisor-Skills --skill tech-paper-template -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tech-paper-template, .gemini/skills/tech-paper-template, .github/skills/tech-paper-template and .opencode/skills/tech-paper-template in your project.

What does Tech Paper Template need to run?

SKILL.md names no scripts, command-line tools or credentials: Tech Paper Template is instructions for the agent only.

Does Tech Paper Template access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Tech Paper Template safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Tech Paper Template use?

Tech Paper Template is published under the CC-BY-4.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tech Paper Template use?

About 1.7k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.5k tokens, read only when the agent opens those files.

What are the alternatives to Tech Paper Template?

Skills that share tags, products or a category with Tech Paper Template: Brainstorming (xpinjection/test-driven-spring-boot, 112 stars), Typesafe AI (OpenAgentsInc/openagents, 455 stars), Yao Meta Skill (yaojingang/yao-meta-skill, 2.7k stars) and Trellis Start (ROYIANS/foliq-print-template-designer, 135 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tech Paper Template?

HKUSTDial (a GitHub organization) maintains it in HKUSTDial/Supervisor-Skills, which has 8,650 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on September 5, 2026.

Source: HKUSTDial/Supervisor-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.