AGENT SKILL

email-voice-profile

Build (or refresh) a voice profile of how the user writes email, from their own sent Gmail. The profile is what email-draft-in-voice consumes to ghostwrite email that sounds like them.

License 许可
MIT
所属仓库
yc-software/qm
最近更新
2026-11-15
Stars
★ 1.6w
Forks
2.0k

01 前言 Front Matter

name
email-voice-profile
description
Build (or refresh) a voice profile of how the user writes email, from their own sent Gmail. The profile is what email-draft-in-voice consumes to ghostwrite email that sounds like them.

02 资源文件 1

03 SKILL.md 正文

Email voice profile

Use this when the user asks you to learn how they write email — "learn my voice", "build my email voice profile", "study my sent mail so you can draft for me" — or when email-draft-in-voice needs a profile that doesn't exist yet.

Personal DMs only. Sent mail is private; refuse to run this from a channel or group and offer to continue in the user's DM. The profile you produce is published to their personal Files, so only their own conversations and their own Inbox drafting can read it.

0. Check Files first

Computers are replaced without notice, so nothing durable lives on one. Before building, search memory for "email voice profile" and GET $AGENT_API_URL/v1/files?q=email-voice-profile (header x-agent-capability: $AGENT_API_TOKEN). An existing profile is refreshed, not rebuilt blind: download it with GET $AGENT_API_URL/v1/files/<id>/content and carry its validated hard rules forward unless the new corpus contradicts them.

1. Pull the corpus

Use the selected email access skill to retrieve up to 300 of the user's sent messages. Strip quoted replies and ---delimited signatures, drop automated and trivial messages, and write one JSON line per email to voice/corpus/corpus.jsonl, tagged internal or external by recipient domain. Record corpus stats; if fewer than ~50 usable emails survive, tell the user the profile will be rough and ask whether to continue.

2. Study it

Read a deliberate spread, not just the top of the file: oldest and newest, internal and external, one-liners and long emails. You are looking for what is distinctive — patterns a generic professional emailer would not share.

Watch for a signature block: only ---delimited signatures are stripped, so a plain signature (name / title / phone) survives at the end of many bodies. Treat a verbatim recurring trailing block as the mail client's signature, not a chosen sign-off — note it in the profile so drafts never include it (Gmail appends it on send).

3. Write the profile

Write email-voice-profile.md (that exact name; the Inbox drafting loop looks it up by name) with exactly these sections, every claim backed by observed frequency ("uses 'Best,' in 80% of external mail"), with 2–3 verbatim example lines each:

  • Register map — how tone shifts by audience (internal vs external, familiar vs cold), and how their length tracks the situation.
  • Openers & sign-offs — actual greetings and closings with rough frequencies, including when they use none.
  • Rhythm — sentence length, paragraph shape, how they open and end a body, use of fragments, lists, links.
  • Vocabulary & phrases — recurring words, pet phrases, how they hedge, how they say yes and no.
  • Punctuation & formatting quirks — dashes, ellipses, casing, emoji, bolding.
  • Hard rules — things true of nearly every email ("never opens with 'I hope this finds you well'", "always lowercase to teammates").
  • Anti-patterns — what they never do, plus the generic-AI tells to avoid (enthusiastic adjectives, "I'd be happy to", bullet-point answers to plain questions).

4. Validate before declaring done

Hold out 3 real threads the profile wasn't built from. For each, draft the user's reply using only the profile, then compare with what they actually sent. Where the real email diverges, tighten the profile — usually a missing hard rule or register distinction. Record validated: <date> at the top of the profile once the drafts read as plausibly theirs.

Show the user the finished profile and ask what feels wrong; their corrections go in as hard rules.

5. Publish it

Upload the finished file to Files: curl -fsS "$AGENT_API_URL/v1/files/upload-client" -H "x-agent-capability: $AGENT_API_TOKEN" -o /tmp/qm-upload.py && python3 /tmp/qm-upload.py email-voice-profile.md, then record one memory fact: "Email voice profile is Files <id> (built <date>)". The Inbox drafting loop reads the newest email-voice-profile.md in the user's Files on every pass, so publishing is what makes drafts sound like them. The corpus stays on the computer; only the profile is durable. Re-run this skill any time they want it refreshed — publish the new version and update the memory fact.

04 同仓库更多 Skills

yc-software
yc-software/qm

zoom

Find, create, reschedule, and cancel the user's Zoom meetings through their own Zoom connection.

★ 1.6w
yc-software
yc-software/qm

use-shared-credential

When you need to call a service the org has a SHARED credential for (a SERP/search key, a paid-API key, a data-vendor feed, a Git remote) — and the platform has told you that credential is available to this conversation — make the call BY PROXY through the credential broker. You never see the secret; the core stamps it onto the outbound request for you.

★ 1.6w
yc-software
yc-software/qm

ui-state

See what the person is looking at in the QM web UI right now — the whole page (sidebar, every multiview pane, open dialogs) as raw HTML, the app's state as JSON, optionally the CSS and a screenshot. Use when they ask about something on their screen, want help with the UI, or you need to check what a canvas you wrote actually rendered.

★ 1.6w
yc-software
yc-software/qm

ui-canvas

Draw your own HTML/CSS/JS as a full-window overlay on top of the QM web UI — a dashboard, a form, a visualization, controls that message you back. Write, update, replace, pin or dismiss it. Use when an interactive or visual result beats a chat reply.

★ 1.6w
yc-software
yc-software/qm

taste-skill

Design taste and process for anything a person will look at in a browser — landing page, dashboard, prototype, deck. The default design driver for a browsable artifact, with an anti-slop playbook for the visual language.

★ 1.6w
yc-software
yc-software/qm

slack-drafts

Create Slack message drafts in the user's own composer, as the user, through their per-user Slack OAuth. Drafting only — the user reviews and sends from Slack.

★ 1.6w