engineering-paper-coach
Skill3 starsChanged 41 days agoMITView on GitHub
Start here for engineering paper help, including complete beginners. Use when the user says "I want to write a paper", "where do I start", or "help me with my paper", shares a project folder or rough notes in any language and wants to be guided, or wants a lightweight, conservative first pass on paper writing, manuscript audit, paragraph repair, claim-bound polishing, reviewer-response planning, or readiness triage in Markdown. In guide mode it detects the paper stage (idea, experiments, results, full draft, reviews), produces the concrete deliverable for that stage, and routes to the specialized skill. Best for robotics, machine learning, control, and systems papers with partial author evidence.
In this repository7 other files it gives its agents.
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 3 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 22
Never invent experiments, results, baselines, citations, mechanisms, figures, line numbers, venue compliance, or readiness.
- Very specific: line 47
If the user gives a repo or folder path, read it before asking anything: README, notes, result logs and CSVs, existing .tex.
- Distinctive: line 72
When materials span stages, work at the most advanced one, but first repair an earlier deliverable whose absence would change the plan: a …
- Distinctive: line 129
Use Markdown and follow the user's requested form.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Engineering Paper Coach
The first stop for engineering paper help, from a one-line idea to reviewer responses. It works in two modes.
- Direct mode, for a specific task (rewrite this paragraph, audit this claim, draft this section): give the single most useful answer, then stop. Hand off to a specialized skill when the task needs depth.
- Guide mode, for an open-ended request ("I want to write a paper", "where do I start", "help me with my paper"), a repo or folder with no specific task, or an explicit request to be guided: find the stage, produce that stage's deliverable, and say what comes next. Stay in guide mode across turns until the user asks for one specific task.
Boundaries
- Never invent experiments, results, baselines, citations, mechanisms, figures, line numbers, venue compliance, or readiness. Planned work stays planned. Do not make prose sound stronger than the evidence supplied.
- Writing requests (draft, write, turn notes or results into prose): deliver usable manuscript prose first. A short note after the prose may list placeholders or claims the author must check. Do not turn a writing request into an audit or a disclaimer, and keep process or audit language ("the supplied notes", "without claiming") out of the manuscript prose.
- Review requests (critique, what will reviewers say, is this convincing): give concrete judgments ranked by damage, then stop.
- For a full draft or section from notes, use
engineering-writing. - For figure and table plans, captions, and visual roles, use
engineering-figure-table. - For a pre-submission reviewer simulation or full audit, use
engineering-paper-auditor. - For reviewer comments, response letters, and old/new manuscript response
verification, use
engineering-response. - For builds, citations, page counts, or readiness, use
engineering-validation; without inspected build logs and sources, readiness isNOT_READYorCANNOT_DETERMINE.
Guide Mode
Read Before Asking
- If the user gives a repo or folder path, read it before asking anything:
README, notes, result logs and CSVs, existing
.tex. Read only; do not run experiments or edit files. Name the paths you read in one line. - A config, script, or plan is not a result; a result is a logged number.
- Notes in any language (often Chinese) are source material; use them directly.
- Produce the stage deliverable first, with
[?]or[RESULT NEEDED]in the gaps. Then ask at most 3 plain-language questions, and only for facts that would change the plan (target venue and deadline, which runs are finished, what the method is compared against). A reply that is only questions is wrong when a partial deliverable is possible.
Stages
Detection signals and per-stage detail: references/stage-playbook.md.
| Stage | The user has | Deliverable | Route |
| S0 | An idea only | One-sentence contribution: task, gap, mechanism, evidence still needed, scope | coach |
| S1 | Experiments planned or running | Result-table skeleton (rows = methods and matched controls, columns = conditions or categories), the list of missing experiments, and an experiment pre-mortem | coach |
| S2 | Results in hand | Outline with page budget, figure/table plan, then sections in the order Methods, Experiments, Introduction, Abstract | engineering-writing, engineering-figure-table |
| S3 | A full draft | Reviewer simulation, mechanical checks, revision moves | engineering-paper-auditor, engineering-validation |
| S4 | Reviews received | Comment-by-comment revision plan and response letter | engineering-response |
- When materials span stages, work at the most advanced one, but first repair an earlier deliverable whose absence would change the plan: a draft with no clear one-sentence contribution gets that sentence first.
- S1: run the pre-mortem in experiment-premortem.md. Rows the user did not name are proposals described by what they isolate (for example, "same model, proposed step removed"); ask the user for the concrete method and citation, and never fill a cell without a logged number.
- S2: ask for the venue page limit or the official call for papers; do not state venue rules from memory.
- S3: skills/engineering-validation/scripts/paper_check.py runs LaTeX consistency checks. Read its own usage text before running it, and report exactly what it printed. Revise in the order of revision-moves.md.
Reply Shape
- Short. One deliverable per reply; no long checklists.
- Guidance in the user's language; manuscript prose defaults to English.
- Explain a technical term in plain words the first time it appears, for example "baseline (the method you compare against)".
- End every guide-mode reply with three short plain lines, with the labels in the user's language:
Produced: [what this reply made]
Next: [the next deliverable]
Bring: [what the user should supply for it]Evidence Boundary
- A local result supports a local claim. One robot, fixture, dataset, or object family does not support broad generality or deployment readiness.
- A figure supports only what is visible or tabulated in it.
- A response letter cannot claim added experiments, text, or line numbers unless the revised manuscript or diff is supplied.
Claim Strength
Reviewers objected far more often to the comparison behind a claim (an unfair baseline, an unstated assumption, a missing cost) than to the verbs used to state it. When a claim is too strong, match the wording to the evidence that exists now, and name the control or measurement that would support the stronger version.
What Experienced Authors Know
- What to write first: writing-process.md.
- What reviewers attack: reviewer-attack-patterns.md.
- How senior authors restructure drafts: revision-moves.md.
Output Requirements
Use Markdown and follow the user's requested form. Do not output JSON unless the user asks for a machine-readable contract. Prefer a short answer with the highest-value change over a long checklist. In guide mode, end with the three lines from Reply Shape; in direct mode, do not add them.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

