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

engineering-polishing

Skill3 starsChanged 41 days agoMITView on GitHub

Polish, locally restructure, or translate source notes into English engineering manuscript prose while preserving evidence boundaries. Use when the user asks to improve English academic style, paragraph flow, claim strength, anti-AI wording, terminology consistency, hedging, clarity, or publication-ready expression for existing engineering conference or journal paper content. Do not use for creating a new section argument, figure/table-only work, reviewer responses, or readiness validation.

The file

We split this skill into the rules it gives an agent

12 rules. About 0 are common, 8 are distinctive, and 4 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈8

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use this skill after the paper's claim and evidence are known.

    line 8
  2. Distinctive:

    Do not invent facts, references, mechanisms, experiments, numbers, novelty, or limitations.

    line 14
  3. Distinctive:

    Do not polish a broken argument as if it were correct.

    line 16
  4. Distinctive:

    Prefer restrained, concrete academic English over promotional language.

    line 20
  5. Distinctive:

    If the paragraph lacks a stable claim-evidence structure, first return a logic diagnosis and do not present polished prose as final.

    line 24
  6. Very specific:

    Use engineering-writing when the user needs a new section argument, contribution map, or full paper structure.

    line 26
  7. Very specific:

    Use engineering-figure-table for captions, figure/table roles, or visual consistency.

    line 28
  8. Very specific:

    Use engineering-response for comments and response letters.

    line 30
  9. Very specific:

    Use engineering-validation for build checks or readiness claims.

    line 31
  10. Distinctive:

    Run a sentence-role check: each sentence must be necessary, placed correctly, connected to its neighbors, and bounded by evidence.

    line 71
  11. Distinctive:

    Run a claim-strength diff against the source before accepting stronger verbs.

    line 73
  12. Distinctive:

    If the user asks for output only, return only the polished prose unless doing so would hide unsupported claims or unverified evidence.

    line 111

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

Use this skill after the paper's claim and evidence are known. It improves English manuscript prose without hiding structural or evidence problems.

Core Stance

  • Final output defaults to English manuscript prose.
  • Do not invent facts, references, mechanisms, experiments, numbers, novelty, or limitations.
  • Do not polish a broken argument as if it were correct.
  • Diagnose the failure mode before rewriting.
  • Preserve technical terms, variables, units, metric definitions, and evidence boundaries.
  • Prefer restrained, concrete academic English over promotional language.

Boundaries

  • If the paragraph lacks a stable claim-evidence structure, first return a logic diagnosis and do not present polished prose as final.
  • Use engineering-writing when the user needs a new section argument, contribution map, or full paper structure.
  • Use engineering-figure-table for captions, figure/table roles, or visual consistency.
  • Use engineering-response for comments and response letters.
  • Use engineering-validation for build checks or readiness claims.

When to Open Extra Files

FileOpen when
../_shared/revision-moves.mdRevising a draft: order of revision, expert section moves, sentence-level rules
references/fact-boundary.mdThe source is a rough skeleton, non-English notes, or evidence is incomplete
references/paragraph-function.mdIdentifying paragraph job before rewriting
references/engineering-topic-modules.mdPolishing control, algorithm, data-driven, materials, process, or multi-physics paragraphs
references/list-handling.mdSkill-specific list cleanup examples
references/paragraph-flow.mdParagraphs feel unclear, repetitive, poorly ordered, or hard to follow
references/claim-strength.mdClaims may overstate evidence, causality, robustness, generalization, or novelty
references/claim-strength-diff.mdComparing source and rewrite to ensure polish did not strengthen claims
references/anti-ai-prose.mdText sounds generic, repetitive, slogan-like, template-like, or model-generated
references/style-guardrails.mdNeed sentence-level academic English, transitions, hedging, terminology, or mechanics
references/source-notes.mdNon-English or rough notes must become English manuscript prose
references/source-note-expansion-check.mdA rewrite may have introduced facts not present in source notes
references/whole-paper-style-drift.mdMultiple sections may sound inconsistent, overly smooth, or template-like
references/examples.mdNeeding before/after examples or output behavior examples
references/failure-modes.mdHandling requests to strengthen unsupported claims or hide weak evidence
../_shared/evidence-boundary.mdThe rewrite may change factual scope or claim strength
../_shared/claim-strength.mdA local claim needs verb or novelty calibration
../_shared/ai-assisted-writing-policy.mdPolished prose may hide AI-smell, unverified facts, or disclosure risk
../_shared/list-to-argument.mdSource prose is a list rather than a paragraph argument
../_shared/non-english-source-notes.mdSource notes include assumptions or non-English shorthand
../_shared/output-mode.mdThe user asks for output only
../_shared/sentence-role-and-story-flow.mdChecking whether each sentence is necessary, connected, and non-redundant
../_shared/terminology-ledger.mdUser asks for varied wording around technical terms

Workflow

  1. Identify the section and paragraph job.
  2. Apply fact-boundary checks when source notes are thin.
  3. Diagnose the main problem: paper logic, section job, paragraph flow, claim/evidence mismatch, or sentence style.
  4. Fix higher-level logic before sentence polish: argument, then evidence design, then section moves, then sentences (revision-moves.md).
  5. Run a sentence-role check: each sentence must be necessary, placed correctly, connected to its neighbors, and bounded by evidence.
  6. Run a claim-strength diff against the source before accepting stronger verbs.
  7. Preserve source facts and evidence boundaries.
  8. Rewrite in English with concrete subjects, varied sentence shapes, and calibrated verbs. Put linking information at the start of a sentence and the new point at the end; keep subject and verb close. Check single words that change the technical claim ("dedicated", "verify", "generalize").
  9. Report any claim that still needs evidence.

A paragraph has a stable claim-evidence structure only when at least three of these are clear: paragraph job, main claim, evidence anchor, and boundary. If fewer than three are clear, diagnose first and do not present polished prose as final.

Default Output

Diagnosis
- Paragraph job:
- Main issue:
- Evidence risk:

Before / After / Rationale
| Source sentence or span | Revised sentence or span | Rationale | Fact/evidence risk |

Claim-strength diff
| Source claim | Revised claim | Strength change | Allowed? | Reason |

Sentence role audit
| Sentence/span | Job | Needed because | Connection to previous/next | Evidence boundary | Action |

Polished version
[English prose]

Unsupported claims
- ...

If the user asks for output only, return only the polished prose unless doing so would hide unsupported claims or unverified evidence.

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.