[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M755JVY6AJ0MCSJ8YVNHF5VT":3,"skill-same:01M755JVY6AJ0MCSJ8YVNHF5VT":55},{"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":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":31,"ownerHtmlUrl":32,"ownerBlogUrl":6,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M755JVY6AJ0MCSJ8YVNHF5VT","deliverability",null,"Use when the question is whether email will reach the inbox, covering sending domain setup, authentication, list hygiene, complaint and bounce rates, or a drop in delivery.","kuralle\u002Fkuralle-agents","kuralle","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F289272678?v=4","01M755GAMJ4VQ7Q14J065W5ZAM","Kuralle","01M755GANGEX5147S8CJY0A72W",1,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fkuralle\u002Fkuralle-agents\u002Fblob\u002Fmain\u002Fapps\u002Fexamples\u002Fmarketing-team\u002Fagent\u002Femail\u002Fskills\u002Fdeliverability\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: deliverability\ndescription: Use when the question is whether email will reach the inbox, covering sending domain setup, authentication, list hygiene, complaint and bounce rates, or a drop in delivery.\nallowed-tools: [lint_against_style]\n---\n\n# Deliverability\n\nDeliverability advice is mostly unfalsifiable from where you sit. The `email_sends` record will tell you what this workspace knows about a send it made: the subject, the recipients, the status (`draft`, `queued`, `sent`, `failed`), and when it went out. It carries nothing about sending-domain setup, bounce or complaint counts, or inbox placement. Inbox placement, what any provider thinks of the domain today, and whether a filter is quietly junking the whole campaign are questions to raise rather than blanks to fill in.\n\nThat gap is the discipline in this skill. Report what you verified from the `email_sends` record, name what you could not check, and never let the first turn into the second. A domain with clean records is not evidence that mail is reaching inboxes, and saying it is does more damage than saying nothing.\n\nThe same rule applies to numbers. Every threshold here traces to a page listed in `references\u002Fchecklist.md`, and the providers do not publish the same numbers, so quote a threshold with the provider attached and never quote one you cannot point at.\n\n## Check first, in this order\n\n1. Is the sending domain verified, and does the from address use it? This app has no domain-setup data to read, so that question goes straight to the user rather than being answered from a record. An unverified domain is the most common cause of mail that never leaves.\n2. What happened to the last comparable send? Read its `email_sends` record: status, recipients, sent time. That is what this workspace can actually confirm; bounce and complaint counts are not tracked here, so say so rather than inferring them from status.\n3. Is this a bulk sender situation? Close to 5,000 messages or more to personal Gmail accounts in 24 hours puts the domain permanently in Gmail's bulk sender category, and the requirements below become hard gates rather than good practice.\n4. What changed? Deliverability problems are almost always a delta: new domain, new volume, a list imported from somewhere, a change in content or cadence. Ask what moved before theorizing.\n\n## The requirements that are actually enforced\n\nGoogle and Yahoo have enforced these since February 2024. Google ramped enforcement up again in November 2025, to include temporary and permanent rejections. Microsoft applies its own set to mail sent to Outlook.com and its other consumer domains from May 5, 2025. Mail that fails these gets rate-limited, junked, or rejected.\n\n- SPF and DKIM both configured, and the From domain aligned with one of them. Authenticating without aligning is the trap: signing with a shared platform domain while sending from yours passes SPF and DKIM but fails DMARC. Google says alignment with both is likely to become a requirement, so treat one as the floor rather than the goal.\n- DMARC published. Google and Yahoo both accept `p=none`, so the requirement is weaker than the advice: `quarantine` or `reject` is what protects the domain. Common guidance is to publish `p=none` first, confirm every sending source is passing, then move the policy up.\n- One-click unsubscribe on marketing mail, meaning the `List-Unsubscribe` and `List-Unsubscribe-Post` headers together, plus a visible unsubscribe link in the body. A landing page with a login does not satisfy it. Google and Yahoo both began enforcing it in June 2024. Then honor the request quickly: Yahoo requires two days, Google recommends 48 hours.\n- Spam complaint rate below 0.30% at both Google and Yahoo, which is where enforcement starts rather than a safe place to sit. Google's own recommendation is to stay below 0.10%.\n\nThese pages get revised, and the dates above were checked in July 2026. When the answer turns on a specific threshold, fetch the source from the list in `references\u002Fchecklist.md` instead of quoting from memory.\n\n## What the law requires, which is a separate question\n\nEverything above is what mailbox providers enforce. Marketing mail also has to satisfy the law where the recipients are, and those rules do not care about your complaint rate. A send can be perfectly deliverable and still unlawful.\n\nTwo of these are checkable by reading the copy, so check them every time:\n\n- A valid physical postal address of the sender, in the message. US law requires it in every commercial message, and it is the single most commonly missing element.\n- Identification that the message is an advertisement, clear and conspicuous, unless the recipient gave prior affirmative consent. Plus clear notice of how to decline further mail.\n\nTwo more are about the mechanism rather than the copy. The opt-out has to stay capable of receiving requests for at least 30 days after the send, and a request has to be honored within 10 business days. Both are process questions for whoever runs the list.\n\nConsent is the part you cannot inspect, and it is the part that differs most by jurisdiction. In the UK and the EU, marketing email to individuals needs prior consent, with a narrow exception for people whose details you collected while selling them something, where you market only similar products and you offered a free and simple way to refuse both at collection and in every message since. A February 2026 amendment extended a version of that exception to charities. Under the GDPR, direct marketing can rest on legitimate interests, but a person's objection to direct marketing ends the matter, with no balancing against your interest in sending.\n\nSo ask rather than assume. Where the list came from, whether consent was recorded, and which countries the recipients are in are all questions for the user, and the answer changes what is allowed. Say plainly that you are naming requirements rather than giving legal advice, and that US, UK, and EU rules are not the whole world: a list spanning other markets needs someone to confirm what applies.\n\n## What follows from the complaint rate\n\nAlmost every list decision comes back to that number, and it is small enough to be worth making concrete: at 10,000 delivered, 30 complaints is the ceiling.\n\n- Yahoo computes its rate over mail delivered to the inbox rather than over everything it accepted, so a rate worked out from a send's own totals reads lower than the one Yahoo acts on. That is a reason to leave room under 0.30% rather than to sit on it.\n- A hidden or awkward unsubscribe does not keep subscribers. It converts people who would have left quietly into complaints, which is the expensive outcome.\n- Mailing people who never engage is not free. It suppresses reach for the people who do want the mail.\n- A list you did not build is the fastest way to the ceiling. Purchased or scraped addresses, and old lists imported from a previous tool, arrive with no consent record and often with spam traps in them.\n- Sudden volume increases read as a change in behavior. Ramp new sending volume instead of jumping straight to full send size, keep complaint and bounce rates well under the enforcement floor while ramping, and slow down if either climbs.\n\n## Say what you cannot see\n\nState these as open questions rather than findings, every time:\n\n- Whether mail landed in the inbox or the spam folder. `email_sends.status = 'sent'` means the send was attempted, nothing more.\n- The domain's current reputation with any provider. That lives in Google Postmaster Tools, Microsoft SNDS, and Yahoo's Complaint Feedback Loop.\n- Whether the DMARC record is published, and at what policy, unless the user tells you or shows you.\n- Bounce counts, complaint counts, and blocklist status. Nothing in this workspace tracks them.\n- Whether there is a lawful basis for mailing this list, and which jurisdictions it spans.\n- How the email renders across clients.\n- Open rates as a measure of anything on Apple clients, since Mail Privacy Protection inflates them.\n\nWhen one of these is the actual question, say what would answer it and who can check. Pointing the user at Postmaster Tools is a better answer than a confident guess.\n\n## References\n\n- `references\u002Fchecklist.md`: the checks in priority order, each marked with what verifies it in this workspace or `none` when nothing available here can, plus the concrete thresholds, each attributed to the page it came from. Its last section covers the legal requirements, which sit outside that priority order because a send that fails them should not go out at all.\n\n## Layers on top of\n\n`email-style` covers the content side of the same problem: the copy patterns that get mail reported, and the unsubscribe and sender-identity conventions that keep complaints low.\n","# Deliverability\n\nDeliverability advice is mostly unfalsifiable from where you sit. The `email_sends` record will tell you what this workspace knows about a send it made: the subject, the recipients, the status (`draft`, `queued`, `sent`, `failed`), and when it went out. It carries nothing about sending-domain setup, bounce or complaint counts, or inbox placement. Inbox placement, what any provider thinks of the domain today, and whether a filter is quietly junking the whole campaign are questions to raise rather than blanks to fill in.\n\nThat gap is the discipline in this skill. Report what you verified from the `email_sends` record, name what you could not check, and never let the first turn into the second. A domain with clean records is not evidence that mail is reaching inboxes, and saying it is does more damage than saying nothing.\n\nThe same rule applies to numbers. Every threshold here traces to a page listed in `references\u002Fchecklist.md`, and the providers do not publish the same numbers, so quote a threshold with the provider attached and never quote one you cannot point at.\n\n## Check first, in this order\n\n1. Is the sending domain verified, and does the from address use it? This app has no domain-setup data to read, so that question goes straight to the user rather than being answered from a record. An unverified domain is the most common cause of mail that never leaves.\n2. What happened to the last comparable send? Read its `email_sends` record: status, recipients, sent time. That is what this workspace can actually confirm; bounce and complaint counts are not tracked here, so say so rather than inferring them from status.\n3. Is this a bulk sender situation? Close to 5,000 messages or more to personal Gmail accounts in 24 hours puts the domain permanently in Gmail's bulk sender category, and the requirements below become hard gates rather than good practice.\n4. What changed? Deliverability problems are almost always a delta: new domain, new volume, a list imported from somewhere, a change in content or cadence. Ask what moved before theorizing.\n\n## The requirements that are actually enforced\n\nGoogle and Yahoo have enforced these since February 2024. Google ramped enforcement up again in November 2025, to include temporary and permanent rejections. Microsoft applies its own set to mail sent to Outlook.com and its other consumer domains from May 5, 2025. Mail that fails these gets rate-limited, junked, or rejected.\n\n- SPF and DKIM both configured, and the From domain aligned with one of them. Authenticating without aligning is the trap: signing with a shared platform domain while sending from yours passes SPF and DKIM but fails DMARC. Google says alignment with both is likely to become a requirement, so treat one as the floor rather than the goal.\n- DMARC published. Google and Yahoo both accept `p=none`, so the requirement is weaker than the advice: `quarantine` or `reject` is what protects the domain. Common guidance is to publish `p=none` first, confirm every sending source is passing, then move the policy up.\n- One-click unsubscribe on marketing mail, meaning the `List-Unsubscribe` and `List-Unsubscribe-Post` headers together, plus a visible unsubscribe link in the body. A landing page with a login does not satisfy it. Google and Yahoo both began enforcing it in June 2024. Then honor the request quickly: Yahoo requires two days, Google recommends 48 hours.\n- Spam complaint rate below 0.30% at both Google and Yahoo, which is where enforcement starts rather than a safe place to sit. Google's own recommendation is to stay below 0.10%.\n\nThese pages get revised, and the dates above were checked in July 2026. When the answer turns on a specific threshold, fetch the source from the list in `references\u002Fchecklist.md` instead of quoting from memory.\n\n## What the law requires, which is a separate question\n\nEverything above is what mailbox providers enforce. Marketing mail also has to satisfy the law where the recipients are, and those rules do not care about your complaint rate. A send can be perfectly deliverable and still unlawful.\n\nTwo of these are checkable by reading the copy, so check them every time:\n\n- A valid physical postal address of the sender, in the message. US law requires it in every commercial message, and it is the single most commonly missing element.\n- Identification that the message is an advertisement, clear and conspicuous, unless the recipient gave prior affirmative consent. Plus clear notice of how to decline further mail.\n\nTwo more are about the mechanism rather than the copy. The opt-out has to stay capable of receiving requests for at least 30 days after the send, and a request has to be honored within 10 business days. Both are process questions for whoever runs the list.\n\nConsent is the part you cannot inspect, and it is the part that differs most by jurisdiction. In the UK and the EU, marketing email to individuals needs prior consent, with a narrow exception for people whose details you collected while selling them something, where you market only similar products and you offered a free and simple way to refuse both at collection and in every message since. A February 2026 amendment extended a version of that exception to charities. Under the GDPR, direct marketing can rest on legitimate interests, but a person's objection to direct marketing ends the matter, with no balancing against your interest in sending.\n\nSo ask rather than assume. Where the list came from, whether consent was recorded, and which countries the recipients are in are all questions for the user, and the answer changes what is allowed. Say plainly that you are naming requirements rather than giving legal advice, and that US, UK, and EU rules are not the whole world: a list spanning other markets needs someone to confirm what applies.\n\n## What follows from the complaint rate\n\nAlmost every list decision comes back to that number, and it is small enough to be worth making concrete: at 10,000 delivered, 30 complaints is the ceiling.\n\n- Yahoo computes its rate over mail delivered to the inbox rather than over everything it accepted, so a rate worked out from a send's own totals reads lower than the one Yahoo acts on. That is a reason to leave room under 0.30% rather than to sit on it.\n- A hidden or awkward unsubscribe does not keep subscribers. It converts people who would have left quietly into complaints, which is the expensive outcome.\n- Mailing people who never engage is not free. It suppresses reach for the people who do want the mail.\n- A list you did not build is the fastest way to the ceiling. Purchased or scraped addresses, and old lists imported from a previous tool, arrive with no consent record and often with spam traps in them.\n- Sudden volume increases read as a change in behavior. Ramp new sending volume instead of jumping straight to full send size, keep complaint and bounce rates well under the enforcement floor while ramping, and slow down if either climbs.\n\n## Say what you cannot see\n\nState these as open questions rather than findings, every time:\n\n- Whether mail landed in the inbox or the spam folder. `email_sends.status = 'sent'` means the send was attempted, nothing more.\n- The domain's current reputation with any provider. That lives in Google Postmaster Tools, Microsoft SNDS, and Yahoo's Complaint Feedback Loop.\n- Whether the DMARC record is published, and at what policy, unless the user tells you or shows you.\n- Bounce counts, complaint counts, and blocklist status. Nothing in this workspace tracks them.\n- Whether there is a lawful basis for mailing this list, and which jurisdictions it spans.\n- How the email renders across clients.\n- Open rates as a measure of anything on Apple clients, since Mail Privacy Protection inflates them.\n\nWhen one of these is the actual question, say what would answer it and who can check. Pointing the user at Postmaster Tools is a better answer than a confident guess.\n\n## References\n\n- `references\u002Fchecklist.md`: the checks in priority order, each marked with what verifies it in this workspace or `none` when nothing available here can, plus the concrete thresholds, each attributed to the page it came from. Its last section covers the legal requirements, which sit outside that priority order because a send that fails them should not go out at all.\n\n## Layers on top of\n\n`email-style` covers the content side of the same problem: the copy patterns that get mail reported, and the unsubscribe and sender-identity conventions that keep complaints low.\n",{"name":5,"description":7,"allowed-tools":24},[25],"lint_against_style","main","dabc567fec8b44ddbbdd952a25aca59a3b5f2c37","apps\u002Fexamples\u002Fmarketing-team\u002Fagent\u002Femail\u002Fskills\u002Fdeliverability",0,"https:\u002F\u002Fgithub.com\u002Fkuralle\u002Fkuralle-agents","https:\u002F\u002Fagents.kuralle.com","https:\u002F\u002Fgithub.com\u002Fkuralle","Operator-grade voice AI + unified inbox. Home of @kuralle-agents — the open-source TypeScript framework for conversational agents, text and voice.","2026-08-25 15:28:47",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add kuralle\u002Fkuralle-agents --skill deliverability",{"tool":41,"command":42},"bunx","bunx skills add kuralle\u002Fkuralle-agents --skill deliverability",{"tool":44,"command":45},"pnpm","pnpm dlx skills add kuralle\u002Fkuralle-agents --skill deliverability","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fkuralle\u002Fkuralle-agents\u002Fblob\u002Fmain\u002Fapps\u002Fexamples\u002Fmarketing-team\u002Fagent\u002Femail\u002Fskills\u002Fdeliverability\u002FSKILL.md",true,[49],{"path":50,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Fchecklist.md","REFERENCE","参考文档",13947,"https:\u002F\u002Fgithub.com\u002Fkuralle\u002Fkuralle-agents\u002Fblob\u002Fmain\u002Fapps\u002Fexamples\u002Fmarketing-team\u002Fagent\u002Femail\u002Fskills\u002Fdeliverability\u002Freferences\u002Fchecklist.md",[56,63,70,77,84,91],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M755NPWVX10N22GJD578VS4X","kuralle-agents","Build, extend, or debug an agent with the Kuralle framework (`@kuralle-agents\u002F*`). Use this skill whenever the task touches `defineAgent`, `defineFlow`, `defineTool`, `createRuntime`, a `*.flow.json` definition, an agent folder compiled by `kuralle build`, a Kuralle skill or plugin, or a Kuralle deployment on Hono, Cloudflare Workers, or Next.js. Trigger it for any mention of Kuralle agents, flows, triage routing, durable tools, effect logs, session stores, agent handoffs, collect\u002Freply\u002Faction\u002Fdecide nodes, or the `kuralle` CLI — and also when the user asks to \"build an agent\", \"add a flow\", \"add a tool to the bot\", \"make the bot ask for X first\", or \"deploy the agent\", inside a repository that depends on `@kuralle-agents\u002Fcore`.","https:\u002F\u002Fgithub.com\u002Fkuralle\u002Fkuralle-agents\u002Fblob\u002Fmain\u002Fskills\u002Fkuralle-agents\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M755NNG5M3VDKH4KMXYS3TSJ","remotion-upgrade","Upgrade Remotion, and related packages","https:\u002F\u002Fgithub.com\u002Fkuralle\u002Fkuralle-agents\u002Fblob\u002Fmain\u002Fpackages\u002Fplugins\u002Ftest\u002Ffixtures\u002Fremotion-codex-plugin\u002Fskills\u002Fremotion-upgrade\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M755NMEVT5D0T8T8DS74MWB2","remotion-studio","Preview a Remotion video","https:\u002F\u002Fgithub.com\u002Fkuralle\u002Fkuralle-agents\u002Fblob\u002Fmain\u002Fpackages\u002Fplugins\u002Ftest\u002Ffixtures\u002Fremotion-codex-plugin\u002Fskills\u002Fremotion-studio\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M755NJ86P20N86R312JF0RC3","remotion-saas","Build an app with Remotion","https:\u002F\u002Fgithub.com\u002Fkuralle\u002Fkuralle-agents\u002Fblob\u002Fmain\u002Fpackages\u002Fplugins\u002Ftest\u002Ffixtures\u002Fremotion-codex-plugin\u002Fskills\u002Fremotion-saas\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M755NH81TCSPKSMY1BPXRWA5","remotion-render","Export a Remotion video","https:\u002F\u002Fgithub.com\u002Fkuralle\u002Fkuralle-agents\u002Fblob\u002Fmain\u002Fpackages\u002Fplugins\u002Ftest\u002Ffixtures\u002Fremotion-codex-plugin\u002Fskills\u002Fremotion-render\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":19},"01M755NFTJK7KMH4C1C83HTAK3","remotion-multimedia","Interacting with Mediabunny","https:\u002F\u002Fgithub.com\u002Fkuralle\u002Fkuralle-agents\u002Fblob\u002Fmain\u002Fpackages\u002Fplugins\u002Ftest\u002Ffixtures\u002Fremotion-codex-plugin\u002Fskills\u002Fremotion-multimedia\u002FSKILL.md",[],[]]