agentleFS
valtterimelkkovaltterimelkko/agent-workflow-skills/skills/academic-writing/SKILL.md

academic-writing

Skill2 starsChanged 45 days agoMITView on GitHub

Comprehensive guide for British academic writing best practices. Use when helping users write academic papers, research articles, theses, or formal essays in British English for UK higher education. Covers orthography (-ise/-ize conventions), punctuation (logical punctuation, quotation marks), vocabulary (AWL, hedging, avoiding zombie nouns), syntax (active vs passive voice, sentence structure), tone (formality vs readability), and disciplinary variations (STEM, Humanities, Social Sciences).

26 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use scipilot-figure-skill.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • HaojaeSkill

    scipilot-figure-skill

    SciPilot Skills 家族成员,负责科研数据可视化——但定位不是"画图工具", 而是"可视化顾问"。先做数据剖析(列类型/样本量/分布/异常值/分组结构/相关性), 再结合用户的论证目标推荐图型,主动拦截科研画图的经典错误(小样本画均值柱掩盖 分布、双 Y 轴、饼图、Y 轴不当截断、rainbow 色图、把分类点连成折线等),最后 产出 Nature / Science / IEEE / Elsevier / PNAS / 中文核心期刊级别的成图。 覆盖纯数据图:折线、柱状、散点、箱线 / 小提琴、热力图、误差棒、分布图(直方 图 / KDE)、相关性矩阵 / 散点矩阵、多面板组合。技术栈 matplotlib + seaborn + SciencePlots(静态)+ plotly(交互)。中英文双语,中文模式自动配置 Noto Sans CJK / Source Han Sans / SimHei 并修复负号方框,支持中文期刊"宋体正文 + Times New Roman 数字"混排。默认色盲安全配色 + 冗余编码 + 灰度预览。出图后做 "视觉自检闭环":渲染 PNG 预览→程序自检缺字/文字裁切/刻度重叠→AI 读图复核遮盖 与子图对齐→回改重渲,直到通过。 当用户的任务涉及以下任何情况时主动触发:论文配图、科研画图、数据可视化、 不知道用什么图、怎么展示数据、用什么图好、期刊投稿图、figure、出版级图表、 matplotlib、seaborn、plotly、误差棒、显著性标注、色盲安全配色、矢量图导出、 中文论文图表、多面板。**即使用户只是给一批数据问"这个怎么画"或"用什么图 好",也应使用本技能——本技能首要能力是"判断该用什么图",其次才是绘制。** 不做示意图、流程图、架构图。

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

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

  • 0

    Common

    Most of the 18 edited versions we read keep these.

  • 12

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use active voice to clarify agency

    line 17
  2. Distinctive:

    Avoid "waffle," jargon, and archaic formulations

    line 18
  3. Distinctive:

    Standard British (-ise): - Default for most UK institutions (Cambridge, Gov.uk, most publishers):

    line 29
  4. Distinctive:

    Use when omission causes ambiguity

    line 54
  5. Distinctive:

    No contractions in formal writing: *do not* not *don't*, *cannot* not *can't*

    line 62
  6. Distinctive:

    Use these to perform specific rhetorical moves:

    line 86
  7. Distinctive:

    Variation: Use short, punchy sentences to punctuate longer explanatory ones

    line 109
  8. Distinctive:

    Avoid absolute statements.

    line 147
  9. Distinctive:

    Avoid "you" in research papers (can sound accusatory)

    line 160
  10. Distinctive:

    Don't use quotation marks to distance from terms or imply irony unless analyzing the term itself.

    line 199
  11. Distinctive:

    Voice: Write with active voice where possible, particularly in introductions and discussions

    line 217
  12. Distinctive:

    Vocabulary: Avoid zombie nouns and archaisms.

    line 218

“Common” is measured: kept by at least 6 in 10 of the 18 edited versions of this file we could read. “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

British Academic Writing Best Practices

A comprehensive guide to writing academic papers, research articles, and formal essays in British English for UK higher education.

Core Principles

