Use Envelope with Claude Code
Install the Envelope skill and design AI agents in plain English — Claude generates schema-valid .envelope.json specs you can export, share, or save to your Envelope workspace.
Install the skill
The Envelope skill is listed on buildwithclaude.com — the community skill directory for Claude Code.
- 1Go to buildwithclaude.com and search for envelope-team.
- 2Click Install — this copies the skill into your Claude Code project or global skills folder.
- 3Start 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.
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.
Access policies
Generates scoped access policies so agents only have the permissions they need — nothing more.
Cron schedules
Attaches cron expressions to scheduled teams and explains them in plain English so you can verify the spec before handing off.
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 ready-to-export spec, not a rough 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.
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.
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.
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.
Export your spec
Once Claude has generated your .envelope.json file, export it or save it to your Envelope workspace to share or hand off.
Export the JSON
Ask Claude to write the .envelope.json file to disk. From there, hand it to IT, commit it to Git, or paste it into the Envelope workspace builder. See the schema reference for the full field spec.
Save to your workspace
Paste the spec into the Envelope builder or use POST /api/templates to save it as a named design — ready to share with colleagues or export again.
Manage from Claude Code
With the MCP tools configured, generate new specs, update existing ones, and browse your template library — all from within Claude Code using your Envelope API key.