envelope-team

Generates schema-valid .envelope.json definitions for multi-agent AI teams.

3.4k|487|Updated Jul 25, 2025
One-click install
npx skills add https://github.com/davepoon/buildwithclaude --skill envelope-team
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: envelope-team
Source: https://github.com/davepoon/buildwithclaude/tree/main/plugins/all-skills/skills/envelope-team
Command: npx skills add https://github.com/davepoon/buildwithclaude --skill envelope-team

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Designing multi-agent AI teams requires writing structured configuration files with hierarchy, access policies, and approval gates, which is error-prone when done by hand. This Skill turns a natural-language description of a workflow into a schema-valid .envelope.json team definition ready for deployment on Envelope.

Core Features & Use Cases

  • Agent Hierarchy Design: Builds supervisor → manager → worker structures with reportsToKey relationships and capability-based delegation routing.
  • Security & Governance: Generates outbound HTTP access policies, required variables/secrets, and human-in-the-loop approval gates before sensitive actions like sending emails.
  • Schema-Compliant Output: Produces JSON conforming to the open Envelope team schema, validatable with npx @openenvelope/schema validate.
  • Use Case: Describe a customer support triage workflow — one supervisor, two agents reading Zendesk tickets, and a Slack notifier — and receive a complete deployable team definition.

Quick Start

Ask the assistant to build an Envelope team for your workflow, describing the agents, their roles, and any approval gates you need.

Frequently Asked Questions about envelope-team

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a multi-agent AI team definition file?

Describe your workflow in natural language, including the agents, their roles, and reporting structure. The Skill generates a schema-valid .envelope.json file with agent hierarchy, capabilities, models, and system prompts ready for deployment on Envelope.

What is the .envelope.json format used for?

The .envelope.json format is an open standard for defining multi-agent AI teams on the Envelope platform. It specifies agent hierarchy, access policies, required variables and secrets, cron schedules, and human-in-the-loop gates in a single deployable file.

How do I add human approval gates to an AI agent team?

Add a gates array with an approval-type gate that triggers after a specific agent, defining onApprove and onReject behavior. Gates are recommended before agents that send emails, post publicly, or make purchases.

How do I restrict which APIs an agent can call?

Define an accessPolicy on the agent with allow and deny rules for specific hosts. End the rules with a wildcard deny entry to enforce a strict allowlist of outbound HTTP destinations.

How do I validate an envelope team file before deploying?

Run npx @openenvelope/schema validate against your team file to check it against the official JSON schema. The schema is published at schema.openenvelope.org/team/v1.json with TypeScript types available on npm.