agentleFS
169884902hzl169884902hzl/engineering-paper-skills/skills/engineering-paper-coach/SKILL.md

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.

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
  1. Distinctive:

    Never invent experiments, results, baselines, citations, mechanisms, figures, line numbers, venue compliance, or readiness.

    line 22
  2. Very specific:

    If the user gives a repo or folder path, read it before asking anything: README, notes, result logs and CSVs, existing .tex.

    line 47
  3. Distinctive:

    When materials span stages, work at the most advanced one, but first repair an earlier deliverable whose absence would change the plan: a …

    line 72
  4. Distinctive:

    Use Markdown and follow the user's requested form.

    line 129

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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 is NOT_READY or CANNOT_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.

StageThe user hasDeliverableRoute
S0An idea onlyOne-sentence contribution: task, gap, mechanism, evidence still needed, scopecoach
S1Experiments planned or runningResult-table skeleton (rows = methods and matched controls, columns = conditions or categories), the list of missing experiments, and an experiment pre-mortemcoach
S2Results in handOutline with page budget, figure/table plan, then sections in the order Methods, Experiments, Introduction, Abstractengineering-writing, engineering-figure-table
S3A full draftReviewer simulation, mechanical checks, revision movesengineering-paper-auditor, engineering-validation
S4Reviews receivedComment-by-comment revision plan and response letterengineering-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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.