[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79GFM7EAT688F7AH30D408Q":3,"skill-same:01M79GFM7EAT688F7AH30D408Q":51},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M79GFM7EAT688F7AH30D408Q","twilio-sendgrid-suppressions",null,"Manage SendGrid email suppressions: bounces, blocks, spam reports, invalid emails, global unsubscribes, and ASM suppression groups. Covers when and how to remove suppressions, reputation impact, and category-based unsubscribe management. Use when debugging SendGrid delivery issues or building unsubscribe flows. Requires a SendGrid API key (SG.-prefix) — not applicable to the Twilio Email API (comms.twilio.com).","zfifteen\u002Fskills-catalog","zfifteen","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F221906715?v=4","01M79CQFXDZM5J5CJTCECPFA66","Dionisio Alberto Lopez III","01M79CQFY4C62PN8A2T5KDAHGA",1,"MIT","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Ftwilio-sendgrid-suppressions\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: twilio-sendgrid-suppressions\ndescription: >\n  Manage SendGrid email suppressions: bounces, blocks, spam reports,\n  invalid emails, global unsubscribes, and ASM suppression groups.\n  Covers when and how to remove suppressions, reputation impact, and\n  category-based unsubscribe management. Use when debugging SendGrid\n  delivery issues or building unsubscribe flows. Requires a SendGrid API\n  key (SG.-prefix) — not applicable to the Twilio Email API (comms.twilio.com).\n---\n\n## Overview\n\nSuppressions prevent SendGrid from sending to addresses that have bounced, reported spam, or unsubscribed. They protect your sender reputation but can also block legitimate re-sends if not managed correctly.\n\n---\n\n## Suppression Types\n\n| Type | Endpoint | What triggers it | Auto-added? |\n|------|----------|-----------------|-------------|\n| **Hard Bounces** | `\u002Fv3\u002Fsuppression\u002Fbounces` | Permanent delivery failure (invalid mailbox, domain doesn't exist) | Yes |\n| **Soft Bounces** | No management API — automatic retry only | Temporary failure (mailbox full, server down) — SendGrid auto-retries before suppressing | Yes, after repeated failures |\n| **Blocks** | `\u002Fv3\u002Fsuppression\u002Fblocks` | Temporary rejection by receiving server (reputation, policy, content) | Yes |\n| **Spam Reports** | `\u002Fv3\u002Fsuppression\u002Fspam_reports` | Recipient marks email as spam | Yes |\n| **Invalid Emails** | `\u002Fv3\u002Fsuppression\u002Finvalid_emails` | Malformed email address | Yes |\n| **Global Unsubscribes** | `\u002Fv3\u002Fsuppression\u002Funsubscribes` | Recipient unsubscribes from all email | Yes |\n| **Group Unsubscribes (ASM)** | `\u002Fv3\u002Fasm\u002Fgroups\u002F{id}\u002Fsuppressions` | Recipient unsubscribes from a category | Yes |\n\n**Hard vs Soft bounces:** Hard bounces (permanent) immediately suppress the address. Soft bounces (temporary) trigger retries — SendGrid will retry delivery before eventually suppressing if the issue persists.\n\n---\n\n## Managing Suppressions\n\n**List bounces (Python)**\n```python\nimport os, requests\n\nheaders = {\"Authorization\": f\"Bearer {os.environ['SENDGRID_API_KEY']}\"}\nresponse = requests.get(\"https:\u002F\u002Fapi.sendgrid.com\u002Fv3\u002Fsuppression\u002Fbounces\", headers=headers)\nfor bounce in response.json():\n    print(f\"{bounce['email']}: {bounce.get('reason', 'unknown')}\")\n```\n\n**Remove a bounce (Python)**\n```python\nrequests.delete(f\"https:\u002F\u002Fapi.sendgrid.com\u002Fv3\u002Fsuppression\u002Fbounces\u002F{email}\", headers=headers)\n```\n\n> **Caution:** Deleting suppression records (especially spam reports) allows re-sending to addresses that previously complained. Always confirm with the user before removal and document the business reason.\n\n---\n\n## ASM Suppression Groups\n\nUse suppression groups for category-based unsubscribes (e.g., \"Marketing\", \"Transactional\", \"Product Updates\"). Recipients can unsubscribe from one category without being suppressed from all email.\n\n**Create a group:**\n```python\nrequests.post(\"https:\u002F\u002Fapi.sendgrid.com\u002Fv3\u002Fasm\u002Fgroups\",\n    headers={**headers, \"Content-Type\": \"application\u002Fjson\"},\n    json={\"name\": \"Marketing Emails\", \"description\": \"Promotional offers and updates\"})\n```\n\n**Send with a suppression group:**\nInclude `asm.group_id` in your Mail Send request. Recipients see a \"manage preferences\" link instead of a global unsubscribe.\n\n---\n\n## Auto-Purge (Bounce & Block Cleanup)\n\nConfigure automatic purge schedules in Console > Settings > Mail Settings > Purge Bounces & Blocks:\n\n- **Soft Bounces:** Auto-purge after N days (1–3,650 days)\n- **Hard Bounces:** Auto-purge after N days (1–3,650 days)\n\n**Caution:** Enabling auto-purge without a business reason allows re-sending to previously bounced addresses, which damages sender reputation. Do not use as a workaround to force delivery.\n\n---\n\n## Address Allow List\n\nConsole > Settings > Mail Settings > Address Allow List allows specific email addresses or domains to bypass all suppressions. Useful for internal testing addresses.\n\n**Use with extreme caution** — never allowlist domains you don't control (e.g., `gmail.com`), and never use to bypass spam report suppressions.\n\n---\n\n## CANNOT\n\n- **Suppressions are global by default** — A bounce or spam report on ANY email suppresses the address from ALL future sends. Use ASM groups to scope unsubscribes.\n- **Removing a suppression does not fix the underlying issue** — Deleting a bounce record lets you retry, but the mailbox is likely still invalid. Re-sending to hard bounces damages sender reputation.\n- **Cannot prevent spam report suppressions** — When a recipient marks you as spam, the suppression is automatic and cannot be overridden.\n- **Cannot bulk-remove suppressions by domain** — Must remove individually by email address via API.\n\n---\n\n## Next Steps\n\n- **Send email:** `twilio-sendgrid-email-send`\n- **Delivery tracking:** `twilio-sendgrid-webhooks`\n- **Account setup:** `twilio-sendgrid-account-setup`\n","## Overview\n\nSuppressions prevent SendGrid from sending to addresses that have bounced, reported spam, or unsubscribed. They protect your sender reputation but can also block legitimate re-sends if not managed correctly.\n\n---\n\n## Suppression Types\n\n| Type | Endpoint | What triggers it | Auto-added? |\n|------|----------|-----------------|-------------|\n| **Hard Bounces** | `\u002Fv3\u002Fsuppression\u002Fbounces` | Permanent delivery failure (invalid mailbox, domain doesn't exist) | Yes |\n| **Soft Bounces** | No management API — automatic retry only | Temporary failure (mailbox full, server down) — SendGrid auto-retries before suppressing | Yes, after repeated failures |\n| **Blocks** | `\u002Fv3\u002Fsuppression\u002Fblocks` | Temporary rejection by receiving server (reputation, policy, content) | Yes |\n| **Spam Reports** | `\u002Fv3\u002Fsuppression\u002Fspam_reports` | Recipient marks email as spam | Yes |\n| **Invalid Emails** | `\u002Fv3\u002Fsuppression\u002Finvalid_emails` | Malformed email address | Yes |\n| **Global Unsubscribes** | `\u002Fv3\u002Fsuppression\u002Funsubscribes` | Recipient unsubscribes from all email | Yes |\n| **Group Unsubscribes (ASM)** | `\u002Fv3\u002Fasm\u002Fgroups\u002F{id}\u002Fsuppressions` | Recipient unsubscribes from a category | Yes |\n\n**Hard vs Soft bounces:** Hard bounces (permanent) immediately suppress the address. Soft bounces (temporary) trigger retries — SendGrid will retry delivery before eventually suppressing if the issue persists.\n\n---\n\n## Managing Suppressions\n\n**List bounces (Python)**\n```python\nimport os, requests\n\nheaders = {\"Authorization\": f\"Bearer {os.environ['SENDGRID_API_KEY']}\"}\nresponse = requests.get(\"https:\u002F\u002Fapi.sendgrid.com\u002Fv3\u002Fsuppression\u002Fbounces\", headers=headers)\nfor bounce in response.json():\n    print(f\"{bounce['email']}: {bounce.get('reason', 'unknown')}\")\n```\n\n**Remove a bounce (Python)**\n```python\nrequests.delete(f\"https:\u002F\u002Fapi.sendgrid.com\u002Fv3\u002Fsuppression\u002Fbounces\u002F{email}\", headers=headers)\n```\n\n> **Caution:** Deleting suppression records (especially spam reports) allows re-sending to addresses that previously complained. Always confirm with the user before removal and document the business reason.\n\n---\n\n## ASM Suppression Groups\n\nUse suppression groups for category-based unsubscribes (e.g., \"Marketing\", \"Transactional\", \"Product Updates\"). Recipients can unsubscribe from one category without being suppressed from all email.\n\n**Create a group:**\n```python\nrequests.post(\"https:\u002F\u002Fapi.sendgrid.com\u002Fv3\u002Fasm\u002Fgroups\",\n    headers={**headers, \"Content-Type\": \"application\u002Fjson\"},\n    json={\"name\": \"Marketing Emails\", \"description\": \"Promotional offers and updates\"})\n```\n\n**Send with a suppression group:**\nInclude `asm.group_id` in your Mail Send request. Recipients see a \"manage preferences\" link instead of a global unsubscribe.\n\n---\n\n## Auto-Purge (Bounce & Block Cleanup)\n\nConfigure automatic purge schedules in Console > Settings > Mail Settings > Purge Bounces & Blocks:\n\n- **Soft Bounces:** Auto-purge after N days (1–3,650 days)\n- **Hard Bounces:** Auto-purge after N days (1–3,650 days)\n\n**Caution:** Enabling auto-purge without a business reason allows re-sending to previously bounced addresses, which damages sender reputation. Do not use as a workaround to force delivery.\n\n---\n\n## Address Allow List\n\nConsole > Settings > Mail Settings > Address Allow List allows specific email addresses or domains to bypass all suppressions. Useful for internal testing addresses.\n\n**Use with extreme caution** — never allowlist domains you don't control (e.g., `gmail.com`), and never use to bypass spam report suppressions.\n\n---\n\n## CANNOT\n\n- **Suppressions are global by default** — A bounce or spam report on ANY email suppresses the address from ALL future sends. Use ASM groups to scope unsubscribes.\n- **Removing a suppression does not fix the underlying issue** — Deleting a bounce record lets you retry, but the mailbox is likely still invalid. Re-sending to hard bounces damages sender reputation.\n- **Cannot prevent spam report suppressions** — When a recipient marks you as spam, the suppression is automatic and cannot be overridden.\n- **Cannot bulk-remove suppressions by domain** — Must remove individually by email address via API.\n\n---\n\n## Next Steps\n\n- **Send email:** `twilio-sendgrid-email-send`\n- **Delivery tracking:** `twilio-sendgrid-webhooks`\n- **Account setup:** `twilio-sendgrid-account-setup`\n",{"name":5,"description":7},"main","d9535210da9af28aa76bca80de80355197e1b6d6","skills\u002Ftwilio-sendgrid-suppressions","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog","https:\u002F\u002Fgithub.com\u002Fzfifteen","I like to measure things.","2026-07-19 23:41:54",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add zfifteen\u002Fskills-catalog --skill twilio-sendgrid-suppressions",{"tool":37,"command":38},"bunx","bunx skills add zfifteen\u002Fskills-catalog --skill twilio-sendgrid-suppressions",{"tool":40,"command":41},"pnpm","pnpm dlx skills add zfifteen\u002Fskills-catalog --skill twilio-sendgrid-suppressions","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Ftwilio-sendgrid-suppressions\u002FSKILL.md",true,[45],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"agents\u002Fopenai.yaml","REFERENCE","参考文档",237,"https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Ftwilio-sendgrid-suppressions\u002Fagents\u002Fopenai.yaml",[52,59,66,73,82,89],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M79GXQ2PWPT2E4CJYHXVJ0YE","Zotero","Use Zotero Desktop from Codex to enable\u002Fprobe the local API, search a local Zotero library, list items\u002Fcollections\u002Ftags, export BibTeX, insert citation keys into LaTeX or Markdown drafts, read indexed full text when requested, and import BibTeX\u002FRIS records into Zotero through the connector server. Use when the user mentions Zotero, citations, references.bib, BibTeX export, local Zotero API, localhost:23119, or adding citations from a Zotero library.","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fzotero\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M79GXN85NETKBE06865CWK6Z","zoom-apps-sdk","Use when using Apps SDK.","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fzoom-apps-sdk\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M79GXCYD7FGYS932J9N9RFFY","youtube","Obtain accurate, timestamped YouTube video transcripts (preferring manual captions over auto-generated) as the primary deliverable, then derive summaries, key claims, or notes from that transcript.  Use when the user provides a YouTube URL (or video ID) and wants the transcript, a faithful summary, key claims with attribution, timestamped notes, or \"what does this video actually say\".  The skill is transcript-first: never substitute metadata, title, description, or search snippets for the spoken content.  Triggers: \"youtube transcript\", \"get the transcript of this video\", \"summarize this youtube video\", \"what did they say in https:\u002F\u002Fyoutube.com\u002F...\", \"key claims from this talk\".","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fyoutube\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":77,"licenseFileUrl":78,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M79GX8EXHHYM566BKR7MS778","yeet","Publish local changes to GitHub by confirming scope, committing intentionally, pushing the branch, and opening a draft PR through the GitHub app from this plugin, with `gh` used only as a fallback where connector coverage is insufficient.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fyeet\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fyeet\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M79GX2HFJPX84NMRE5VBTYX9","x-post-creator","Create X-ready post threads and co-located story packages from the active conversation or referenced project material. Use when the user says turn this into an X-post, \u002Fx-post, make this into an X thread, or wants plain-language social posts with supporting images saved to docs\u002Fx-posts\u002F[story-name]\u002F.","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fx-post-creator\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M79GWXQT4HBT6QME6QSBZJFA","x-api","Search, read, and write X posts through the local X API MCP server (the same backend used by the Codex x-api skill). Use for searching X\u002Fx.com, reading threads and replies, creating lists, staging\u002Fpublishing posts for @alltheputs, finding high-visibility reply targets for research outreach, ingesting public context, or any request that mentions \u002Fx-api or \"search X\".","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fx-api\u002FSKILL.md",[],[]]