⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

format

godwit-email@godwit-email⭐ 128 stars· last commit 2d ago· 15 open issues

Structure the draft with clean paragraphs and lists without changing the wording

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐⭐⭐ 128 on GitHubGitHub ↗

Popular

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

https://github.com/user-attachments/assets/29ee980c-73a5-47f0-a736-b01828c22785

Godwit is a desktop email client for macOS, Windows and Linux. It works with any IMAP/SMTP account and ships with an AI assistant, Wit, that reads, summarizes, translates and drafts mail with the model you choose. Before anything goes to a cloud model, names, account numbers, phone numbers and keys are masked on your machine. Everything AI in it, the built-in features included, runs through the same extension points open to you: drop in a SKILL.md and a button appears.

The name comes from the bar-tailed godwit, which holds the record for the longest non-stop bird flight.

Features

  • Mail: IMAP/SMTP accounts with sync, offline changes, conversations, and HTML compose with reply, forward, CC/BCC, drafts and recipients completed from your contacts. Setup is detected for Gmail, Outlook (sign in with Microsoft), iCloud, Yahoo, AOL, QQ Mail, 163/126 Mail, Tencent Exmail, Lark/Feishu and DingTalk Mail, hosted corporate mail by its MX records, and any other IMAP server. Local .eml files can be imported into a local archive.
  • Views: questions that stay open in the sidebar, such as To handle, built from conditions and groups, across all your accounts. They never change the mail itself.
  • Sign-in codes and links: codes and magic links in 14 languages are recognized as they arrive, with a banner to copy or open them and a list of recent ones in the tray.
  • Organize: labels, set by the model or by hand and synced as IMAP keywords; local rules (when … if … then …) with condition groups; one-click unsubscribe (RFC 8058); and a Contacts page with unsubscribe, archive all and block per sender.
  • Search: ⌘K finds mail, conversations, contacts and attachments.
  • Wit: an agent that answers questions about your mail, reads attachments (PDF, Office, CSV) and drafts replies. It writes drafts and never sends. Anything that leaves your machine, such as an unsubscribe or an opened link, waits for your approval, which names where it goes.
  • Privacy masking: text bound for a cloud model or translation service is checked on your machine, with a local recognition model, for keys, ID and financial numbers, codes, phone numbers, email addresses, names, addresses and accounts. Each kind is masked (replaced by a placeholder and put back only on your side), warned about, or blocked, and every request is in the masking log.
  • Security: sender verification badges, display-name spoofing protection and AI fraud classification; remote images load through a privacy proxy.
  • AI actions: summarize, translate, adjust tone and length, and quick replies, on a message, a selection or a draft. On macOS 26 and later, mail can also be translated on the Mac with the system's own translation, free and without a model (Settings › Intelligence › Features › Translate with › System translation).
  • Your models: any OpenAI-compatible (Chat Completions or Responses) or Anthropic-compatible service, including local ones like Ollama and LM Studio. API keys stay in the system keychain.
  • Extensions:
    • Skills: a SKILL.md (Agent Skills) in the data directory's skills/ folder becomes a Wit skill, or an action button with godwit-action-* metadata.
    • Plugins: install from the plugin directory in Settings › Extensions, or write your own: TypeScript plugins with declared permissions add hooks, actions, cards and Wit tools. Types are in sdk/godwit.d.ts, published as @godwit/sdk (npm i -D @godwit/sdk). Plugins can read mail and write drafts; none can send.
    • Native plugins: a shared library behind a small C ABI (sdk/native/godwit_plugin.h), for what a sandbox cannot do. It runs with all of Godwit's rights, so Godwit shows the risk and asks you to allow that exact file; a changed file needs your permission again.
    • MCP servers: give Wit external tools. Each server is approved once, and each write call every time.
  • For other agents: godwit mcp is an MCP server that lets Claude, Claude Code, Codex, Cursor and any other MCP app read your mail and create drafts. Sending through MCP is your setting: by default each send waits for you to confirm it, and you can turn it off or let it send directly. Turn on the Local API under Settings › Intelligence › AI apps and copy the client configuration from there.
  • Updates itself from dl.godwit.email (the Microsoft Store version is updated by the Store).

