Pre-Submission Reviewer
Overview
Three to five days before a submission deadline is the window where
a careful external review pays off most. This skill takes a full
paper or key sections and produces a structured review across five
dimensions, each with severity-tagged findings and concrete
rewrite suggestions. It enforces the mechanical rules from the
writing-checklist section (no em-dashes, no banned AI-tone
vocabulary, leading text per paragraph, topic-sentence discipline,
citation-format uniformity) and surfaces the patterns that
non-native English-speaking authors most commonly violate
(articles, subject-verb agreement, tense consistency, which versus
that, Chinglish phrasing).
The output is not a rewrite. It is a prioritised list of findings
with severity tags; the author decides which to fix. CRITICAL items
should block submission until addressed.
When to use this skill
- Three to five days before a submission deadline.
- The user asks to 'review this paper', 'audit before submission',
'check the draft', 'find issues', 'proofread'.
- After a camera-ready revision, before sending the final version.
- After any major rewrite (rebuttal responses, Section 3 overhaul).
- When the user suspects AI-tone contamination in a section.
When NOT to use this skill
- The paper is still being structured. Use
tech-paper-template,
intro-drafter, or benchmark-paper-template (separate plugin) first.
- The user wants structural advice rather than review. Use the
drafting skills instead.
Core procedure
Step 0: paradigm and venue fit
Before the dimensional review, settle two things.
Paradigm, judged by research method, because what counts as a
severe problem differs by paradigm:
- STEM / technical (CS, engineering, materials, chemistry): weight
the Introduction chain, contribution-to-section mapping, baseline
coverage, ablation-based attribution, figure quality. Benchmark
papers additionally get coverage, reproducibility, and
contamination checks; chemistry and materials get characterization
completeness, purity, controls, replicates.
- Humanities (literature, history, philosophy, discourse
analysis): weight whether the thesis is explicit and defensible,
core concepts pinned down and stable across sections, the
literature genuinely engaged, and the material (texts, archives,
cases) able to carry the claims. Do not demand baselines or
ablations here; check instead whether sub-arguments build on each
other rather than sit in parallel, and whether conclusions outrun
the material.
- Empirical social science: weight operationalized research
questions, sampling and data-source justification, statistics
matched to data types, conclusions bounded by the sample. For
theory papers, "experiments" reads as "proofs": check the proofs,
and never call the evidence thin merely because there is no results
table.
- Finance / economics: weight identification credibility,
endogeneity handling, robustness checks (their absence is a
first-round flag), and economic versus merely statistical
significance.
- Law: weight the accuracy of statutes, case numbers, and
holdings (an invented or wrong citation is rejection-level), the
clarity of the interpretive approach, and whether comparative
arguments state their scope.
When the paradigm is unclear, ask the author before reviewing with
the wrong ruler.
Venue fit: if the stated target venue's scope visibly mismatches
the paper's topic or contribution type, that is a real rejection
risk, not a taste note. Flag it as a finding and suggest two or three
better-fitting venues.
Step 1: Dimension 1 Macro logic review
See: references/logic-and-structure.md for the Logic First rule,
Self-contained rule, Leading Text rule, and Running Example rule.
Check:
- Introduction flowchart is intact (Background, Limitations, Goal
or Key Idea, Challenges, Methodology, Contributions).
- Contributions map one-to-one with methodology modules and with
section numbers.
- Experiments validate the paper's main claims, not tangential
ones.
- Related Work covers the necessary prior art.
- Running example is consistent across Introduction, Methodology,
Experiments.
- The headline result's attribution is isolated: an ablation
separates the core mechanism from peripheral factors (a routing
step, post-processing, a stronger base model, favorable samples).
No such ablation: flag "attribution unverified" as MAJOR.
- Claims match their evidence: "solves" is stronger than most papers
earn (usually "improves"); "state-of-the-art" needs the benchmark
and conditions; "we are the first" gets checked or flagged.
Every break in the chain is CRITICAL.
Retrieval-grounded checks (when the environment has a
literature-search capability: a scholarly tool, web search over
scholarly indexes, or shell access to public APIs):
- Novelty verification: extract two or three keyword groups from
the paper's core method and problem setting, retrieve, and identify
the three to five closest published works. If Related Work already
covers them, the paper's positioning stands; a highly relevant
uncovered work is a MAJOR finding ("missed X, Author et al.,
Year"). Compare on difference axes; a similar title alone proves
nothing.
- Citation completeness: retrieve the field's recent
representative works and its canonical ones, and compare against
the reference list; a missing canonical baseline, founding paper,
or recent survey is MAJOR.
Retrieval results support metadata-level judgments only; never quote
numbers or method details from search snippets. Without any retrieval
capability, skip these two checks and say so in the summary.
Step 2: Dimension 2 Writing details review
See: references/logic-and-structure.md for paragraph-level rules.
Check:
- Every paragraph has a topic sentence.
- Paragraphs transition smoothly; no orphan paragraphs.
- Paragraphs are not over 10 lines; split if so.
- No repeated or redundant passages.
- Abstract covers problem, method, result.
Step 3: Dimension 3 English grammar review
See: references/grammar-rules.md for the canonical list of errors
common to non-native English authors, with corrections and
examples.
Check the usual suspects:
- Article use (a, an, the).
- Subject-verb agreement (third-person singular).
- Tense consistency (Related Work past, method present).
- Passive-voice overuse.
- Which versus that.
- Sentence length; split long sentences at "Specifically,".
- Chinglish patterns.
Step 4: Dimension 4 LaTeX format review
See: references/latex-rules.md for the canonical list of LaTeX-
specific issues.
Check:
- Equation numbering contiguous; every numbered equation
referenced.
- Figures and tables have captions; captions are detailed.
- Citations use the correct command and the non-breaking tilde
(for example,
ResNet~\cite{X}, never ResNet\cite{X}).
- Labels use underscores, not spaces or hyphens.
- Vector figure format; no raster.
- Page-limit compliance.
Step 5: Dimension 5 Figure quality review
See: references/forbidden-patterns.md for chartjunk patterns and
the full figure-quality checklist.
For each figure:
- Vector format.
- Font size large enough post-scaling.
- Colour-blind-safe palette; dual encoding.
- Self-contained caption with a finding in the first sentence.
- No chartjunk.
- Motivated example is concrete and failure-revealing.
- Solution overview has labels matching section titles.
Step 6: Banned-vocabulary and em-dash scan
See: references/forbidden-patterns.md for the banned-word list.
Scan the full paper for:
- Em-dashes used as sentence connectors (banned; project rule).
- AI-tone words: innovative, pioneering, revolutionary paradigm,
transformative framework, superior, surpass, excel, remarkable,
unprecedented, breakthrough performance, general-purpose, is
capable of, notably, yet, yielding, at its essence, encompass,
differentiate, reveal, underscore, pave the way for, highlight
the potential of, profound challenges, stems from, rigid,
impede.
Flag each occurrence with a severity tag. Em-dashes are MAJOR by
default; banned AI-tone words are MAJOR if they appear three or
more times.
Step 7: Section-by-section review
See: references/section-guides.md for the per-section writing
guides for Abstract, Introduction, Problem Formulation, Framework
or Method, Experiments, Related Work, and Conclusion.
For each section, check that the section's content matches the
guide's canonical structure (for example, Abstract's five-sentence
formula: what, why, challenges, how, results).
Step 8: Integrity gate
Run the checks in the Integrity gate section below.
Step 9: Output
Emit the review in the Output format below.
Severity taxonomy
- CRITICAL: blocks submission. Example: contributions do not
map to sections; introduction flowchart broken; no real-world
running example; raster figure in final draft; missing key
baseline; page-limit violation.
- MAJOR: reviewers will flag in first round. Example:
topic-sentence absent from 3+ paragraphs; em-dash in 5+ places;
banned AI-tone word in 3+ places; Table 1 comparison missing;
chart type mismatched with data.
- MINOR: polish. Example: two long sentences that could be
split; default Matplotlib styling; single article error.
Severity honesty cuts both ways. A review that lists a dozen MINOR
items while missing the one rejection-level flaw sends the author to
submission with false confidence; a review that inflates taste issues
into CRITICAL destroys trust. The overall recommendation must match
the findings: any unresolved CRITICAL forbids "ready to submit", and
a near-ready verdict requires zero CRITICAL and at most two MAJOR.
Integrity gate
Each bullet is tagged [inspection] (LLM verifies from the paper
text) or [attestation] (LLM runs the procedure and states it has
done so; user remains responsible for confirming completeness).
Before emitting the review:
- [inspection] Every finding quotes specific text (sentence,
phrase, figure name); no "the Introduction is unclear" without
a quoted line.
- [inspection] Every CRITICAL finding has a concrete fix
suggestion, not "rewrite entirely".
- [inspection] No fabricated quotes: only text actually
present in the submitted material.
- [inspection] Severity assignments follow the taxonomy;
nothing is marked CRITICAL for taste reasons.
- [inspection] Dimension 3 (grammar) findings cite the
specific grammar rule from
references/grammar-rules.md.
- [attestation] Dimension 6 banned-vocabulary scan is run in
full on the entire paper, not sampled. The skill attests the
full scan; if the paper is extremely long, the skill states it
chunked the input and describes the chunking strategy.
- [inspection] Final score matches the CRITICAL + MAJOR
count; a score of 9 or 10 requires zero CRITICAL and at most
two MAJOR items.
If any [inspection] check fails, mark the output as "needs user
attention". For [attestation] bullets, the skill states the scope
of its scan and the user confirms completeness.
Run the gate silently. Do not print a per-gate pass or fail report;
a failure surfaces as a concrete finding in the affected dimension,
and the delivered review stays free of internal checking rituals.
Output format
Summary
- CRITICAL:
- MAJOR:
- MINOR:
- Top three fixes first: ...
Dimension 1: Macro logic
| # |
Finding |
Severity |
Suggested fix |
| 1 |
|
CRITICAL or MAJOR or MINOR |
|
Dimension 2: Writing details
Dimension 3: English grammar
<same table shape, citing grammar-rule ID>
Dimension 4: LaTeX format
Dimension 5: Figure quality
Banned-vocabulary and em-dash scan
Final score (1-10)
Submission recommendation
- <Ready to submit | Needs 1-2 days more work | Needs major revision before submission>
1---2name: pre-submission-reviewer3description: Runs a pre-submission review of a technical paper across five dimensions: macro logic, writing details, English grammar, LaTeX formatting, and figure quality. Uses a reviewer-style severity taxonomy (CRITICAL / MAJOR / MINOR) and flags banned AI-tone vocabulary and em-dash misuse. Use when the user asks to 'review this paper', 'audit before submission', 'check the draft', 'find issues', 'proofread', or within one week of a submission deadline.4license: CC-BY-4.05---6
7# Pre-Submission Reviewer
8
9## Overview
10
11Three to five days before a submission deadline is the window where
12a careful external review pays off most. This skill takes a full
13paper or key sections and produces a structured review across five
14dimensions, each with severity-tagged findings and concrete
15rewrite suggestions. It enforces the mechanical rules from the
16writing-checklist section (no em-dashes, no banned AI-tone
17vocabulary, leading text per paragraph, topic-sentence discipline,
18citation-format uniformity) and surfaces the patterns that
19non-native English-speaking authors most commonly violate
20(articles, subject-verb agreement, tense consistency, which versus
21that, Chinglish phrasing).
22
23The output is not a rewrite. It is a prioritised list of findings
24with severity tags; the author decides which to fix. CRITICAL items
25should block submission until addressed.
26
27## When to use this skill
28
29- Three to five days before a submission deadline.
30- The user asks to 'review this paper', 'audit before submission',
31 'check the draft', 'find issues', 'proofread'.
32- After a camera-ready revision, before sending the final version.
33- After any major rewrite (rebuttal responses, Section 3 overhaul).
34- When the user suspects AI-tone contamination in a section.
35
36## When NOT to use this skill
37
38- The paper is still being structured. Use `tech-paper-template`,
39 `intro-drafter`, or `benchmark-paper-template` (separate plugin) first.
40- The user wants structural advice rather than review. Use the
41 drafting skills instead.
42
43## Core procedure
44
45### Step 0: paradigm and venue fit
46
47Before the dimensional review, settle two things.
48
49**Paradigm**, judged by research method, because what counts as a
50severe problem differs by paradigm:
51
52- **STEM / technical** (CS, engineering, materials, chemistry): weight
53 the Introduction chain, contribution-to-section mapping, baseline
54 coverage, ablation-based attribution, figure quality. Benchmark
55 papers additionally get coverage, reproducibility, and
56 contamination checks; chemistry and materials get characterization
57 completeness, purity, controls, replicates.
58- **Humanities** (literature, history, philosophy, discourse
59 analysis): weight whether the thesis is explicit and defensible,
60 core concepts pinned down and stable across sections, the
61 literature genuinely engaged, and the material (texts, archives,
62 cases) able to carry the claims. Do **not** demand baselines or
63 ablations here; check instead whether sub-arguments build on each
64 other rather than sit in parallel, and whether conclusions outrun
65 the material.
66- **Empirical social science**: weight operationalized research
67 questions, sampling and data-source justification, statistics
68 matched to data types, conclusions bounded by the sample. For
69 theory papers, "experiments" reads as "proofs": check the proofs,
70 and never call the evidence thin merely because there is no results
71 table.
72- **Finance / economics**: weight identification credibility,
73 endogeneity handling, robustness checks (their absence is a
74 first-round flag), and economic versus merely statistical
75 significance.
76- **Law**: weight the accuracy of statutes, case numbers, and
77 holdings (an invented or wrong citation is rejection-level), the
78 clarity of the interpretive approach, and whether comparative
79 arguments state their scope.
80
81When the paradigm is unclear, ask the author before reviewing with
82the wrong ruler.
83
84**Venue fit**: if the stated target venue's scope visibly mismatches
85the paper's topic or contribution type, that is a real rejection
86risk, not a taste note. Flag it as a finding and suggest two or three
87better-fitting venues.
88
89### Step 1: Dimension 1 Macro logic review
90
91See: references/logic-and-structure.md for the Logic First rule,
92Self-contained rule, Leading Text rule, and Running Example rule.
93
94Check:
95
96- Introduction flowchart is intact (Background, Limitations, Goal
97 or Key Idea, Challenges, Methodology, Contributions).
98- Contributions map one-to-one with methodology modules and with
99 section numbers.
100- Experiments validate the paper's main claims, not tangential
101 ones.
102- Related Work covers the necessary prior art.
103- Running example is consistent across Introduction, Methodology,
104 Experiments.
105- The headline result's attribution is isolated: an ablation
106 separates the core mechanism from peripheral factors (a routing
107 step, post-processing, a stronger base model, favorable samples).
108 No such ablation: flag "attribution unverified" as MAJOR.
109- Claims match their evidence: "solves" is stronger than most papers
110 earn (usually "improves"); "state-of-the-art" needs the benchmark
111 and conditions; "we are the first" gets checked or flagged.
112
113Every break in the chain is CRITICAL.
114
115**Retrieval-grounded checks** (when the environment has a
116literature-search capability: a scholarly tool, web search over
117scholarly indexes, or shell access to public APIs):
118
1191. **Novelty verification**: extract two or three keyword groups from
120 the paper's core method and problem setting, retrieve, and identify
121 the three to five closest published works. If Related Work already
122 covers them, the paper's positioning stands; a highly relevant
123 uncovered work is a MAJOR finding ("missed X, Author et al.,
124 Year"). Compare on difference axes; a similar title alone proves
125 nothing.
1262. **Citation completeness**: retrieve the field's recent
127 representative works and its canonical ones, and compare against
128 the reference list; a missing canonical baseline, founding paper,
129 or recent survey is MAJOR.
130
131Retrieval results support metadata-level judgments only; never quote
132numbers or method details from search snippets. Without any retrieval
133capability, skip these two checks and say so in the summary.
134
135### Step 2: Dimension 2 Writing details review
136
137See: references/logic-and-structure.md for paragraph-level rules.
138
139Check:
140
141- Every paragraph has a topic sentence.
142- Paragraphs transition smoothly; no orphan paragraphs.
143- Paragraphs are not over 10 lines; split if so.
144- No repeated or redundant passages.
145- Abstract covers problem, method, result.
146
147### Step 3: Dimension 3 English grammar review
148
149See: references/grammar-rules.md for the canonical list of errors
150common to non-native English authors, with corrections and
151examples.
152
153Check the usual suspects:
154
155- Article use (a, an, the).
156- Subject-verb agreement (third-person singular).
157- Tense consistency (Related Work past, method present).
158- Passive-voice overuse.
159- Which versus that.
160- Sentence length; split long sentences at "Specifically,".
161- Chinglish patterns.
162
163### Step 4: Dimension 4 LaTeX format review
164
165See: references/latex-rules.md for the canonical list of LaTeX-
166specific issues.
167
168Check:
169
170- Equation numbering contiguous; every numbered equation
171 referenced.
172- Figures and tables have captions; captions are detailed.
173- Citations use the correct command and the non-breaking tilde
174 (for example, `ResNet~\cite{X}`, never `ResNet\cite{X}`).
175- Labels use underscores, not spaces or hyphens.
176- Vector figure format; no raster.
177- Page-limit compliance.
178
179### Step 5: Dimension 5 Figure quality review
180
181See: references/forbidden-patterns.md for chartjunk patterns and
182the full figure-quality checklist.
183
184For each figure:
185
186- Vector format.
187- Font size large enough post-scaling.
188- Colour-blind-safe palette; dual encoding.
189- Self-contained caption with a finding in the first sentence.
190- No chartjunk.
191- Motivated example is concrete and failure-revealing.
192- Solution overview has labels matching section titles.
193
194### Step 6: Banned-vocabulary and em-dash scan
195
196See: references/forbidden-patterns.md for the banned-word list.
197
198Scan the full paper for:
199
200- Em-dashes used as sentence connectors (banned; project rule).
201- AI-tone words: innovative, pioneering, revolutionary paradigm,
202 transformative framework, superior, surpass, excel, remarkable,
203 unprecedented, breakthrough performance, general-purpose, is
204 capable of, notably, yet, yielding, at its essence, encompass,
205 differentiate, reveal, underscore, pave the way for, highlight
206 the potential of, profound challenges, stems from, rigid,
207 impede.
208
209Flag each occurrence with a severity tag. Em-dashes are MAJOR by
210default; banned AI-tone words are MAJOR if they appear three or
211more times.
212
213### Step 7: Section-by-section review
214
215See: references/section-guides.md for the per-section writing
216guides for Abstract, Introduction, Problem Formulation, Framework
217or Method, Experiments, Related Work, and Conclusion.
218
219For each section, check that the section's content matches the
220guide's canonical structure (for example, Abstract's five-sentence
221formula: what, why, challenges, how, results).
222
223### Step 8: Integrity gate
224
225Run the checks in the Integrity gate section below.
226
227### Step 9: Output
228
229Emit the review in the Output format below.
230
231## Severity taxonomy
232
233- **CRITICAL**: blocks submission. Example: contributions do not
234 map to sections; introduction flowchart broken; no real-world
235 running example; raster figure in final draft; missing key
236 baseline; page-limit violation.
237- **MAJOR**: reviewers will flag in first round. Example:
238 topic-sentence absent from 3+ paragraphs; em-dash in 5+ places;
239 banned AI-tone word in 3+ places; Table 1 comparison missing;
240 chart type mismatched with data.
241- **MINOR**: polish. Example: two long sentences that could be
242 split; default Matplotlib styling; single article error.
243
244Severity honesty cuts both ways. A review that lists a dozen MINOR
245items while missing the one rejection-level flaw sends the author to
246submission with false confidence; a review that inflates taste issues
247into CRITICAL destroys trust. The overall recommendation must match
248the findings: any unresolved CRITICAL forbids "ready to submit", and
249a near-ready verdict requires zero CRITICAL and at most two MAJOR.
250
251## Integrity gate
252
253Each bullet is tagged [inspection] (LLM verifies from the paper
254text) or [attestation] (LLM runs the procedure and states it has
255done so; user remains responsible for confirming completeness).
256
257Before emitting the review:
258
2591. **[inspection]** Every finding quotes specific text (sentence,
260 phrase, figure name); no "the Introduction is unclear" without
261 a quoted line.
2622. **[inspection]** Every CRITICAL finding has a concrete fix
263 suggestion, not "rewrite entirely".
2643. **[inspection]** No fabricated quotes: only text actually
265 present in the submitted material.
2664. **[inspection]** Severity assignments follow the taxonomy;
267 nothing is marked CRITICAL for taste reasons.
2685. **[inspection]** Dimension 3 (grammar) findings cite the
269 specific grammar rule from `references/grammar-rules.md`.
2706. **[attestation]** Dimension 6 banned-vocabulary scan is run in
271 full on the entire paper, not sampled. The skill attests the
272 full scan; if the paper is extremely long, the skill states it
273 chunked the input and describes the chunking strategy.
2747. **[inspection]** Final score matches the CRITICAL + MAJOR
275 count; a score of 9 or 10 requires zero CRITICAL and at most
276 two MAJOR items.
277
278If any [inspection] check fails, mark the output as "needs user
279attention". For [attestation] bullets, the skill states the scope
280of its scan and the user confirms completeness.
281
282Run the gate silently. Do not print a per-gate pass or fail report;
283a failure surfaces as a concrete finding in the affected dimension,
284and the delivered review stays free of internal checking rituals.
285
286## Output format
287
288### Summary
289- CRITICAL: <n>
290- MAJOR: <m>
291- MINOR: <k>
292- Top three fixes first: ...
293
294### Dimension 1: Macro logic
295| # | Finding | Severity | Suggested fix |
296|---|---|---|---|
297| 1 | <quoted text> | CRITICAL or MAJOR or MINOR | <fix> |
298
299### Dimension 2: Writing details
300<same table shape>
301
302### Dimension 3: English grammar
303<same table shape, citing grammar-rule ID>
304
305### Dimension 4: LaTeX format
306<same table shape>
307
308### Dimension 5: Figure quality
309<same table shape>
310
311### Banned-vocabulary and em-dash scan
312<list with line references>
313
314### Final score (1-10)
315<score>
316
317### Submission recommendation
318- <Ready to submit | Needs 1-2 days more work | Needs major revision before submission>