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
- BrightGold70/skillstheir own version, first seen Nov 8, 2026
- Noam-Marom/academic-studentstheir own version, first seen Nov 8, 2026
- cjh-solver/MathModeling-Skills-Arsenaltheir own version, first seen Nov 8, 2026
- leolou0512/claude-skillstheir own version, first seen Oct 25, 2026
- hua695/MathModeling-Skills-Arsenaltheir own version, first seen Oct 25, 2026
- Erin-1919/claude-skillstheir own version, first seen Oct 20, 2026
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.
HaojaeSkillscipilot-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
Other versions26 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 26
- wentorai/Research-Claw★ 858same name
- ZimoLiao/scholaraio★ 585same name
- poemswe/co-researcher★ 135same name
- NatureBlueee/Nature-use-skills★ 39same name
- dariia-m/my_claude_skills★ 35same name
- TashanGKD/tashan-research-skills★ 19same name
- cjh-solver/MathModeling-Skills-Arsenal★ 14same name
- hua695/MathModeling-Skills-Arsenal★ 12same name
- XYD-GIS/paper-toolkits★ 12same name
- YuanZHAO321/Academic-Writing★ 9same name
16 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository41 other files it gives its agents.
- skills/web-asset-generator/CLAUDE.mdCLAUDE.md
- agent-os-childSkill
- agy-pSkill
- amazon-uk-scraperSkill
- artifact-variationsSkill
- audio-transcription-workflowSkill
- capture-dashboardSkill
- claude-channelsSkill
- claude-pSkill
- code-documenterSkill
- context7-docsSkill
- context7-searchSkill
- deep-researchSkill
- docx-draftSkill
- grill-meSkill
- handoffSkill
- long-horizon-waiting-strategiesSkill
- openapi-schemaSkill
- opencode-pluginSkill
- pi-extensionSkill
- pi-web-ui-internal-api-orchestrationSkill
- pptx-draftSkill
- saas-idea-finderSkill
- scraping-redditSkill
- scraping-twitterSkill
- secret-scanningSkill
- socialmedia-optimizationSkill
- systematic-debuggingSkill
- test-driven-developmentSkill
- text-to-speechSkill
- thematic-analysisSkill
- transcribe-audioSkill
- video-deep-understandingSkill
- video-useSkill
- web-asset-generatorSkill
- web-crawlingSkill
- web-create-assetsSkill
- web-data-acquisitionSkill
- webfetch-skillSkill
- youtube-captionSkill
- youtube-searchSkill
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
- Distinctive: line 17
Use active voice to clarify agency
- Distinctive: line 18
Avoid "waffle," jargon, and archaic formulations
- Distinctive: line 29
Standard British (-ise): - Default for most UK institutions (Cambridge, Gov.uk, most publishers):
- Distinctive: line 54
Use when omission causes ambiguity
- Distinctive: line 62
No contractions in formal writing: *do not* not *don't*, *cannot* not *can't*
- Distinctive: line 86
Use these to perform specific rhetorical moves:
- Distinctive: line 109
Variation: Use short, punchy sentences to punctuate longer explanatory ones
- Distinctive: line 147
Avoid absolute statements.
- Distinctive: line 160
Avoid "you" in research papers (can sound accusatory)
- Distinctive: line 199
Don't use quotation marks to distance from terms or imply irony unless analyzing the term itself.
- Distinctive: line 217
Voice: Write with active voice where possible, particularly in introductions and discussions
- Distinctive: line 218
Vocabulary: Avoid zombie nouns and archaisms.
“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.
Files
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.)
- Topic Sentence: Main point, links backward and forward
- Evidence/Elaboration: Supporting data, citations, analysis
- Critical Comment: Writer's interpretation
- Concluding/Transition: Summarizes and leads to next section
Signposting
Explicit logical connectors guide the reader:
| Function | Examples |
| Adding | Furthermore, In addition, Moreover |
| Contrasting | However, In contrast, On the other hand, Conversely |
| Sequencing | Turning now to, The following section will address |
| Concluding | Therefore, Thus, Consequently, In summary |
| Reintroducing | As 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
| Feature | British Academic | American Academic |
| Spelling | colour, centre, analyse, organise | color, center, analyze, organize |
| Dates | 25 September 2025 (no commas) | September 25, 2025 |
| Quotation Marks | Single (' ') main; Double (" ") nested | Double (" ") main; Single (' ') nested |
| Punctuation | Outside quotes (logical) | Inside quotes |
| Collective Nouns | Plural verb: "The team are winning" | Singular verb: "The team is winning" |
| Past Participles | learnt, burnt, dreamt | learned, burned, dreamed |
| Prepositions | different to, at the weekend | different than/from, on the weekend |
Summary Checklist
- Spelling: Select appropriate convention (typically standard British "-ise") and adhere rigidly
- Punctuation: Employ logical punctuation, placing marks outside quotes unless part of quoted matter
- Voice: Write with active voice where possible, particularly in introductions and discussions
- Vocabulary: Avoid zombie nouns and archaisms; use strong verbs and specific AWL vocabulary
- Structure: Signpost arguments explicitly to guide the reader
- Tone: Hedge assertions to reflect nuance of scholarly inquiry without sounding vague
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
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.

