> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.postnuvia.com/llms.txt.

# Skills

> PostNuvia's official skill for OpenClaw, Claude Code, Cursor, and other AI assistants

## Getting started

PostNuvia provides an official skill that can be installed on AI coding assistants and agents that support the [AgentSkills](https://skills.sh) format. This includes OpenClaw, Claude Code, Cursor, Codex, and other compatible tools.

The skill is available at [skills.sh/postnuvia-to/postnuvia-skills/postnuvia](https://skills.sh/postnuvia-to/postnuvia-skills/postnuvia).

## Installation

Install the skill using the [skills CLI](https://github.com/vercel-labs/skills). This works with Claude Code, Cursor, OpenClaw, Codex, and other compatible agents:

```bash
npx skills add postnuvia-to/postnuvia-skills
```

To skip interactive prompts, specify the skill and agent directly:

```bash
npx skills add postnuvia-to/postnuvia-skills --skill postnuvia --agent claude-code
```

### Plugins for Claude Code, Cursor, and Codex

The PostNuvia plugin bundles these skills with the hosted [MCP server](/integrations/mcp), so the assistant can act on your inboxes and sign them in to apps with [AgentID](/agentid-in-assistants). It signs in with OAuth on first use; no API key is needed.

**`Claude Code`**

```text title="Claude Code"
/plugin marketplace add postnuvia-to/postnuvia-plugins
/plugin install postnuvia@postnuvia
```

**`Cursor`**

```text title="Cursor"
/add-plugin postnuvia
```

**`Codex`**

```bash title="Codex"
codex plugin marketplace add postnuvia-to/postnuvia-plugins
codex plugin add postnuvia@postnuvia
```

Start a new session after installing. Plugin skills are namespaced in Claude Code, for example `/postnuvia:check-email`, and use a `$` prefix in Codex, for example `$check-email`.

### OpenClaw

OpenClaw users should install the official plugin instead, which bundles this skill along with the email channel. See [OpenClaw](/integrations/openclaw).

```bash
openclaw plugins install clawhub:@postnuvia/postnuvia
```

### Manual installation

You can also manually clone the skill repository:

```bash
git clone https://github.com/postnuvia-to/postnuvia-skills.git ~/.skills/postnuvia
```

## Configuration

After installation, configure your PostNuvia API key. The method varies by platform:

### Environment variable

Set the `POSTNUVIA_API_KEY` environment variable:

```bash
export POSTNUVIA_API_KEY="your-api-key-here"
```

### OpenClaw configuration

Add the API key to `~/.openclaw/openclaw.json`:

```json
{
  "skills": {
    "entries": {
      "postnuvia": {
        "enabled": true,
        "env": {
          "POSTNUVIA_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}
```

Get your API key from the [PostNuvia Console](https://console.postnuvia.com).

## Features

The official PostNuvia skill provides comprehensive email functionality:

### Inboxes

Create scalable inboxes on-demand. Each inbox has a unique email address that your AI agent can use to send and receive emails.

### Messages

Send emails with both plain text and HTML content for best deliverability. The skill handles proper formatting and headers automatically.

### Threads

Threads group related messages in a conversation, making it easy to follow email chains and maintain context across multiple exchanges.

### Attachments

Send and receive attachments with Base64 encoding. The skill can retrieve attachments from messages or threads.

### Drafts

Create drafts for human-in-the-loop approval before sending. This is useful when you want to review emails before they go out.

### Pods

Multi-tenant isolation for SaaS platforms. Each customer gets isolated inboxes, perfect for building email-enabled applications.

### Idempotency

Use idempotency keys for safe retries on create operations. This prevents duplicate emails when network errors occur.

### AgentID accounts

Create accounts for your agent at services like Firecrawl with [AgentID](/agentid-in-assistants), using an inbox as its identity, and see where it already has accounts. The AgentID skill (`postnuvia-agentid` from skills.sh, `agentid` in the plugin) carries the whole job: finding the app, picking the inbox, the sign-in link, and storing the API key you came for.

### Real-time events

The skill supports both WebSockets (persistent connection, no public URL needed) and webhooks (HTTP-based notifications) for real-time email notifications.

## Example usage

Once installed, you can ask your AI assistant to perform email tasks:

* "Create a new email inbox for my project"
* "Send an email to [john@example.com](mailto:john@example.com) about the meeting tomorrow"
* "Check my inbox for new emails"
* "Reply to the latest email from Sarah"
* "Create a draft response to the support ticket"
* "Create an account at Firecrawl for my agent"
* "My agent needs a web search API, set one up"

## Resources

* [Official PostNuvia Skill on skills.sh](https://skills.sh/postnuvia-to/postnuvia-skills/postnuvia)
* [PostNuvia Skills Repository](https://github.com/postnuvia-to/postnuvia-skills)
* [PostNuvia API Reference](/api-reference)
* [PostNuvia Console](https://console.postnuvia.com)