hkustdial/supervisor-skills

vibe-research-workflow

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.

Vedi sorgente

Come usare

  1. Copia il comando e controlla il pacchetto prima di installarlo nel tuo ambiente agente.
  2. Controlla strumenti, credenziali e ambienti richiesti nel documento originale.
  3. Descrivi input e risultato desiderato; confronta l’output con le fonti.
npx skills add https://github.com/hkustdial/supervisor-skills --skill vibe-research-workflow

Prima di iniziare

  • L’installazione non include abbonamenti, quote API o accesso ai file.
  • Stelle e installazioni indicano attività, non un test indipendente di qualità o sicurezza.
Documento Skill originale

Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.

Vibe Research Workflow

Overview

Vibe Research is the modern research workflow where large language models and AI coding tools handle mechanical tasks (implementation, figure rendering, language polish) while the researcher retains full ownership of research direction, problem framing, experimental design, and factual accuracy. The goal is a two-to-five times productivity gain on routine tasks without compromising academic integrity.

The skill has three sub-flows: Vibe Coding (AI-assisted code), Vibe Figure (AI-assisted figure production), Vibe Writing (AI-assisted prose polish). Each is governed by six behavioural rules that draw a hard line between acceptable use (mechanical acceleration, auxiliary suggestions, style correction) and academic misconduct (fabricated citations, outsourced scientific judgment, hidden AI authorship).

This skill is a meta-skill that orchestrates tool selection, flow design, and integrity enforcement across a research session. It consolidates the the curriculum's Vibe Research section into a single invocable procedure.

When to use this skill

  • Starting a new AI-assisted work block (a morning of coding, a

figure day, a writing session).

  • The user asks 'how to use AI for research', 'Vibe Coding tips',

'AI-assisted writing workflow', 'which AI tool for this'.

  • The user is choosing between Cursor, Claude Code, Codex, Figma,

Gemini, or other tools.

  • The user wants a workflow plan for a multi-day project

involving AI.

  • The user suspects AI output has drifted into unacceptable

territory (fabricated citations, outsourced reasoning).

When NOT to use this skill

  • The user wants paper prose drafted. That is legitimate under this

plugin's evidence discipline and belongs to the drafting skills: route to paper-writer (any section) or intro-drafter (Introductions), whose rules forbid fabricated substance (every factual claim traces to the user's materials, verified retrieval, or field common knowledge). Remind the user that venue and school AI-disclosure policies still apply, and that they remain responsible for verifying every drafted passage against their actual research. What stays forbidden is fabrication, not drafting.

  • The user wants a code implementation done. This skill guides

the process; it does not replace the implementation itself.

  • The user wants to evaluate research direction. Use

idea-evaluator (see handbook 2.3 for disruptive-innovation deep-dive).

Core procedure

Step 1: Phase classification

Decide which phase the user is in: coding, figure, writing, or mixed.

Step 2: Behavioural rules recap

See: references/behavior-guidelines.md for the full six-rule set.

State the six rules succinctly at the start of the session:

  1. AI-assisted work is permitted for literature search and

organisation, code and debugging support, language and expression polish.

  1. Research ideas, problems, designs, technical paths,

experimental plans, core conclusions, and novelty must be the user's own and fully understood. Drafting assistance is legitimate within that boundary: the substance belongs to the user; the linguistic realization may be AI-assisted; the verification duty (rule 3) is unchanged.

  1. Every AI-generated or AI-assisted passage is verified by the

user against the actual research process, experimental results, and facts.

  1. No fabricated citations; references come from the user's own

reading and confirmation.

  1. No academic misconduct, including fabricated data,

experimental results, or plagiarism concealment.

  1. Venue or school AI-disclosure requirements are honoured.

These rules are non-negotiable and enforced in the integrity gate.

Step 3: Phase-specific procedure

For Vibe Coding, see: references/vibe-coding.md.

For Vibe Figure, see: references/vibe-figure.md.

For Vibe Writing, see: references/vibe-writing.md.

