[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7C3QPS96AVRAWG6CP5GXBNK":3,"skill-same:01M7C3QPS96AVRAWG6CP5GXBNK":87},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":46,"commitSha":47,"skillDirectory":48,"forksCount":13,"repositoryHtmlUrl":49,"repositoryHomepageUrl":6,"ownerHtmlUrl":50,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":51,"install":52,"resources":64},"01M7C3QPS96AVRAWG6CP5GXBNK","agentmail",null,"Use when an agent needs AgentMail CLI email inboxes.","fengwhang\u002Fmercury","fengwhang","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F325040254?v=4","01M7C3K54Y41KVGPHEMKEP9X70","01M7C3K55NTZ4B36YP2JY1NMJ0",0,"MIT","https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fhermes\u002Foptional-skills\u002Femail\u002Fagentmail\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: agentmail\ndescription: Use when an agent needs AgentMail CLI email inboxes.\nversion: 1.0.0\nauthor: Haakam Aujla (Haakam21), AgentMail\nlicense: MIT\nplatforms: [linux, macos, windows]\nmetadata:\n  mercury:\n    tags: [Email, CLI, AgentMail, Communication]\n    homepage: https:\u002F\u002Fagentmail.to\nprerequisites:\n  commands: [agentmail]\nrequired_environment_variables:\n  - name: AGENTMAIL_API_KEY\n    prompt: AgentMail API key (starts with am_)\n    help: \"Create one at https:\u002F\u002Fconsole.agentmail.to — or run the CLI self-signup flow in references\u002Fsignup.md to obtain a key without one.\"\n    required_for: \"authenticating the agentmail CLI; not needed before self-signup\"\n    optional: true\n---\n\n# AgentMail Skill\n\nAgentMail gives an agent its own email inbox for sending mail, receiving\nreplies, completing email OTP flows, and running inbound email loops. Use it for\nagent-owned inboxes, not a user's existing IMAP\u002FSMTP mailbox.\n\nUse the `agentmail` CLI first. Use MCP only when the harness expects MCP tools;\nuse REST only when the CLI is missing a required operation.\n\n## When to Use\n\n- The agent needs an email address it owns.\n- The task involves email OTP flows, replies, threads, labels, or attachments.\n- The agent needs webhook or WebSocket delivery for inbound mail.\n\n## Prerequisites\n\n- Run commands through the `terminal` tool.\n- Install the CLI:\n\n```bash\nnpm install -g agentmail-cli@latest\n```\n\n- Export an API key:\n\n```bash\nexport AGENTMAIL_API_KEY=\"am_...\"\n```\n\nNo API key yet? Use [signup.md](references\u002Fsignup.md).\n\n## How to Run\n\nUse `--format json` whenever another command or script needs IDs.\n\n```bash\nagentmail inboxes list --format json\n```\n\n## Quick Reference\n\n- [AgentMail agent reference](https:\u002F\u002Fagentmail.md): hosted copy.\n- [AgentMail](https:\u002F\u002Fagentmail.to): product landing page.\n- [Console](https:\u002F\u002Fconsole.agentmail.to): API keys and account management.\n- [Docs](https:\u002F\u002Fdocs.agentmail.to): full product documentation.\n- [signup.md](references\u002Fsignup.md): self-signup and OTP verification.\n- [core.md](references\u002Fcore.md): inboxes, messages, threads, labels, attachments.\n- [webhooks.md](references\u002Fwebhooks.md): events to a public HTTPS server.\n- [websockets.md](references\u002Fwebsockets.md): events to a local agent process.\n- [mcp.md](references\u002Fmcp.md): MCP integration.\n\n## Procedure\n\n1. Install `agentmail-cli@latest` and verify `agentmail inboxes list --format json`.\n2. If no API key is available, complete [signup.md](references\u002Fsignup.md).\n3. Use [core.md](references\u002Fcore.md) for inbox, send, read, reply, forward,\n   label, thread, and attachment flows.\n4. Add [webhooks.md](references\u002Fwebhooks.md) or\n   [websockets.md](references\u002Fwebsockets.md) only when polling is not enough.\n\n## Pitfalls\n\n- Prefer `AGENTMAIL_API_KEY` over `--api-key`.\n- Never expose `AGENTMAIL_API_KEY` in prompts, logs, URLs, or committed files.\n- Use stable `client_id` values for retried create operations.\n- Prefer `extracted_text` or `extracted_html` for LLM input when present.\n- React to `message.received`, not messages the agent sent.\n\n## Verification\n\n```bash\nagentmail inboxes list --format json\n```\n","# AgentMail Skill\n\nAgentMail gives an agent its own email inbox for sending mail, receiving\nreplies, completing email OTP flows, and running inbound email loops. Use it for\nagent-owned inboxes, not a user's existing IMAP\u002FSMTP mailbox.\n\nUse the `agentmail` CLI first. Use MCP only when the harness expects MCP tools;\nuse REST only when the CLI is missing a required operation.\n\n## When to Use\n\n- The agent needs an email address it owns.\n- The task involves email OTP flows, replies, threads, labels, or attachments.\n- The agent needs webhook or WebSocket delivery for inbound mail.\n\n## Prerequisites\n\n- Run commands through the `terminal` tool.\n- Install the CLI:\n\n```bash\nnpm install -g agentmail-cli@latest\n```\n\n- Export an API key:\n\n```bash\nexport AGENTMAIL_API_KEY=\"am_...\"\n```\n\nNo API key yet? Use [signup.md](references\u002Fsignup.md).\n\n## How to Run\n\nUse `--format json` whenever another command or script needs IDs.\n\n```bash\nagentmail inboxes list --format json\n```\n\n## Quick Reference\n\n- [AgentMail agent reference](https:\u002F\u002Fagentmail.md): hosted copy.\n- [AgentMail](https:\u002F\u002Fagentmail.to): product landing page.\n- [Console](https:\u002F\u002Fconsole.agentmail.to): API keys and account management.\n- [Docs](https:\u002F\u002Fdocs.agentmail.to): full product documentation.\n- [signup.md](references\u002Fsignup.md): self-signup and OTP verification.\n- [core.md](references\u002Fcore.md): inboxes, messages, threads, labels, attachments.\n- [webhooks.md](references\u002Fwebhooks.md): events to a public HTTPS server.\n- [websockets.md](references\u002Fwebsockets.md): events to a local agent process.\n- [mcp.md](references\u002Fmcp.md): MCP integration.\n\n## Procedure\n\n1. Install `agentmail-cli@latest` and verify `agentmail inboxes list --format json`.\n2. If no API key is available, complete [signup.md](references\u002Fsignup.md).\n3. Use [core.md](references\u002Fcore.md) for inbox, send, read, reply, forward,\n   label, thread, and attachment flows.\n4. Add [webhooks.md](references\u002Fwebhooks.md) or\n   [websockets.md](references\u002Fwebsockets.md) only when polling is not enough.\n\n## Pitfalls\n\n- Prefer `AGENTMAIL_API_KEY` over `--api-key`.\n- Never expose `AGENTMAIL_API_KEY` in prompts, logs, URLs, or committed files.\n- Use stable `client_id` values for retried create operations.\n- Prefer `extracted_text` or `extracted_html` for LLM input when present.\n- React to `message.received`, not messages the agent sent.\n\n## Verification\n\n```bash\nagentmail inboxes list --format json\n```\n",{"name":5,"author":23,"license":14,"version":24,"metadata":25,"platforms":33,"description":7,"prerequisites":37,"required_environment_variables":39},"Haakam Aujla (Haakam21), AgentMail","1.0.0",{"mercury":26},{"tags":27,"homepage":32},[28,29,30,31],"Email","CLI","AgentMail","Communication","https:\u002F\u002Fagentmail.to",[34,35,36],"linux","macos","windows",{"commands":38},[5],[40],{"help":41,"name":42,"prompt":43,"optional":44,"required_for":45},"Create one at https:\u002F\u002Fconsole.agentmail.to — or run the CLI self-signup flow in references\u002Fsignup.md to obtain a key without one.","AGENTMAIL_API_KEY","AgentMail API key (starts with am_)",true,"authenticating the agentmail CLI; not needed before self-signup","main","94a12cab2ce32e2020d179b5d579d0cbcbd0f206","hermes\u002Foptional-skills\u002Femail\u002Fagentmail","https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury","https:\u002F\u002Fgithub.com\u002Ffengwhang","2026-10-09 08:26:42",{"source":8,"skillName":5,"commands":53,"prompt":63,"zipAvailable":44},[54,57,60],{"tool":55,"command":56},"npx","npx skills add fengwhang\u002Fmercury --skill agentmail",{"tool":58,"command":59},"bunx","bunx skills add fengwhang\u002Fmercury --skill agentmail",{"tool":61,"command":62},"pnpm","pnpm dlx skills add fengwhang\u002Fmercury --skill agentmail","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fhermes\u002Foptional-skills\u002Femail\u002Fagentmail\u002FSKILL.md",[65,71,75,79,83],{"path":66,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":69,"sourceHtmlUrl":70},"references\u002Fcore.md","REFERENCE","参考文档",2958,"https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fhermes\u002Foptional-skills\u002Femail\u002Fagentmail\u002Freferences\u002Fcore.md",{"path":72,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":73,"sourceHtmlUrl":74},"references\u002Fmcp.md",313,"https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fhermes\u002Foptional-skills\u002Femail\u002Fagentmail\u002Freferences\u002Fmcp.md",{"path":76,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":77,"sourceHtmlUrl":78},"references\u002Fsignup.md",1078,"https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fhermes\u002Foptional-skills\u002Femail\u002Fagentmail\u002Freferences\u002Fsignup.md",{"path":80,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":81,"sourceHtmlUrl":82},"references\u002Fwebhooks.md",851,"https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fhermes\u002Foptional-skills\u002Femail\u002Fagentmail\u002Freferences\u002Fwebhooks.md",{"path":84,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":85,"sourceHtmlUrl":86},"references\u002Fwebsockets.md",1293,"https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fhermes\u002Foptional-skills\u002Femail\u002Fagentmail\u002Freferences\u002Fwebsockets.md",[88,95,102,109,115,122],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":18},"01M7C4BTY3ND38CN200ZCTH6NV","greet","A greeting skill for testing","https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fomp\u002Fpackages\u002Fcoding-agent\u002Ftest\u002Fmarketplace\u002Ffixtures\u002Fvalid-marketplace\u002Fplugins\u002Fhello-plugin\u002Fskills\u002Fgreet\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":18},"01M7C4BSNZTPW8JR5NGCQXGSEZ","valid-skill","A valid skill for testing purposes.","https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fomp\u002Fpackages\u002Fcoding-agent\u002Ftest\u002Ffixtures\u002Fskills\u002Fvalid-skill\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":18},"01M7C4BRA7J8C06KSVW100F1W1","unknown-field","A skill with an unknown frontmatter field.","https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fomp\u002Fpackages\u002Fcoding-agent\u002Ftest\u002Ffixtures\u002Fskills\u002Funknown-field\u002FSKILL.md",[],[],{"skillNo":110,"name":111,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":112,"categories":113,"keywords":114,"publishedAt":18},"01M7C4BNB04KQGCJ835JE8AR13","no-frontmatter","https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fomp\u002Fpackages\u002Fcoding-agent\u002Ftest\u002Ffixtures\u002Fskills\u002Fno-frontmatter\u002FSKILL.md",[],[],{"skillNo":116,"name":117,"nameZh":6,"description":118,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":119,"categories":120,"keywords":121,"publishedAt":18},"01M7C4BM38TZFYT1AJ6SKHPZZ2","child-skill","A nested skill in a subdirectory.","https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fomp\u002Fpackages\u002Fcoding-agent\u002Ftest\u002Ffixtures\u002Fskills\u002Fnested\u002Fchild-skill\u002FSKILL.md",[],[],{"skillNo":123,"name":124,"nameZh":6,"description":125,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":126,"categories":127,"keywords":128,"publishedAt":18},"01M7C4BJDN7RFFCM28CGX15Q97","different-name","A skill with a name that doesn't match the directory.","https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fomp\u002Fpackages\u002Fcoding-agent\u002Ftest\u002Ffixtures\u002Fskills\u002Fname-mismatch\u002FSKILL.md",[],[]]