Writing Style (aerj-writing-style)

SkillDev tools

Use when drafting or polishing the prose of an American Educational Research Journal (AERJ) manuscript. AERJ is read across the whole field, follows APA 7th-edition style, and expects a 100, 120-word abstract within a maximum 50-page manuscript. Improves clarity and compliance; it does not ghostwrite the paper.

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Writing Style (aerj-writing-style) skill

What this skill tells your AI

The instructions your AI receives, as published by brycewang-stanford/awesome-journal-skills in American-Educational-Research-Journal-Skills/skills/aerj-writing-style/SKILL.md and read by ahel’s review.

An AERJ paper must read for the whole field of education research, not just specialists, and must comply with APA 7th edition. Write so a researcher from another subfield follows the argument, the stakes, and the contribution. Verify the current length and abstract limits on the official page.

When to trigger

  • Drafting or tightening any section
  • Bringing the manuscript into APA 7th-edition compliance
  • Writing or trimming the 100–120-word abstract
  • Cutting to fit the length limit while protecting the argument

Style facts (verify volatile items on the official page)

  • Citation/reference style: APA 7th edition (author-date) throughout.
  • Abstract: 100–120 words — state purpose, design/method, key findings, significance.
  • Length: manuscript maximum 50 pages, double-spaced, 12-pt, 1" margins, inclusive of tables, figures, notes, and references.
  • Masked: no author-identifying language; self-citations neutralized (see aerj-submission).

How to write for the field

  1. Front-load the contribution. By the end of the introduction the reader knows the question, why it matters across the field, the approach, and the finding.
  2. Translate jargon. Define subfield-specific terms; spell out the stakes for policy and/or practice in plain language.
  3. One argument, signposted. Each section advances the through-line: framework → design → evidence → meaning. Use clear topic sentences.
  4. Claims matched to evidence. Hedge appropriately; state scope conditions and limitations honestly — over-claiming draws reviewer fire.
  5. Tight abstract. Within 100–120 words, get purpose, method, finding, and significance — no filler.
  6. APA discipline. Consistent author-date citation, reference list, heading levels, and number/stat formatting per APA 7th.

Anti-patterns

  • Burying the contribution after pages of setup
  • Insider jargon with no translation for a general education-research reader
  • Over-claiming beyond what the design supports; no scope conditions
  • An abstract over 120 words or padded with background
  • Inconsistent APA citations/headings; mixing reference styles

Prose expectations by manuscript section (AERJ referees)

A field-wide readership means every section must be legible to a non-specialist while staying APA-7 disciplined. Use this as a section-by-section prose audit.

Manuscript partWhat reads well for AERJ's general audienceReviewer-irritating tell
IntroductionQuestion, field-wide stake, approach, finding by page twoPages of background before the contribution
FrameworkConstructs defined in plain language, then operationalizedTheory jargon with no translation
MethodDesign legible to outsiders; nesting and warrant statedAcronyms assuming subfield fluency
ResultsEffect sizes and intervals narrated, not just starred"p < .05" prose with no practical meaning
DiscussionScope conditions and equity/context stated honestlyOver-claiming beyond the design

Worked abstract vignette (illustrative)

A draft abstract for an evaluation of a formative-assessment coaching program runs 168 words and opens with two sentences of literature. Trimmed to AERJ's 100–120-word target, it becomes: purpose (test whether coaching shifts instruction and learning), method (cluster-randomized across 48 schools, multilevel models), finding (an illustrative 0.16 SD gain, 95% CI [0.05, 0.27], concentrated in high-need schools), significance (informs how districts target instructional support equitably). The filler background is gone; every clause earns its place. Confirm the exact word limit against the journal's current submission guidelines.

Referee pushback and the venue fix

  • "This is hard to follow outside the subfield." → Translate each specialist term on first use; add the plain-language stake.
  • "The claims outrun the evidence." → Hedge to what the design supports and state scope conditions.
  • "Citations and headings are inconsistent." → Run a clean APA-7 author-date and heading pass before resubmission.

Output format

【Section reviewed】intro / framework / methods / results / discussion / abstract
【Contribution front-loaded?】[Y/N]
【Reads for the field?】jargon translated, stakes plain [Y/N]
【Abstract】word count (100–120)
【APA 7th compliant】citations + headings + stats [Y/N]
【Length】within limit (verify) [Y/N]
【Next】aerj-transparency-and-data-policy

Supplementary resources

Signals

GitHub stars
1k
Forks
155
Last commit
Sep 2026
Advanced
Item type
skill
Key
aerj-writing-style
Source
github.com/brycewang-stanford/awesome-journal-skills