Add Email Coach skill - #288
Open
Tony Brooks (Fab-Tony) wants to merge 2 commits into
Open
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Note
Copilot was unable to run its full agentic suite in this review.
Adds a new “Email Coach” submission, including metadata and a detailed skill spec, to support coaching users on rewriting emails with explanations and (optionally) creating Microsoft 365 Drafts safely.
Changes:
- Added
metadata.jsondescribing the Email Coach submission (name, platforms, tags, author, version, dates). - Added a comprehensive
SKILL.mddefining coaching modes, drafting rules, and Microsoft 365 Drafts constraints. - Added a
README.mdsummarizing the skill’s purpose, behavior, and setup expectations.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| submissions/email-coach/metadata.json | Introduces submission metadata used for cataloging and discovery. |
| submissions/email-coach/SKILL.md | Defines the skill behavior and detailed coaching/drafting rules (core of the submission). |
| submissions/email-coach/README.md | Provides user-facing overview and operational notes for the submission. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Author
|
@microsoft-github-policy-service agree company="FutureAbility Pty Ltd" |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds
submissions/email-coach/— a skill that coaches a draft email rather thanjust proofreading it: it returns a reader's-eye read-back, a redraft, and the
reasoning behind each change, so the writer improves over time.
Why this one. The
writingtag currently covers brand voice, style analysis,content quality, blog structure, LinkedIn and outreach — but nothing for the
single most common piece of business writing. This fills that gap.
What's in it
gets polished on top of a broken foundation.
email, explicit ask with a by-when, a single named owner to avoid diffusion of
responsibility, active voice, specific subject lines.
late reply, and chasing a thread that's being ignored.
You et al., Journal of Marketing 2020 on thank-you versus sorry).
Microsoft 365 integration. The redraft is always delivered in chat with the
coaching attached. If the official Microsoft 365 connector is present, the skill
then offers to create an Outlook draft under strict rules: recipient fields stay
empty so an accidental send is harmless, a bold AI-disclosure line sits above the
greeting that the user must delete, and it never sends. No other mail connector
is offered. Without the connector it falls back to a paste-safe copy block.
Shape.
SKILL.md+metadata.json+README.md. Fully self-contained — noscripts/,references/orassets/, so no download bundle is generated.Validation. Run locally against this repo at
main:npm run check:submissions— all submissions passnpm run import:submissions— generatessrc/content/skills/email-coach.mdnpm run build— 385 pages built, detail page renders the README correctlyThis is a fork PR, so CI runs validate-only and no generated files are committed
back to the branch.
src/content/skills/email-coach.mdis therefore not includedhere — happy to commit the generated page if you'd prefer it in the PR, otherwise
npm run import:submissionsafter merge will produce it.Provenance and licence. Adapted from FutureAbility's internal email coach,
generalised for public use. Contributed under the repository's MIT licence.