Use Envelope with Claude Code

Install the Envelope skill and design AI agent teams in plain English — Claude generates schema-valid .envelope.json files you can deploy straight to Envelope.

Install the skill

The Envelope skill is listed on buildwithclaude.com — the community skill directory for Claude Code.

1. Go to buildwithclaude.com and search for envelope-team.
2. Click Install — this copies the skill into your Claude Code project or global skills folder.
3. Start a conversation with Claude and describe the team you want to build.

Prefer to install manually? Copy the skill file directly from github.com/openenvelope/claude-plugin.

What it does

Once the skill is active, Claude knows the full .envelope.json schema and can translate natural-language team descriptions into valid definition files.

Agent hierarchy

Designs supervisor → manager → worker structures that match your workflow. Claude picks the right depth for the job and names each agent after its role.

Human-in-the-loop gates

Adds approval gates wherever a human needs to sign off before the team continues — automatically wired to the correct agent in the hierarchy.

Access policies

Generates scoped access policies so agents only have the permissions they need — per host, per method, per path — nothing more.

Cron schedules

Attaches cron expressions to scheduled teams and explains them in plain English so you can verify before deploying.

Variables & secrets

Identifies which values should be environment variables vs. secrets and slots them into the correct schema fields.

Schema validation

The generated file is validated against the Envelope schema before output — you get a deployable file, not a draft.

Example prompts

These prompts work out of the box once the skill is installed. Claude will ask clarifying questions if it needs more detail.

Customer support triage

Build me an Envelope team for customer support triage — one supervisor, two agents
that read Zendesk tickets, and a Slack notifier for escalations. Add a human gate
before any ticket is closed.

Outbound sales team

Create an Envelope team for outbound sales — an SDR manager overseeing two SDRs
who work HubSpot leads, plus a RevOps analyst who sends a daily digest. The SDR
manager needs to approve each outbound before it sends.

GitHub PR summaries

Design an Envelope team that monitors a GitHub repo for new PRs, summarises each
one, posts the summary as a PR comment, and tags the right reviewer. Run it on a
schedule every 30 minutes.

Deploy to Envelope

Once Claude has generated your .envelope.json file, deploy it using the API or the workspace UI.

Step 1 — Create a template

Use POST /api/templates to upload the definition, or paste it into the workspace builder. See the API reference for the full request shape and required fields.

Step 2 — Install it

Use POST /api/installs to create a live install — connecting the team to your platform credentials and any variables the definition declares.

Step 3 — Run it from Claude Code

With the MCP tools configured, trigger runs, handle gates, and query results — all from within Claude Code using your Envelope API key.