
intro-drafter
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.
- Installs
- 723
- Last 24h
- +8
- Trending rank
- #9729
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/hkustdial/supervisor-skills --skill intro-drafter- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads intro-drafter automatically when relevant.
- 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.
Introduction Drafter
Overview
The Introduction is the compressed version of the entire paper. In one and a half to two pages it must state the research object, why the problem matters, why existing work falls short, what the paper contributes, and how the contributions map to sections. Reviewers decide whether to keep reading by the end of the Introduction, so the logical throughline has to be airtight.
This skill is a prose generator, not an outline generator. It takes a small set of inputs (research area, limitations, key idea, challenges, solution overview, optional references) and produces six paragraphs of real Introduction prose. The six-paragraph flowchart works underneath as an internal scaffold and never appears in the output.
The delivered text must read as if a researcher wrote it: flowing paragraphs, no inline tags, no "Paragraph 1: Background" headings, no severity tables, no consistency reports. Just the Introduction.
An explicit outline is still available: see "Outline mode" below.
Evidence rules (inherited)
This skill follows the shared evidence discipline: every factual claim traces to the user's materials, this session's verified retrieval, or field common knowledge; model memory is never a source; delivered prose carries zero bracketed placeholder tags; details the user did not provide (specific scenarios, mechanisms, magnitudes, procedures, identifiers) are omitted, not invented.
See: references/evidence-discipline.md and references/prose-delivery.md
(shared with paper-writer).
When to use this skill
- "Write the Introduction." "Draft the Intro from this idea."
- The user has a paragraph of research thinking and wants finished prose, not bullets.
- The user has Goal and Key Idea settled but no Introduction text yet.
- The user pastes references and asks for them woven into the Introduction.
When NOT to use this skill
- Benchmark papers:
benchmark-paper-template(the flowchart differs). - Any non-Introduction section:
paper-writer. - Prose exists and needs polishing:
paper-polish. - The user wants a submission-readiness verdict:
pre-submission-reviewer.
Pre-check: STEM or not
The six-paragraph model (background, limitations, goal, challenges,
solution, contributions) is built for STEM and technical papers. If the
research is non-STEM by method (humanities, social science, economics,
law), do not force it through this scaffold; hand the task to paper-writer,
whose CER planning covers those paradigms, while all evidence rules still
apply. The test is the research method: experiments, benchmarks, models, or
algorithms come here; everything else routes to paper-writer.
Core procedure (STEM)
Internal thinking first, prose second. None of the intermediate thinking is printed.
Step 1: paper-type positioning (internal)
See: references/paper-types.md for the Technique versus New Problem/Setting distinction and worked examples from Alpha-SQL, AFlow, and LEAD.
- Technique paper: the contribution is a new method for an existing problem; the narrative axis is the key idea; Paragraph 3 is a short bridge.
- New Problem/Setting paper: the contribution is the problem formulation itself; Paragraph 3 is load-bearing.
Step 2: plan the six paragraphs (internal)
See: references/flowchart.md for each paragraph's purpose, writing points, and common failures.
For each paragraph, settle: its purpose; two to four concrete writing points drawn from the user's inputs; and its gaps (what the inputs do not yet cover). Gaps are reported to the user after the prose, never inside it.
- Background and motivation; running example; why the problem matters.
- Limitations of existing work (at most three).
- Problem essence and goal; hard constraints explicit.
- Key challenges (at most three).
- Solution overview; one module per challenge.
- Contributions (three or four, each mapping to a section).
Step 3: the running example (internal)
See: references/running-example.md for the design principles and patterns.
If the user has not provided a running example, do not fabricate one. The reference file's first principle is that the example is real, drawn from real data or a real deployment. Write the background paragraph from the user's own abstract problem description, and in the closing note ask: "a concrete running example would make Paragraph 1 stronger; can you share a real case from your experiments or deployment?"
Step 4: alignment checks (internal, before writing)
See: references/contribution-patterns.md for strong versus weak contribution patterns.
Verify silently: the running example from Paragraph 1 reappears in Paragraph 5 or 6; every challenge answers a limitation or a hard constraint; the goal aligns with contribution 1; challenges map one-to-one to modules; contributions number three or four, each tied to a section, none of them vague ("extensive experiments" is not a contribution).
A failed check is fixed in the plan before any prose is written. Never write around a broken chain.
Step 5: write the prose
Six flowing paragraphs, under these disciplines:
- No paragraph labels in the output. Natural transitions carry the structure ("Despite this progress, ...", "In this work, we ...", "We summarise our contributions as follows.").
- Each paragraph is one block, roughly 100-250 words, weighted by the paper type (see references/paper-types.md).
- Citations: numeric citation-sequence,
[1],[2], ... by first appearance. A full six-paragraph Introduction typically weaves 15-25 references: 3-5 in the background, 5-8 in the limitations, 2-4 in each of paragraphs three to five, 0-2 in the contributions. A thin bibliography reads as an opinion piece. Search before writing: three to five retrieval rounds under different keywords build the pool, and the argument is organized around retrieved, verified works. A claim whose source cannot be found is rewritten to drop the need, never tagged. The prose is followed by a References list matching the marks bidirectionally. At three or more citations, run the independent citation-verification ladder defined inpaper-writer(a fresh-context check of every entry when the environment allows it, with honest degradation and disclosure otherwise). - Numbers and claims: no invented percentages, speedups, or benchmark numbers. A specific gain appears only if the user reported it; otherwise "improves over prior baselines", with no annotation attached.
- Tense: past for prior work and observations; present or future for the paper's own unvalidated claims ("this paper proposes"). Without reported results, never "we achieved" or "we demonstrated".
- Tone pass: before finalising, strip AI-tone signals and unsupported superlatives, and match verbs to evidence strength (see the "Tone references" section below for where the shared wordlists live).
Step 6: a short closing note (optional, three lines at most)
After the prose (and References), at most a short plain-language note: gaps the user should fill, a paragraph written tentatively for lack of input, or the running-example request from Step 3. No tables, no lists, no severity labels. Nothing useful to say means no note at all.
What the user receives
- Six paragraphs of Introduction prose separated by blank lines, citations
as
[1],[2], ... - A References list right after the prose, when citations are present.
- Optionally, one one-to-three-line plain note.
Nothing else. The full prohibition list (headings, gate results, severity summaries, placeholder tags, process preambles) lives in references/prose-delivery.md and is binding.
Outline mode (on explicit request)
When the user explicitly asks for an outline instead of prose ("just the outline", "give me the skeleton first"), return the classic structure instead: the type positioning (type, rationale, implication), then for each of the six paragraphs its purpose, writing points, and gaps with severity, then the five consistency checks (running-example loop, limitations-to-challenges, goal-to-contribution-1, challenge-to-module mapping, contribution-to-section mapping). The same internal planning, externalized once, on request.
Tone references
The shared style references live with their canonical copies in
paper-polish (ai-tone-guardrails, academic-phrasebank,
section-conventions) and apply to this skill's prose pass; consult them
through that skill's references when finer wording support is needed.
Cross-skill handoffs
- Introduction done, rest of the paper wanted:
paper-writer. - Prose in place but stiff:
paper-polish. - Doubts that the idea itself can carry a top-venue paper: do not write
that into the Introduction; put one line in the closing note and point to
idea-evaluator.
Output language
Follow an explicit language request first; a named Chinese journal or Chinese thesis means Chinese prose; otherwise default to English. Never infer the output language from the language of the user's message.
FAQ
What does the intro-drafter skill do?
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.
How do I install intro-drafter?
Run npx skills add https://github.com/hkustdial/supervisor-skills --skill intro-drafter 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/intro-drafter/ (personal) or .claude/skills/intro-drafter/ (project).
Which AI agents can use intro-drafter?
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 intro-drafter 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 intro-drafter?
It is published by hkustdial in hkustdial/supervisor-skills. It has 723 recorded installs.
More from hkustdial/supervisor-skills
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'.
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.
tech-paper-template
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'.
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
teach
mattpocock/skills
Teach the user a new skill or concept, within this workspace.
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.
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.
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.
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.
teach-impeccable
pbakaus/impeccable
DEPRECATED: Use /impeccable teach instead. This command has been folded into the impeccable skill.