Readable Rigour

Modern British academic writing prioritizes clarity over complexity. Complexity of thought does not require complexity of expression.

  • Aim for average sentence length of 15-20 words
  • Use active voice to clarify agency
  • Avoid "waffle," jargon, and archaic formulations
  • The cognitive load should be spent on understanding concepts, not decoding syntax

British vs American English

British academic prose often favours a more measured, tentative tone ("hedging") compared to the more direct American style.

Orthography and Mechanics

Spelling Conventions

Standard British (-ise) - Default for most UK institutions (Cambridge, Gov.uk, most publishers):

  • organise, realise, recognise, analyse, paralyse
  • colour, labour, behaviour
  • centre, theatre, metre
  • labelled, travelled
  • defence, licence (noun)

Oxford Spelling (-ize) - Used by Oxford University Press:

  • organize, realize, recognize (Greek -izo roots)
  • analyse, paralyse (retain -ise, not from Greek -izo)
  • Same as Standard British for other conventions

Critical: Maintain consistency. Never mix organize and realised in the same document.

Punctuation

Quotation Marks:

  • Primary: Single quotes (' ')
  • Nested: Double quotes (" ")
  • Logical punctuation: Place punctuation outside quotes unless part of original source
    • British: The author described the findings as 'statistically robust'.
    • American: The author described the findings as "statistically robust."

Serial (Oxford) Comma:

  • Less obligatory in standard British English
  • Use when omission causes ambiguity
  • OUP mandates it; Cambridge often omits

Hyphenation: British English tends to hyphenate more than American:

  • co-worker, re-enter, multi-disciplinary (UK) vs coworker, reenter, multidisciplinary (US)

Abbreviations

  • No contractions in formal writing: do not not don't, cannot not can't
  • Omit full stop when abbreviation ends with same letter as full word:
    • Dr (UK) vs Dr. (US)
    • Mr (UK) vs Mr. (US)
    • Prof. retains stop in both (truncates the word)

Vocabulary and Lexical Precision

Distinctive British Academic Vocabulary

  • Whilst vs While: Whilst often used for concessive meaning (although/whereas)
  • Amongst vs Among: Amongst perceived as slightly more formal in British contexts
  • Staff (UK collective noun, often plural: "The staff are...") vs Faculty (US)
  • Module (UK unit of study) vs Course/Class (US)
  • Marking (UK) vs Grading (US)
  • Dissertation (UK undergraduate/masters) vs Thesis (UK PhD)

Academic Word List (AWL)

High-frequency academic words account for 13-14% of dissertation abstracts:

Verbs: analyse, assess, evaluate, interpret, indicate, demonstrate, establish Nouns: perspective, methodology, context, implication, evidence, significance, framework

Use these to perform specific rhetorical moves:

  • suggest for hedged claims: "The data suggest..."
  • demonstrate for stronger evidence: "The results demonstrate..."

Avoid Zombie Nouns (Nominalisation)

Poor: "The implementation of the investigation into the reduction of costs was successful." Improved: "The team investigated how to reduce costs and successfully implemented the findings."

Return agency to the sentence. Use base verbs unless noun form serves specific cohesive function.

Jargon vs Technical Terms

  • Technical terms: Required precision (mitochondria, hegemony, heteroscedasticity)
  • Jargon: Vague buzzwords (leverage, synergize, blue-sky thinking) - cut ruthlessly
  • Archaic clutter: aforementioned, herein, theretofore - actively discouraged

Syntactic Architecture

Sentence Structure

  • Ideal length: 15-20 words average
  • Comprehension drops: Below 10% for sentences over 43 words
  • Variation: Use short, punchy sentences to punctuate longer explanatory ones
  • Subordination: Tolerated but avoid unnecessary complexity

Active vs Passive Voice

Active voice increasingly preferred, especially in Introductions, Discussions, Conclusions:

  • "We demonstrate that..."
  • "This study proposes..."

Passive voice still useful:

  • Methodology sections (actor irrelevant): "The samples were heated to 100°C"
  • Focusing on object/process rather than researcher