Each phase has its own core techniques (Plan Mode, Small Steps, Clear Requirements for coding; four-step figure workflow; red-line rules for writing).

Step 4: Tool selection

See: references/tool-selection.md for the tool matrix.

Match tool to phase:

  • Coding: Cursor (IDE-native) or Claude Code (agentic CLI) or

Codex.

  • Figure: PowerPoint plus Figma for static figures; Matplotlib

plus Seaborn for experimental results; Gemini for first-draft sketches.

  • Writing: Claude or ChatGPT for language polish; Grammarly for

grammar; Overleaf for LaTeX.

Step 5: Integrity gate

Before closing the session, run the checks in the Integrity gate section below.

Step 6: Output

Emit the workflow plan in the Output format below.

Integrity gate

This skill is a behavioural nudge, not a verification engine. Most bullets are tagged [user-attest] because the LLM cannot actually observe the user's private verification work. [inspection] tags apply only to checks the LLM can confirm from its own outputs and the user's session history.

Before ending the session:

  1. [inspection] The six behavioural rules have been stated at

the start of the session.

  1. [user-attest] No fabricated citation has been introduced or

accepted. (The LLM cannot verify citations without web access; the user confirms via DBLP or arXiv.)

  1. [user-attest] The user's research direction, framing, and

contributions are owned by the user, not by AI.

  1. [user-attest] Every AI-generated code block has been

reviewed and tested by the user.

  1. [user-attest] Every AI-drafted paragraph has been rewritten

or at minimum sentence-by-sentence verified by the user.

  1. [attestation] Venue or school AI-disclosure rules have been

checked. The skill asks the user to name the venue and surfaces known policy types; the user confirms compliance.

  1. [user-attest] The user's own expertise is still driving the

project; AI is an accelerator, not a replacement.

Any red-line violation (rules 1-6) stops the session. The user should fix the violation or consult an advisor before continuing. Because most bullets are [user-attest], the skill's effective value is the reminder at session start, not a runtime block.

Output format

1. Phase

  • Primary phase: <coding or figure or writing or mixed>
  • Secondary phases: <list>

2. Behavioural rules recap

  • Rule 1-6 (see references/behavior-guidelines.md): acknowledged

3. Workflow plan

Time blockPhaseActivityToolUser check
...............

4. Tool recommendations

PhasePrimary toolAlternativeReason
Coding.........
Figure.........
Writing.........

5. Red-line reminders

  • ... (from references/vibe-writing.md)

6. Integrity gate plan

  • Verification points: ...
  • AI-disclosure requirements for the target venue: ...

Correlati per attività

dallo stesso repository

Altri Skills

Tutti gli Skills
hkustdial
Community

benchmark-paper-template

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

installazioni
2
GitHub Stars
10,2K
Aggiornato
16 ott
hkustdial
Community

deep-research

Runs a deep, survey-grade literature investigation on a research topic: freezes research questions, searches from multiple adversarial perspectives, verifies every citation, synthesizes evidence into a MECE taxonomy with in-sentence cross-comparison, and answers the research questions in an evidence-first report. Use when the user asks for a literature review, a survey of a field, research landscape mapping, or a deep dive into what is known about a topic.

installazioni
2
GitHub Stars
10,2K
Aggiornato
16 ott
hkustdial
Community

drawio-reconstruction

Reconstructs reference images into high-fidelity, editable Draw.io files with rendered previews: native Draw.io elements carry text and structure, SVG covers simple icons that match the reference, and cropped or transparent PNGs preserve complex visuals. Use when the user wants a diagram image, research figure, architecture diagram, slide, UI screenshot, or image folder turned into .drawio XML; batch requests use a manifest with bounded parallelism when available and a full-fidelity serial fallb

installazioni
2
GitHub Stars
10,2K
Aggiornato
16 ott
hkustdial
Community

figure-designer

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'.

installazioni
2
GitHub Stars
10,2K
Aggiornato
16 ott