Install

Download the latest build from godwit.email:

  • macOS: the .dmg, or with Homebrew:

    brew install godwit-email/tap/godwit
    
  • Windows: the installer, which installs for the current user without admin rights, or Godwit on the Microsoft Store, which the Store updates.

  • Linux: the .deb, or install for the current user (no root) with:

    curl -fsSL https://dl.godwit.email/install.sh | sh
    

Verify a download

Every release is built from its tag by release.yml, which signs build provenance for each file it uploads. Check that a download was built here, and from which commit, with the GitHub CLI:

gh attestation verify godwit-1.30.0-arm64.dmg --repo godwit-email/godwit

For the Microsoft Store version, verify Godwit.exe in its install folder (Get-AppxPackage BaranWang.Godwit shows where). The app also records its commit: go version -m on the executable prints it as vcs.revision.

Command line

godwit [--data-dir DIR]                                the desktop app
godwit --headless [--data-dir DIR]                     serve the Local API without a window
godwit call [--data-dir DIR] METHOD [JSON_ARGS_ARRAY]  call the running Godwit once
godwit mcp [--data-dir DIR]                            an MCP server on stdio for agents
godwit dev-sync-db                                    replace the dev database from production (development builds only)
godwit --version

Receive mail from login on Linux

On macOS and Windows, 后台收信 › 一直继续 starts Godwit's backend when you log in. Linux leaves that to you: run godwit --headless as a systemd user service, and the desktop app connects to it when you open it. Save this as ~/.config/systemd/user/godwit.service (adjust the path to godwit):

[Unit]
Description=Godwit backend
# After the desktop session has exported DISPLAY or WAYLAND_DISPLAY: the
# backend decides at start whether it can show notifications and a tray.
After=graphical-session.target
PartOf=graphical-session.target

[Service]
ExecStart=%h/.local/bin/godwit --headless
Restart=on-failure

[Install]
WantedBy=graphical-session.target
systemctl --user enable --now godwit

A backend you start this way keeps running when the app quits and always serves the Local API to other programs of your user.

Development

Godwit is written in Go on MyGo: the main window is native UI, while compose, the Wit page and the message reader are React pages in web/. mise installs the pinned Go and Bun:

mise install
mise run generate    # install web dependencies and generate Go/TypeScript code before Go tests
mise ru

// HOW IT'S BUILT

// FILES

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • core/skills/builtin/format/SKILL.md1.3 KBe6fa8339795aupstream ↗
    ---
    name: format
    description: Structure the draft with clean paragraphs and lists without changing the wording
    metadata:
      godwit-action-on: "draft,selection"
      godwit-action-output: "replace-draft"
    ---
    
    Structure the draft into clean, well-spaced paragraphs and lists for readability, while preserving all words, phrasing, spelling, and tone 100% verbatim:
    1. Greeting: Keep in its own paragraph (<p>...).
    2. Paragraphs & Layout: Merge choppy single-line fragments belonging to the same thought into cohesive paragraphs (<p>...). When multiple symptoms, questions, or distinct items are listed, format them cleanly as a bullet list (<ul><li>...</li></ul>) or distinct paragraphs.
    3. Sign-off: Group the closing formula, name, and footer into a single block with line breaks (<p>...<br>...<br>...</p>).
    4. Postscripts: Format each PS / P.S. as its own paragraph.
    5. Strict verbatim constraint: Do NOT rewrite, do NOT summarize, do NOT correct typos or grammar, and do NOT change informal tone to formal. Keep every single word verbatim.
    
    If a subject is provided in <subject>, keep the subject verbatim:
    <subject>Original Subject</subject>
    <body>Structured HTML body</body>
    
    If no subject was provided, return only the structured body as HTML.
    
    Do not add a signature, a greeting that was not there, quoted text, a preamble, explanations, or commentary.
    
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/godwit-email-godwit-core-skills-builtin-format.md

// REPO STATS

128 stars
15 open issues
Last commit: 2d ago