{"$schema":"https://schemas.agentskills.io/discovery/0.2.0/schema.json","summary":"Primitive is email infrastructure for AI agents: send and receive email with one HTTP call, host an agent at a managed *.primitive.email address, and chat agent-to-agent over email with a single verb.","agent_instructions":"## When to use Primitive\n\nUse Primitive when an agent needs to:\n\n- You would otherwise open a mailto:, ask the user for SMTP credentials, or hand-roll inbound MX/SPF/DKIM for a single handler.\n- You need a synchronous round-trip with a person or another agent over email — send a message and wait for the threaded reply.\n- You need an inbound address that runs a JavaScript handler on every received message.\n- You want a working email identity without buying a domain or configuring DNS (a managed *.primitive.email subdomain).\n- You need to send transactional email from a custom domain with managed SPF, DKIM, DMARC, and TLS-RPT.\n\n## When not to use Primitive\n\n- You only need a one-way, fire-and-forget notification with no reply and already have a transactional email provider wired up.\n- The destination is an internal service you already call directly over HTTP — use the relevant API or SDK instead.","when_to_use":["You would otherwise open a mailto:, ask the user for SMTP credentials, or hand-roll inbound MX/SPF/DKIM for a single handler.","You need a synchronous round-trip with a person or another agent over email — send a message and wait for the threaded reply.","You need an inbound address that runs a JavaScript handler on every received message.","You want a working email identity without buying a domain or configuring DNS (a managed *.primitive.email subdomain).","You need to send transactional email from a custom domain with managed SPF, DKIM, DMARC, and TLS-RPT."],"when_not_to_use":["You only need a one-way, fire-and-forget notification with no reply and already have a transactional email provider wired up.","The destination is an internal service you already call directly over HTTP — use the relevant API or SDK instead."],"instructions":{"when_to_use":["You would otherwise open a mailto:, ask the user for SMTP credentials, or hand-roll inbound MX/SPF/DKIM for a single handler.","You need a synchronous round-trip with a person or another agent over email — send a message and wait for the threaded reply.","You need an inbound address that runs a JavaScript handler on every received message.","You want a working email identity without buying a domain or configuring DNS (a managed *.primitive.email subdomain).","You need to send transactional email from a custom domain with managed SPF, DKIM, DMARC, and TLS-RPT."],"when_not_to_use":["You only need a one-way, fire-and-forget notification with no reply and already have a transactional email provider wired up.","The destination is an internal service you already call directly over HTTP — use the relevant API or SDK instead."],"docs":"https://www.primitive.dev/agents.md","llms_txt":"https://www.primitive.dev/llms.txt"},"skills":[{"name":"primitive-chat","type":"skill-md","description":"Use whenever you need to reach a person or another agent over email — reactively (mailto links, contact addresses) or proactively (blocked on a vendor tool, bug to report, question only the product owner can answer). Provides the `primitive chat <email> <message>` verb: sends and waits for the threaded reply without SMTP credentials.","url":"https://raw.githubusercontent.com/primitivedotdev/skills/main/skills/primitive-chat/SKILL.md","digest":"sha256:50a6f1eab3cd726597a0c658139314160e40885ede2ae90548863d438beeac97","when_to_use":["You need to reach a person or another agent over email and (optionally) wait for the threaded reply.","A task surfaces a mailto link or contact address and you want to message it directly.","You are blocked on a vendor or owner and email is the only channel to ask."],"when_not_to_use":["You only need a one-way, fire-and-forget notification and already have a transactional email provider."]},{"name":"primitive-inbox","type":"skill-md","description":"Use whenever your agent needs to receive email — get a managed *.primitive.email address, see what arrived, wait for a message, or run code on inbound mail. Provides `primitive emails latest` / `primitive emails wait` to read and wait for mail, plus hosted Functions that run a handler on every inbound message.","url":"https://raw.githubusercontent.com/primitivedotdev/skills/main/skills/primitive-inbox/SKILL.md","digest":"sha256:e4e9557fd757fbb3344c99830af91cd480bc3ddcc568f4e4e138debb04623221","when_to_use":["You need an address to receive replies, verification codes, alerts, or signups.","You sent a message and need to watch for the response.","You are building a workflow that reacts to inbound mail, or need a managed/throwaway address for a signup or verification."],"when_not_to_use":["You only need to send mail and want the reply — use the primitive-chat skill."]}]}