Files

T

Teknium c49fa88b80 refactor(skills): shipped-set slim — 15 to optional, github 6-way merge, pdf absorbs OCR, channel-gated teams pipeline (index −26%) (#98539 )

* refactor(skills): shipped-set slim — 15 skills to optional, github six-way merge, pdf absorbs OCR+nano-pdf, channel-gated teams pipeline

Maintainer-directed shipped-skills curation (skills index 1,900 -> ~1,400
tok/call on desktop; every session pays the index, so this is a per-call
diet on all installs):

- optional-skills moves (installable via skills hub, history preserved):
  creative comfyui/ascii-art/excalidraw/pretext/sketch/touchdesigner-mcp;
  ALL of mlops (huggingface-hub, llama-cpp, serving-llms-vllm,
  weights-and-biases, evaluating-llms-harness — subcategory structure
  kept); research-paper-writing (55 supporting files, 17.3K-tok load);
  openhue; blogwatcher (first taught the cronjob monitor-field watch
  pattern + web_extract instead of pre-cron manual workflows)
- DELETED session-librarian (Aug-12 'inspired by Perplexity Computer'
  port, never maintainer-intended; session_search covers discovery)
- github: six skills (auth, issues, pr-workflow, issue-to-pr,
  code-review, repo-management) merged into ONE software-development/
  github skill — routing body + complete per-workflow references;
  benbarclay authorship credited; codebase-inspection rides along;
  discipline pins from test_github_issue_to_pr_skill.py preserved
  against the reference body in the new test_github_skill.py
- pdf absorbs ocr-and-documents + nano-pdf as references/ + scripts
  (extract_pymupdf, extract_marker converted to the argparse house
  standard its contract test enforces)
- NEW session_platforms frontmatter gate (metadata.hermes): hides a
  skill from the index on gateway channels it is not for; fail-open on
  unknown platform; teams-meeting-pipeline gated to [teams, cron]
- blocked-page-recovery: research -> new web category; trigger-first
  description ('Use when a fetch fails: 403/429, paywall, WAF, bot
  wall.') so the model actually reaches for it on blocked fetches
- docs regenerated via generate-skill-docs.py (195 pages); related_skills
  swept repo-wide; tests: 1672 passed (2 openclaw failures pre-existing
  on clean main, Windows-local)

* chore: ignore .skills_prompt_snapshot.json (local index cache, accidentally committed)

2026-08-30 04:53:39 -07:00

4.2 KiB

Raw Blame History

title, sidebar_label, description

title	sidebar_label	description
Agentmail — Use when an agent needs AgentMail CLI email inboxes	Agentmail	Use when an agent needs AgentMail CLI email inboxes

{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}

Agentmail

Use when an agent needs AgentMail CLI email inboxes.

Skill metadata


Source	Optional — install with `hermes skills install official/email/agentmail`
Path	`optional-skills/email\agentmail`
Version	`1.0.0`
Author	Haakam Aujla (Haakam21), AgentMail
License	MIT
Platforms	linux, macos, windows
Tags	`Email`, `CLI`, `AgentMail`, `Communication`

Reference: full SKILL.md

:::info The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active. :::

AgentMail Skill

AgentMail gives an agent its own email inbox for sending mail, receiving replies, completing email OTP flows, and running inbound email loops. Use it for agent-owned inboxes, not a user's existing IMAP/SMTP mailbox.

Use the agentmail CLI first. Use MCP only when the harness expects MCP tools; use REST only when the CLI is missing a required operation.

When to Use

The agent needs an email address it owns.
The task involves email OTP flows, replies, threads, labels, or attachments.
The agent needs webhook or WebSocket delivery for inbound mail.

Prerequisites

Run commands through the terminal tool.
Install the CLI:

npm install -g agentmail-cli@latest

Export an API key:

export AGENTMAIL_API_KEY="am_..."

No API key yet? Use signup.md.

How to Run

Use --format json whenever another command or script needs IDs.

agentmail inboxes list --format json

Quick Reference

AgentMail agent reference: hosted copy.
AgentMail: product landing page.
Console: API keys and account management.
Docs: full product documentation.
signup.md: self-signup and OTP verification.
core.md: inboxes, messages, threads, labels, attachments.
webhooks.md: events to a public HTTPS server.
websockets.md: events to a local agent process.
mcp.md: MCP integration.

Procedure

Install agentmail-cli@latest and verify agentmail inboxes list --format json.
If no API key is available, complete signup.md.
Use core.md for inbox, send, read, reply, forward, label, thread, and attachment flows.
Add webhooks.md or websockets.md only when polling is not enough.

Pitfalls

Prefer AGENTMAIL_API_KEY over --api-key.
Never expose AGENTMAIL_API_KEY in prompts, logs, URLs, or committed files.
Use stable client_id values for retried create operations.
Prefer extracted_text or extracted_html for LLM input when present.
React to message.received, not messages the agent sent.

Verification

agentmail inboxes list --format json

4.2 KiB Raw Blame History