Paragraph Organization (T.E.E.L. / P.E.E.)

  1. Topic Sentence: Main point, links backward and forward
  2. Evidence/Elaboration: Supporting data, citations, analysis
  3. Critical Comment: Writer's interpretation
  4. Concluding/Transition: Summarizes and leads to next section

Signposting

Explicit logical connectors guide the reader:

FunctionExamples
AddingFurthermore, In addition, Moreover
ContrastingHowever, In contrast, On the other hand, Conversely
SequencingTurning now to, The following section will address
ConcludingTherefore, Thus, Consequently, In summary
ReintroducingAs discussed above, Returning to the issue of...

See Manchester Academic Phrasebank for comprehensive examples.

Tone and Voice

Hedging and Caution

Avoid absolute statements. Use modal verbs and qualifying adverbs:

Too Strong: "This proves that X causes Y." Academic Tone: "These findings suggest that X may be a contributing factor to Y."

Common Hedges: appear to, likely, seem, tend to, arguably, possibly, could be attributed to

Formality Guidelines

Avoid: cool, stuff, a lot of, sort of, get (understand/obtain), besides Use: significant, material, substantial, somewhat, acquire, comprehend, furthermore

Direct Address:

  • Avoid "you" in research papers (can sound accusatory)
  • "We" acceptable for research team or guiding reader through proofs

Disciplinary Variations

STEM (Science, Technology, Engineering, Medicine)

  • Voice: Increasingly active ("We measured"), passive in methods
  • Structure: Rigid IMRaD (Introduction, Methods, Results, Discussion)
  • Paragraphs: Shorter, data-heavy
  • Vocabulary: High technical density, low connective vocabulary

Humanities (History, Literature, Philosophy)

  • Voice: More personal, interpretive. "I" used to stake claims ("I argue that...")
  • Structure: Flexible, thematic or chronological
  • Paragraphs: Longer, more discursive
  • Vocabulary: Richer, more varied. Metaphor and analogy permissible

Social Sciences (Sociology, Psychology, Education)

  • Voice: Middle ground. Active for researchers, passive for participants
  • Structure: Hybrid IMRaD or thematic
  • Vocabulary: High jargon risk (intertextuality, performativity) - define on first use

What to Avoid

Academic High Style (Archaisms)

herein, heretofore, thereby, aforementioned - viewed as clutter/pretentious

Correction: "The aforementioned study" → "This study" or "Smith's study"

Nominalisation Overload

Avoid: "The expectation of the committee was that..." Preferred: "The committee expected that..."

Padding and Redundancy

  • "It is interesting to note that..." → Just state the fact
  • "In order to..." → "To"
  • "For the purpose of..." → "For"

Scare Quotes

Don't use quotation marks to distance from terms or imply irony unless analyzing the term itself.

Quick Reference: British vs American Conventions

FeatureBritish AcademicAmerican Academic
Spellingcolour, centre, analyse, organisecolor, center, analyze, organize
Dates25 September 2025 (no commas)September 25, 2025
Quotation MarksSingle (' ') main; Double (" ") nestedDouble (" ") main; Single (' ') nested
PunctuationOutside quotes (logical)Inside quotes
Collective NounsPlural verb: "The team are winning"Singular verb: "The team is winning"
Past Participleslearnt, burnt, dreamtlearned, burned, dreamed
Prepositionsdifferent to, at the weekenddifferent than/from, on the weekend

Summary Checklist

  1. Spelling: Select appropriate convention (typically standard British "-ise") and adhere rigidly
  2. Punctuation: Employ logical punctuation, placing marks outside quotes unless part of quoted matter
  3. Voice: Write with active voice where possible, particularly in introductions and discussions
  4. Vocabulary: Avoid zombie nouns and archaisms; use strong verbs and specific AWL vocabulary
  5. Structure: Signpost arguments explicitly to guide the reader
  6. Tone: Hedge assertions to reflect nuance of scholarly inquiry without sounding vague

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.