
scientific-email-polishing
Composes and polishes professional scientific correspondence -- emails to collaborators, journal cover letters, and responses to peer reviewers -- ensuring clear communication, appropriate tone, explicit asks, and professional formatting for academic contexts. Use when writing or polishing scientific emails, cover letters to editors, reviewer responses, or when user mentions email to collaborator, cover letter to journal, reviewer response, or professional scientific correspondence.
- Installs
- 103
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/lyndonkl/claude --skill scientific-email-polishing- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads scientific-email-polishing automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Scientific Email Polishing
Table of Contents
Related skills for other document types:
- Recommendation letters:
academic-letter-architect - Research statements:
career-document-architect - Grant proposals:
grant-proposal-assistant
Core Principles
1. One email, one purpose: Each email should have a clear, single objective
2. Explicit asks: State exactly what you need from the recipient and by when
3. Context first: Open with enough context for the reader to understand immediately
4. Professional but warm: Formal doesn't mean cold; collegial is appropriate
5. Scannable format: Busy recipients skim; use structure to aid quick reading
Workflow
Copy this checklist and track your progress:
Email Polishing Progress:
- [ ] Step 1: Identify purpose and desired outcome
- [ ] Step 2: Draft subject line (clear, specific)
- [ ] Step 3: Write opening (context in first sentence)
- [ ] Step 4: Compose body (organized, scannable)
- [ ] Step 5: State explicit ask (what, by when)
- [ ] Step 6: Close professionally (next steps, sign-off)
- [ ] Step 7: Review tone (polite, appropriate)
Step 1: Identify Purpose and Outcome
What action do you want the recipient to take? What decision do you need? By when? If you can't state this clearly, the email isn't ready to send.
Step 2: Draft Subject Line
Subject should preview content and signal urgency/type. Be specific: "Meeting request: Collaboration on X project" not "Quick question". See resources/template.md for examples.
Step 3: Write Opening
First sentence should establish context. Who are you (if unknown), why are you writing, what's this about? No need for extensive pleasantries. See resources/template.md for openers.
Step 4: Compose Body
Organize information logically. Use short paragraphs. Consider bullets for multiple points. Bold key information if needed. Keep under 3-4 paragraphs for most emails.
Step 5: State Explicit Ask
Be clear about what you need. Include timeline if relevant. Make it easy to say yes. Don't bury the ask.
Step 6: Close Professionally
Thank them, indicate next steps, offer to provide more info. Use appropriate sign-off for relationship level. See resources/template.md for sign-offs.
Step 7: Review Tone
Read aloud. Is it polite but efficient? Not too casual, not too stiff? Appropriate for your relationship with recipient? Validate using resources/evaluators/rubric_email.json.
Email Types
Journal Cover Letter
Purpose: Introduce manuscript, explain significance, suggest reviewers
Structure:
Subject: Submission: [Manuscript Title] - [Type: Original Research/Review/etc.]
Dear Dr. [Editor] / Dear Editors,
[PARAGRAPH 1: What and why]
Please find attached our manuscript entitled "[Title]" for consideration
as a [Article Type] in [Journal Name]. This work [brief significance statement].
[PARAGRAPH 2: What's new]
Our study [key finding/contribution]. This advances the field by [impact].
We believe this work will interest readers of [Journal] because [fit with
journal scope].
[PARAGRAPH 3: Practicalities]
The manuscript is [X] words with [Y] figures. All authors have approved
the submission and there are no conflicts of interest to declare. This
work has not been published elsewhere and is not under consideration
at another journal.
[OPTIONAL: Reviewer suggestions]
We suggest the following potential reviewers: [Names with institutions
and emails].
[CLOSING]
Thank you for your consideration. We look forward to hearing from you.
Sincerely,
[Corresponding Author]
Response to Reviewers
Purpose: Address each point thoroughly and professionally
Structure:
Subject: Revised Manuscript [ID]: [Title]
Dear Dr. [Editor],
Thank you for the opportunity to revise our manuscript "[Title]". We
appreciate the thoughtful comments from the reviewers, which have
significantly improved our work. Below we provide point-by-point
responses to each comment. Reviewer comments are in italics, our
responses in plain text, and changes to the manuscript are noted.
---
REVIEWER 1
*Comment 1: [Quote reviewer comment]*
Response: [Your response]. We have [action taken]. This change appears
on page X, lines Y-Z.
*Comment 2: [Quote reviewer comment]*
Response: [Your response].
[Continue for all comments]
---
REVIEWER 2
[Same format]
---
We hope these revisions address the reviewers' concerns and that the
manuscript is now suitable for publication in [Journal]. Please do not
hesitate to contact us if additional revisions are needed.
Sincerely,
[Corresponding Author]
Collaboration Request
Purpose: Propose collaboration with new contact
Structure:
Subject: Collaboration opportunity: [Brief topic description]
Dear Dr. [Name],
I am [Your Name], a [position] at [Institution], working on [research area].
I am reaching out because [why them specifically - be genuine and specific].
[Brief background on your work and why collaboration makes sense]
I would be interested in [specific collaboration proposal]. This could involve
[what you're proposing - be concrete].
Would you be available for a brief call to discuss? I'm flexible on timing
and happy to work around your schedule.
Thank you for considering this. [Optional: note any mutual connection]
Best regards,
[Your Name]
Tone Guidelines
Formality Spectrum
| Recipient | Tone | Example Sign-off |
|---|---|---|
| Unknown editor/senior | Formal | "Sincerely," "Respectfully," |
| Known colleague (distant) | Professional-warm | "Best regards," "Best," |
| Known colleague (close) | Warm-professional | "Best," "Thanks," |
| Close collaborator | Friendly-professional | "Thanks," "Cheers," |
Professional but Not Stiff
Too stiff:
"I am writing to inquire as to whether you might be available to provide guidance regarding..."
Too casual:
"Hey! Quick q - you free to chat about that thing?"
Just right:
"I'm reaching out to see if you'd have time to discuss [topic]. Would a brief call work for you next week?"
Diplomatic Language
When declining:
- "Unfortunately, I won't be able to..."
- "While I appreciate the opportunity, my current commitments prevent..."
- "I'd recommend reaching out to [alternative] who might be better positioned..."
When disagreeing (reviewer response):
- "We respectfully disagree with this interpretation because..."
- "While we understand the reviewer's concern, our data suggests..."
- "We have added clarification to address this point, though we maintain that..."
When following up:
- "I wanted to follow up on my previous email..."
- "I'm circling back on [topic]..."
- "Apologies for the additional email, but I wanted to check..."
Guardrails
Key requirements:
- Clear purpose: Every email needs an identifiable goal
- Explicit asks: State what you need so recipients can act without guessing
- Professional tone: Appropriate for academic/scientific context
- Proofread: Errors undermine credibility
- Appropriate length: Respect recipients' time
- Complete information: Include everything needed to respond
Common pitfalls:
- ❌ Buried ask: Request hidden in paragraph 4
- ❌ No deadline: "When you get a chance" = never
- ❌ Wall of text: Long unbroken paragraphs
- ❌ Too casual: "Hey" to journal editor
- ❌ Too formal: Stilted language to close colleague
- ❌ Missing context: Assuming they remember previous exchange
- ❌ Multiple topics: Should be separate emails
Quick Reference
Key resources:
- resources/template.md: Subject lines, openings, closings, full templates
- resources/evaluators/rubric_email.json: Quality scoring
Subject line formulas:
- Request: "Meeting request: [Topic]"
- Follow-up: "Follow-up: [Original topic]"
- Submission: "Submission: [Title]"
- Response: "RE: [Topic] - [Your action]"
- Question: "Question about [Specific topic]"
Time estimates:
- Quick email: 5-10 minutes
- Cover letter: 15-30 minutes
- Response to reviewers: 1-4 hours (depending on revisions)
Before sending checklist:
- Purpose clear?
- Ask explicit?
- Context provided?
- Tone appropriate?
- Proofread?
- Attachments attached?
Inputs required:
- Purpose/desired outcome
- Recipient relationship
- Key information to convey
- Any constraints (deadline, politics)
Outputs produced:
- Polished email draft
- (Optional) Commentary on tone/structure
FAQ
What does the scientific-email-polishing skill do?
Composes and polishes professional scientific correspondence -- emails to collaborators, journal cover letters, and responses to peer reviewers -- ensuring clear communication, appropriate tone, explicit asks, and professional formatting for academic contexts. Use when writing or polishing scientific emails, cover letters to editors, reviewer responses, or when user mentions email to collaborator, cover letter to journal, reviewer response, or professional scientific correspondence.
How do I install scientific-email-polishing?
Run npx skills add https://github.com/lyndonkl/claude --skill scientific-email-polishing in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/scientific-email-polishing/ (personal) or .claude/skills/scientific-email-polishing/ (project).
Which AI agents can use scientific-email-polishing?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is scientific-email-polishing safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains scientific-email-polishing?
It is published by lyndonkl in lyndonkl/claude. It has 103 recorded installs.
More from lyndonkl/claude
evaluation-rubrics
lyndonkl/claude
Designs structured scoring tools with explicit criteria, performance scales, and descriptors for consistent, transparent quality assessment. Use when need quality criteria and scoring scales to evaluate work consistently, compare alternatives objectively, set acceptance thresholds, reduce subjective bias, or when user mentions rubric, scoring criteria, quality standards, evaluation framework, inter-rater reliability, or grading/assessing work.
strategy-and-competitive-analysis
lyndonkl/claude
Develops business strategies grounded in rigorous competitive and market analysis using proven frameworks (Good Strategy kernel, Porter's 5 Forces, SWOT, Blue Ocean, Playing to Win, Value Chain Analysis, BCG Matrix). Use when developing strategy (market entry, product launch, expansion, M&A, turnaround), conducting competitive analysis, making strategic decisions (build vs buy, pricing, positioning), planning strategic initiatives, or when user mentions strategy, competitive analysis, Porter's 5 Forces, SWOT, market positioning, or strategic frameworks.
scientific-manuscript-review
lyndonkl/claude
Guides systematic multi-pass review and editing of scientific manuscripts (research articles, reviews, perspectives) to improve clarity, structure, scientific rigor, and reader comprehension. Use when reviewing or editing research manuscripts, journal articles, or perspectives, when user mentions manuscript, paper draft, article, research writing, journal submission, reviewer feedback, or needs to improve scientific writing.
memory-retrieval-learning
lyndonkl/claude
Open the skill to read its SKILL.md instructions.
socratic-teaching-scaffolds
lyndonkl/claude
Guides learners to discover knowledge through strategic Socratic questioning and progressive scaffolding removal. Combines question ladders, misconception detectors, Feynman explanations, and worked-example fading to build durable understanding. Use when teaching complex concepts, correcting misconceptions, onboarding team members, mentoring problem-solving, or designing self-paced learning. Use when user mentions "teach me", "help me understand", "explain like I'm", "learning path", "guided discovery", or "Socratic method".
grant-proposal-assistant
lyndonkl/claude
Guides creation and review of competitive grant proposals (NIH R01/R21/K, NSF, foundations) by applying reviewer-perspective thinking to ensure clear hypotheses, compelling significance, genuine innovation, and feasible approaches. Use when writing or reviewing grant proposals, crafting specific aims, drafting significance/innovation/approach sections, or when user mentions R01, R21, K-series, grant writing, proposal review, study section, or fundable hypothesis.
Popular education & science skills
teach
mattpocock/skills
Teach the user a new skill or concept, within this workspace.
scaffold-exercises
mattpocock/skills
Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.
paper-context-resolver
lllllllama/rigorpilot-skills
Rigor Paper Context helper for README-first deep learning repo reproduction. Use only when the README and repository files leave a narrow reproduction-critical gap and the task is to resolve a specific paper detail such as dataset split, preprocessing, evaluation protocol, checkpoint mapping, or runtime assumption from primary paper sources while recording conflicts. Do not use for general paper summary, repo scanning, environment setup, command execution, title-only paper lookup, or replacing README guidance by default.
caveman-learn
juliusbrussee/caveman
Act on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and report what those fixes returned. Use when asked to lower an agent's token cost, what caveman has saved, to trim a heavy CLAUDE.md, or to offload re-pasted context into cavemem.
gsap-plugins
greensock/gsap-skills
Official GSAP skill for GSAP plugins — registration, ScrollToPlugin, ScrollSmoother, Flip, Draggable, Inertia, Observer, SplitText, ScrambleText, SVG and physics plugins, CustomEase, EasePack, CustomWiggle, CustomBounce, GSDevTools. Use when the user asks about a GSAP plugin, scroll-to, flip animations, draggable, SVG drawing, or plugin registration.
teach-impeccable
pbakaus/impeccable
DEPRECATED: Use /impeccable teach instead. This command has been folded into the impeccable skill.