| name | clip-thread |
| description | Capture a chat or email thread from connected MCP tools into ARIA clippings for later audit. Trigger on /clip-thread, clip this thread, save Slack thread, or archive email chain. |
| argument-hint | <thread-url-or-id> [tags] |
| allowed-tools | Read, Write, Grep |
/clip-thread — Capture Chat/Email Thread to Intake
RETIRED 2026-06-21 (v2.33.0). Folded into /intake: clip-thread → /intake thread <id> (or auto-detected from a chat/email URL). Kept for reference only — not a live skill (archived under skills/.archived/, excluded from discovery).
Save a chat thread or email conversation to intake/clippings/{YYYY-MM-DD}-{slug}.md for review and promotion. Unlike /clip (URL/snippet) or /intake (bulk/doc-anchored), /clip-thread is shaped specifically for threaded conversations — Slack threads, Teams channel discussions, Gmail conversation chains, MS365 email threads.
Step 0: Resolve Config
Read ~/.claude/aria-knowledge.local.md and extract knowledge_folder. If the file doesn't exist, stop: "aria-knowledge is not configured. Run /setup to get started."
Verify {knowledge_folder}/intake/clippings/ exists. If not, stop: "Clippings directory not found. Run /setup to repair the knowledge folder structure."
Step 1: Probe Connected MCPs
Check Codex's available tool list for ~~chat and ~~email MCPs. The skill needs at least ONE of these connected to proceed.
~~chat (slack, ms365): if connected, available for Slack threads or Teams channel messages.~~email (gmail, ms365): if connected, available for Gmail or MS365 email threads.
If NEITHER category has a connected MCP, output the standard fallback notice and stop:
No required MCPs connected for /clip-thread. Connect one of: Slack, Microsoft 365 Teams (for ~~chat) or Gmail, Microsoft 365 Outlook (for ~~email) via Codex MCP configuration. See CONNECTORS.md. Skipping this run.
Per ADR-015, the runtime tool list IS the probe — no explicit API call needed.
Step 2: Parse Input
The user provides one of:
- A Slack thread URL —
https://<workspace>.slack.com/archives/<channel>/<message-ts> or thread permalink
- A Teams message link —
https://teams.microsoft.com/l/message/...
- A Gmail thread ID or URL —
https://mail.google.com/mail/u/0/#inbox/<thread-id> or just the thread ID
- An MS365 message ID — opaque ID from Outlook
- A bare thread/conversation identifier — opaque string the connected MCP can resolve
Optionally followed by tags (e.g., slack #engineering, email customer-feedback).
Source-type detection:
| Input shape | Routes to |
|---|
Contains slack.com/archives/ | ~~chat (slack) |
Contains teams.microsoft.com | ~~chat (ms365) |
Contains mail.google.com or matches Gmail thread-ID pattern | ~~email (gmail) |
| Outlook-shaped ID | ~~email (ms365) |
| Ambiguous | Ask user which category to route through |
If the detected category's MCP is NOT connected, output the category-specific fallback notice and stop:
This thread looks like a [Slack thread / Gmail thread / etc.] but the ~~chat / ~~email MCP for that source is not connected. Connect [vendor] via your MCP config and retry. Skipping this run.
Step 3: Fetch Thread Content
Call the appropriate MCP tool to retrieve the thread:
- Slack: use the connected slack MCP's
conversations.replies (or equivalent) tool with the channel + thread_ts derived from the URL. Retrieve all messages in the thread.
- Teams: use the connected ms365 MCP's message-thread tool.
- Gmail: use the connected gmail MCP's
messages.get for each message in the thread (or threads.get if exposed).
- MS365 Outlook: use the ms365 MCP's email-thread tool.
For each message in the thread, gather:
- Author (display name + handle/email)
- Timestamp (ISO format)
- Body (plaintext if available, markdown if the source supports it)
- Reactions / attachments (if exposed — note their presence but don't fetch attachment bodies in this skill)
Limit: if the thread has more than 50 messages, fetch the first 50 + note the truncation in the clipping. The user can run /clip-thread again with a refined identifier for the tail.
Step 4: Compose Clipping
Slug-ify the thread for the filename: use the first message's first ~6 significant words, lowercased, hyphen-separated, ASCII-only.
Generate the date stamp as YYYY-MM-DD (local time).
Filename: intake/clippings/{date}-{slug}.md
If a file with that name already exists, append -2, -3, etc. to deduplicate.
Body template:
---
source: <thread-url-or-id>
source_type: <slack|teams|gmail|ms365>
date: <YYYY-MM-DD>
participants: [<list of unique authors>]
message_count: <N>
tags: [<from input args, plus auto-detected like 'slack' or 'email'>]
---
# <thread topic — extracted from first message's first line or the channel name>
## Context
- **Source:** <source URL or "Slack thread in #channel" / "Gmail thread with N replies">
- **Participants:** <N authors>: <list>
- **Spans:** <first-message-date> → <last-message-date>
- **Message count:** <N> (or "<N> of <total> — truncated at 50")
## Thread
<for each message:>
### <Author> — <timestamp>
<message body, lightly cleaned (remove Slack/MS markup if obvious, preserve markdown)>
<reactions if present: e.g., "Reactions: 👍 ×3, 🎉 ×1">
<attachment notes if present: e.g., "[attachment: deploy-logs.txt (45KB)]">
---
## Reaction
<intentionally left empty — the user's reaction / why this is worth keeping. /audit-knowledge surfaces this for review at next audit pass.>
Step 5: Write + Report
Write the composed clipping to {knowledge_folder}/intake/clippings/{date}-{slug}.md.
Report to user:
Clipped <N> messages from <source-type> thread to intake/clippings/<date>-<slug>.md.
- Participants: <list, max 5 + "and N more" if truncated>
- Spans: <date range>
- Tags: <from input>
Next: review at next /audit-knowledge run. Add a reaction in the "## Reaction" section if you want to lock in the why-it-matters context now.
Rules
- Never auto-promote. Clippings stay in
intake/clippings/ until /audit-knowledge routes them. This skill is intake-only.
- Never delete the source. Reading a thread via MCP doesn't modify it; this is read-only externally.
- Respect 50-message truncation cap. Do NOT loop and fetch all pages. If user wants the full thread, they can re-invoke with a refined scope or use the source platform's native export.
- Strip secrets if obvious — if the thread contains what look like API keys, OAuth tokens, or passwords (regex match against common patterns), replace with
[REDACTED] in the body and add a redactions: true field to frontmatter. Surface in the report.
- One thread per invocation. If the user wants multiple threads, suggest
/intake bulk mode.
Notes
- Composes with
/audit-knowledge — clippings written here are routed at next audit per the standard intake-disposition vocabulary (Accept → tracker / roadmap / todo / adr / plan / bundle / rule, or Reject / Defer).
- The
## Reaction section is the user's voice slot. /clip-thread never fills it (the same precedent /intake doc set in v2.17.0).
- This skill is bidirectional per ADR-014 — aria-cowork v0.4.0 ships an identical port. Output schema is byte-identical per ADR-013.
- Probe semantics per ADR-015.
