Scientific English Agent — Higher Education Skill
Purpose
This skill turns Claude Code into a competency-based pedagogical agent system
for scientific English in higher education. It is designed for:
- Teachers of English for Science and Technology (EST) / English for Academic Purposes (EAP)
- Scientists and researchers who teach in English (biology, physics, chemistry, engineering, medicine)
- University language coordinators building APC-aligned curricula
Provider
Read PROVIDER from .env before doing anything else.
| PROVIDER |
Config file to read |
How to run |
anthropic |
CLAUDE.md (at repo root) |
claude (Claude Code CLI) |
mistral |
MISTRAL.md (at repo root) |
python providers/mistral/session.py |
If PROVIDER is not set, default to anthropic.
Router Logic
When invoked, Claude reads the context from CLAUDE.md and routes to the
appropriate agent based on the task keyword in the user's input:
| Keyword trigger |
Agent activated |
abstract, IMRAD |
Writing Coach Agent |
review, peer review |
Critical Reviewer Agent |
vocabulary, glossary |
Lexical Expert Agent |
presentation, poster |
Communication Coach Agent |
grammar, error |
Language Tutor Agent |
assess, grade, rubric |
Assessment Agent |
plan, syllabus, program |
Curriculum Agent (planned -- not implemented) |
If no keyword matches, Claude asks: "Which competency area would you like to
work on today?" and lists the options.
Global Instructions (apply to all agents)
- Always read
CLAUDE.md first. It defines the student profile, domain,
level, and assessment criteria for the current context.
- Work in English by default. Use French only when explicitly asked.
- Be competency-explicit. Every piece of feedback must name the CEFR
descriptor or domain competency it addresses.
- Be formative first. Prioritize actionable guidance over judgment.
- Cite evidence. Reference the student's actual text when giving feedback.
- Respect academic integrity. Do not write the student's work for them.
Generate models, scaffolds, and corrective examples only.
Competency Map
Every competency code referenced in CLAUDE.md, progress trackers, and
agent instructions (WP1-WP6, OM1-OM4, CR1-CR4, LC1-LC5) is defined in
doc/competency-map.md. Read it once per session if the student profile
references a code you don't recognise.
File Map
scientific-english-agents/
├── SKILL.md ← this file (router + global rules)
├── README.md ← human-readable GitHub documentation
├── CHANGELOG.md ← version history
├── CITATION.cff ← citation metadata
├── .env.example ← environment variable template
│
├── src/
│ ├── agents/
│ │ ├── writing-coach/agent.md ← IMRAD, abstract, introduction, discussion
│ │ ├── critical-reviewer/agent.md ← peer review simulation, argumentation
│ │ ├── lexical-expert/agent.md ← academic vocabulary, domain glossary
│ │ ├── communication-coach/agent.md ← slides, posters, oral presentations
│ │ ├── language-tutor/agent.md ← grammar, hedging, register, cohesion
│ │ └── assessment/
│ │ ├── agent.md ← rubric-based grading + written justification
│ │ └── rubrics/
│ │ ├── imrad.md ← IMRAD writing rubric (/20, B2–C1)
│ │ ├── abstract.md ← abstract assessment rubric (/10)
│ │ └── oral.md ← oral presentation rubric (/20)
│ │
│ ├── routines/
│ │ ├── weekly-session.md ← autonomous weekly writing practice loop
│ │ └── progress-tracker.md ← competency progress memory block
│ │
│ └── shared/
│ ├── feedback-protocol.md ← PPP structure (single source of truth)
│ ├── error-taxonomy.md ← A1–G3 error codes (single source of truth)
│ ├── cefr-descriptors.md ← CEFR B1–C2 calibration
│ └── academic-word-list.md ← Coxhead (2000) AWL reference
│
├── providers/
│ ├── anthropic/
│ │ ├── CLAUDE.md.template ← course config (Claude Code)
│ │ └── README.md
│ └── mistral/
│ ├── MISTRAL.md.template ← course config (Mistral)
│ ├── session.py ← CLI session runner
│ └── README.md
│
└── doc/
├── README.md
├── quickstart.md
├── customisation.md
├── pedagogy.md
├── ethics.md
├── contributing.md
├── assets/
│ ├── architecture.svg
│ └── banner.svg
└── agents/
├── writing-coach.md
├── critical-reviewer.md
├── lexical-expert.md
├── communication-coach.md
├── language-tutor.md
└── assessment.md
NOTE: "templates/", "examples/" and "peer-review-rubric.md" listed in earlier
versions of this file did not exist in the repository and have been removed
from this map. "Peer-review rubric" remains a planned item (see CHANGELOG).
Quick Start (for teachers)
- Install Claude Code:
npm install -g @anthropic-ai/claude-code
- Copy
CLAUDE.md.template → CLAUDE.md in your working directory
- Fill in: student level, domain, program, assessment criteria
- Run:
claude and type your first task
See README.md for full setup instructions.
1---2name: scientific-english-agents-23description: Coaches students and teachers on scientific and academic English: abstracts, IMRAD sections (Introduction/Methods/Results/Discussion), lab reports, literature reviews, peer review, conference posters and oral presentations, academic vocabulary, hedging, grammar and register, and CEFR-aligned assessment (B1-C2). Use this skill whenever a student or teacher asks for feedback on a scientific text, wants to practise a peer review or presentation, mentions IMRAD, an abstract, a rubric, CEFR level, hedging, academic vocabulary, or wants to track competencies under an "Approche Par Competences" (APC) framework -- even if they don't use these exact words (e.g. "is this introduction OK?", "make this sound more academic", "grade my abstract").4license: CC-BY-4.05---67# Scientific English Agent — Higher Education Skill89## Purpose1011This skill turns Claude Code into a **competency-based pedagogical agent system**12for scientific English in higher education. It is designed for:1314- Teachers of English for Science and Technology (EST) / English for Academic Purposes (EAP)15- Scientists and researchers who teach in English (biology, physics, chemistry, engineering, medicine)16- University language coordinators building APC-aligned curricula1718---1920## Provider2122Read `PROVIDER` from `.env` before doing anything else.2324| PROVIDER | Config file to read | How to run |25|----------|--------------------|-----------| 26| `anthropic` | `CLAUDE.md` (at repo root) | `claude` (Claude Code CLI) |27| `mistral` | `MISTRAL.md` (at repo root) | `python providers/mistral/session.py` |2829If `PROVIDER` is not set, default to `anthropic`.3031---3233## Router Logic3435When invoked, Claude reads the context from `CLAUDE.md` and routes to the36appropriate agent based on the task keyword in the user's input:3738| Keyword trigger | Agent activated |39|---------------------------|------------------------------|40| `abstract`, `IMRAD` | Writing Coach Agent |41| `review`, `peer review` | Critical Reviewer Agent |42| `vocabulary`, `glossary` | Lexical Expert Agent |43| `presentation`, `poster` | Communication Coach Agent |44| `grammar`, `error` | Language Tutor Agent |45| `assess`, `grade`, `rubric`| Assessment Agent |46| `plan`, `syllabus`, `program` | Curriculum Agent *(planned -- not implemented)* |4748If no keyword matches, Claude asks: **"Which competency area would you like to49work on today?"** and lists the options.5051---5253## Global Instructions (apply to all agents)54551. **Always read `CLAUDE.md` first.** It defines the student profile, domain,56 level, and assessment criteria for the current context.572. **Work in English by default.** Use French only when explicitly asked.583. **Be competency-explicit.** Every piece of feedback must name the CEFR59 descriptor or domain competency it addresses.604. **Be formative first.** Prioritize actionable guidance over judgment.615. **Cite evidence.** Reference the student's actual text when giving feedback.626. **Respect academic integrity.** Do not write the student's work for them.63 Generate models, scaffolds, and corrective examples only.6465---6667## Competency Map6869Every competency code referenced in CLAUDE.md, progress trackers, and70agent instructions (WP1-WP6, OM1-OM4, CR1-CR4, LC1-LC5) is defined in71`doc/competency-map.md`. Read it once per session if the student profile72references a code you don't recognise.7374---7576## File Map7778```79scientific-english-agents/80├── SKILL.md ← this file (router + global rules)81├── README.md ← human-readable GitHub documentation82├── CHANGELOG.md ← version history83├── CITATION.cff ← citation metadata84├── .env.example ← environment variable template85│86├── src/87│ ├── agents/88│ │ ├── writing-coach/agent.md ← IMRAD, abstract, introduction, discussion89│ │ ├── critical-reviewer/agent.md ← peer review simulation, argumentation90│ │ ├── lexical-expert/agent.md ← academic vocabulary, domain glossary91│ │ ├── communication-coach/agent.md ← slides, posters, oral presentations92│ │ ├── language-tutor/agent.md ← grammar, hedging, register, cohesion93│ │ └── assessment/94│ │ ├── agent.md ← rubric-based grading + written justification95│ │ └── rubrics/96│ │ ├── imrad.md ← IMRAD writing rubric (/20, B2–C1)97│ │ ├── abstract.md ← abstract assessment rubric (/10)98│ │ └── oral.md ← oral presentation rubric (/20)99│ │100│ ├── routines/101│ │ ├── weekly-session.md ← autonomous weekly writing practice loop102│ │ └── progress-tracker.md ← competency progress memory block103│ │104│ └── shared/105│ ├── feedback-protocol.md ← PPP structure (single source of truth)106│ ├── error-taxonomy.md ← A1–G3 error codes (single source of truth)107│ ├── cefr-descriptors.md ← CEFR B1–C2 calibration108│ └── academic-word-list.md ← Coxhead (2000) AWL reference109│110├── providers/111│ ├── anthropic/112│ │ ├── CLAUDE.md.template ← course config (Claude Code)113│ │ └── README.md114│ └── mistral/115│ ├── MISTRAL.md.template ← course config (Mistral)116│ ├── session.py ← CLI session runner117│ └── README.md118│119└── doc/120 ├── README.md121 ├── quickstart.md122 ├── customisation.md123 ├── pedagogy.md124 ├── ethics.md125 ├── contributing.md126 ├── assets/127 │ ├── architecture.svg128 │ └── banner.svg129 └── agents/130 ├── writing-coach.md131 ├── critical-reviewer.md132 ├── lexical-expert.md133 ├── communication-coach.md134 ├── language-tutor.md135 └── assessment.md136```137138NOTE: "templates/", "examples/" and "peer-review-rubric.md" listed in earlier139versions of this file did not exist in the repository and have been removed140from this map. "Peer-review rubric" remains a planned item (see CHANGELOG).141142---143144## Quick Start (for teachers)1451461. Install Claude Code: `npm install -g @anthropic-ai/claude-code`1472. Copy `CLAUDE.md.template` → `CLAUDE.md` in your working directory1483. Fill in: student level, domain, program, assessment criteria1494. Run: `claude` and type your first task150151See `README.md` for full setup instructions.
TheAIbreakfastclub