MCPInstall

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
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads scientific-email-polishing automatically when relevant.

  3. 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

RecipientToneExample Sign-off
Unknown editor/seniorFormal"Sincerely," "Respectfully,"
Known colleague (distant)Professional-warm"Best regards," "Best,"
Known colleague (close)Warm-professional"Best," "Thanks,"
Close collaboratorFriendly-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:

  1. Clear purpose: Every email needs an identifiable goal
  2. Explicit asks: State what you need so recipients can act without guessing
  3. Professional tone: Appropriate for academic/scientific context
  4. Proofread: Errors undermine credibility
  5. Appropriate length: Respect recipients' time
  6. 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

View all →

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.

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.

Business & Finance491 installs

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.

Open the skill to read its SKILL.md instructions.

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".

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

View category →

teach

mattpocock/skills

Teach the user a new skill or concept, within this workspace.

Education & Science874K installs

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.

Education & Science488.2K installs

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.

Education & Science478.3K installs

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.

Education & Science107.9K installs

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.

Education & Science67.9K installs

teach-impeccable

pbakaus/impeccable

DEPRECATED: Use /impeccable teach instead. This command has been folded into the impeccable skill.