# email-to-issue

The email-to-issue Claude Code skill turns Outlook threads into GitHub issues or comments. It processes flagged mail or threads selected by subject.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 723 installs
- Author: clhbid
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/clhbid/agent-context/tree/HEAD/skills/email-to-issue/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/email-to-issue

## What it does

The skill gathers matching Outlook threads into one proposal table, then suggests a new GitHub issue or a comment on an open issue for each. It searches with several phrasings and waits for approval row by row; GitHub stays unchanged until approval. New issues go to `Backlog`.

After filing, the agent replies in each thread with the issue link, then asks separately which threads to unflag and archive. Replies go only to the signed-in user. For public repositories, email details are paraphrased without customer names, contact details or pricing. The setup needs a Microsoft 365 connector and the `gh`, `issue-tracker` and `sending-emails-with-outlook` tools. Without mail-writing tools, the user handles the final mail actions manually.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill email-to-issue -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/email-to-issue/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/email-to-issue/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill email-to-issue -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/email-to-issue/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill email-to-issue -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/email-to-issue/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install clhbid/agent-context skills/email-to-issue
```

2. **Manually: put the files in place**
- File: `.github/skills/email-to-issue/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill email-to-issue -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/clhbid/agent-context --path skills/email-to-issue
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/email-to-issue/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill email-to-issue -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/clhbid/agent-context/tree/HEAD/skills/email-to-issue/SKILL.md

## When to use it
- create a GitHub issue from a flagged Outlook thread
- add an email update to an existing open issue
- link a thread to its issue with a reply
- review several email-to-issue proposals before filing

## Example prompts
- Run `/email-to-issue` on my flagged Outlook threads and propose an action for each.
- Process the Outlook threads with subject “Export failure” and suggest issues or comments.
- Turn these Outlook messages into GitHub issues, showing me the proposal table first.

## Similar
- [oss-issue-triage](https://affpapa.org/en/nevibecode/skills/oss-issue-triage.md) — skill · 13400 installs
- [antfu-issue-triage](https://affpapa.org/en/nevibecode/skills/antfu-issue-triage.md) — skill · 413 installs
- [issue-label](https://affpapa.org/en/nevibecode/skills/issue-label.md) — skill · 206 installs
- [outlook-email](https://affpapa.org/en/nevibecode/plugins/outlook-email.md) — plugin · ★ 8052 repo stars
- [fix-issue](https://affpapa.org/en/nevibecode/skills/fix-issue.md) — skill · ★ 353 repo stars
- [email-mcp](https://affpapa.org/en/nevibecode/mcp/marlinjai-email-mcp.md) — MCP server · ★ 26 repo stars

From the same set: [clhbid/agent-context](https://affpapa.org/en/nevibecode/by/clhbid/agent-context.md) — 8 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
