# Supervisor-Skills

> A PhD-level academic research methodology distilled into eleven structured skills, covering research discovery, idea evaluation, paper planning, drafting, polishing, figure design and reconstruction, pre-submission review, and AI-assisted research workflow. Usable as a standalone Chinese curriculum at `handbook/`, as an English mirror at `handbook-en/`, or as Agent Skills under `skills/`.

Target audience: researchers writing papers for NeurIPS, ICML, ICLR, VLDB, SIGMOD, KDD, ACL, EMNLP, CVPR, and similar top venues.

## Install

Paste the following prompt into your AI assistant:

```
Help me install every skill under the skills/ directory from https://github.com/HKUSTDial/Supervisor-Skills. Treat each directory containing SKILL.md as a separate skill; do not install the repository root as one skill. If you are Codex, use $skill-installer.
```

To install only Draw.io reconstruction:

```
Use $skill-installer to install https://github.com/HKUSTDial/Supervisor-Skills/tree/main/skills/drawio-reconstruction.
```

See [README.md](README.md) (Chinese) or [README.en.md](README.en.md) for full details.

## Skills (v2.2.0)

Eleven anchor skills under `skills/` cover the full paper lifecycle, plus one model layer (`aipdd-gateway`).

- [deep-research](skills/deep-research/deep-research.md): survey-grade literature investigation with multi-perspective search, per-citation verification, MECE synthesis, and a report that answers explicit research questions.
- [idea-evaluator](skills/idea-evaluator/idea-evaluator.md): scores a research idea on the five-dimension framework (Higher / Faster / Stronger / Cheaper / Broader) plus lifecycle-capability matching, fatal-flaws audit, and paradigm-shift probe; non-STEM ideas route to substitute frameworks.
- [vibe-research-workflow](skills/vibe-research-workflow/vibe-research-workflow.md): Vibe Coding, Vibe Figure, Vibe Writing tool choice and six behavioral rules for AI-assisted research.
- [tech-paper-template](skills/tech-paper-template/tech-paper-template.md): technical-paper thinking table with four self-consistency checks and Technique vs New Problem positioning.
- [intro-drafter](skills/intro-drafter/intro-drafter.md): six paragraphs of Introduction prose from the six-paragraph flowchart, with retrieval-verified citations; outline mode on request.
- [paper-writer](skills/paper-writer/paper-writer.md): evidence-gated drafting of any paper section or a full manuscript; every claim traces to the author's materials or verified retrieval, citations pass an independent verification ladder.
- [benchmark-paper-template](skills/benchmark-paper-template/benchmark-paper-template.md): benchmark-paper five-pillar audit, six-part Introduction logic chain, Section 2-7 skeleton, and pre-submission checklist.
- [paper-polish](skills/paper-polish/paper-polish.md): meaning-preserving language polish, AI-tone removal, claim calibration, and Chinese-to-English rewriting, with meaning-risk edits flagged.
- [figure-designer](skills/figure-designer/figure-designer.md): paradigm selection and quality audit for motivated-example, solution-overview, and experimental-results figures.
- [drawio-reconstruction](skills/drawio-reconstruction/drawio-reconstruction.md): rebuilds reference images, paper figures, and screenshots into editable Draw.io files with PNG previews and visual audits.
- [pre-submission-reviewer](skills/pre-submission-reviewer/pre-submission-reviewer.md): paradigm-aware reviewer self-check covering macro logic, writing detail, grammar, LaTeX format, and figure quality, with retrieval-grounded novelty and citation-completeness checks.
- [aipdd-gateway](skills/aipdd-gateway/aipdd-gateway.md): default model layer over `https://api.aipdd.work`. One API key covers text and vision chat, image generation and editing, video, speech, transcription, embeddings, and the decision endpoint. Handles onboarding, live model discovery, model choice, cost approval, and evidence-safe use of generated output. CLI: `python3 scripts/aipdd_gateway.py`.

## Model gateway

- Register at `https://app.aipdd.work`, create a key under Global Settings then API Key Management, then run `printf '%s' "$AIPDD_API_KEY" | python3 scripts/aipdd_gateway.py configure`. The key is stored in the package-root `config.json` (mode 600) and reused later; `doctor` reports key source, reachability, and the live capability matrix.
- Endpoint families: `/v1/chat/completions`, `/v1/images/generations`, `/v1/images/edits`, `/v1/videos`, `/v1/audio/speech`, `/v1/audio/transcriptions`, `/v1/embeddings`, `/v1/systemone`. Model ids, availability, and prices are read from `GET /v1/models` at run time and are never hardcoded.
- Paid media calls print an estimate and require `--yes`; `--dry-run` inspects the request without sending. `config.json` and `outputs/` stay local, and `python3 scripts/pack_skill.py` builds a whitelist distribution that excludes both.

## Reader curriculum

The original Chinese curriculum by the methodology author lives at `handbook/`. An English mirror lives at `handbook-en/`. Both are organized into six chapters.

- `handbook/01_Preliminary/` — evaluating paper quality from a reviewer's perspective.
- `handbook/02_Idea_Generation/` — idea lifecycle, five-dimension thinking, disruptive innovation.
- `handbook/03_Paper_Writing/` — paper lifecycle, Introduction flowchart, technical and benchmark templates, writing checklist.
- `handbook/04_Scientific_Plotting/` — motivated, overview, experimental figures and a drawing checklist.
- `handbook/05_Vibe_Research/` — AI-assisted research workflow and practitioner notes.
- `handbook/06_Case_Studies/` — Alpha-SQL (ICML 2025), AFlow (ICLR 2025), LEAD (VLDB 2026) Introduction analyses.

## Supporting documentation

- [Contributing guide](CONTRIBUTING.md): how to contribute.
- [Changelog](CHANGELOG.md): version history.
- [License](LICENSE): CC BY-NC-SA 4.0.
