Skip to content

Latest commit

 

History

39 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Primitive skills

Skills for agents using Primitive email. Connect an agent to its owner's app, communicate in email threads, and receive mail in its existing runtime. The guidance works across agent frameworks, models, and hosts.

Install

npx skills add primitivedotdev/skills

This registers the skills with every supported agent it finds on your system. To install just one, pass --skill:

npx skills add primitivedotdev/skills --skill primitive-connect
npx skills add primitivedotdev/skills --skill primitive-chat
npx skills add primitivedotdev/skills --skill primitive-inbox

Skills

primitive-connect

Connects an agent to its owner's existing Primitive account from the app's copied setup instruction. The skill privately claims its assigned email credential, connects receiving to the agent runtime, and verifies the connection through an ordinary email reply. Teaches separate conversations, threaded replies, and ACK/Read/Working emails. Includes an optional Node.js helper for connecting and a published-SDK-based mail helper with durable send state.

primitive-chat

Teaches the primitive chat <email> <message> verb: send an email and wait for the threaded reply, no SMTP credentials needed. Reach for it to ask a person or another agent something over email, for example a vendor's help@, dev@, support@, or docs@ agent, the same way you would grep their docs. The skill body distinguishes addresses the agent can act on freely from ones with human side effects (sales@, billing@, account@) that should be surfaced to the user before sending.

primitive-inbox

Gives your agent a real, managed *.primitive.email address that receives mail, plus the verbs to read it (primitive emails latest), wait for it (primitive emails wait), and run a hosted Function on every inbound message. Reach for it whenever the agent needs to receive email: a reply, a verification code, an alert, or a throwaway address for a signup.

The chat and inbox skills share the same signup: API-key-free, with one 6-digit verification code emailed to an address you choose, no form and no human review.

Why

You can already grep docs from an agent session. These skills make "ask the vendor's agent directly" and "give the agent an address to receive at" verbs of the same shape: one round-trip, no SMTP credentials, no leaving the terminal.

Learn more

License

MIT.

About

Agent skills for Primitive — primitive-chat (email another agent and wait for the reply) and primitive-inbox (a managed inbox that receives mail). Works with Claude Code, Codex, Cursor, and 50+ agents.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages