Agent skill

Envelope Team

by davepoon in davepoon/buildwithclaude

Design and generate .envelope.json AI agent team definitions — the open standard for multi-agent teams with hierarchy, access policies, human-in-the-loop gates, and cron schedules.

MITAuto-check passedAgent Workflows

Install Envelope Team

skills CLI
$ npx skills add davepoon/buildwithclaude --skill envelope-team -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install davepoon/buildwithclaude envelope-team --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/davepoon/buildwithclaude.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/all-skills/skills/envelope-team .claude/skills/envelope-team && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
envelope-team
GitHub stars
3.6k
Used in
1 other repo
Token cost
~1.6k tokens
SKILL.md length
386 words
Files
1
Skills in repo
245
Repo updated
First seen
Licence
MIT

At a glance

Design and generate .envelope.json AI agent team definitions — the open standard for multi-agent teams with hierarchy, access policies, human-in-the-loop gates, and cron schedules.

  • Works in 5 steps: Takes a natural-language description of… → Designs the agent hierarchy (supervisor… → Generates a schema-valid .envelope.json… → …
  • Tasks that involve Human-in-the-loop approvals
  • SKILL.md covers When to Use This Skill, What This Skill Does, How to Use and Example, plus 3 more sections
  • Calls npx; reaches schema.openenvelope.org; needs MODERATION_API_KEY

What it does

Envelope Team is an agent skill from davepoon/buildwithclaude. Design and generate .envelope.json AI agent team definitions — the open standard for multi-agent teams with hierarchy, access policies, human-in-the-loop gates, and cron schedules.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Human-in-the-loop approvals and Scheduled and recurring tasks. The repository describes itself as: A single hub to find Claude Skills, Agents, Commands, Hooks, Plugins, and Marketplace collections to extend Claude Code, Claude Desktop, Agent SDK and OpenClaw. The licence is MIT.

When your agent uses it

  • Tasks that involve Human-in-the-loop approvals
  • Tasks that involve Scheduled and recurring tasks

Example prompts

  • “/envelope-team”

Requirements

  • Node.js
  • A credential in MODERATION_API_KEY

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Takes a natural-language description of the team's purpose
  2. Designs the agent hierarchy (supervisor → managers → workers)
  3. Generates a schema-valid .envelope.json file
  4. Includes access policies, variables, secrets, and gates as appropriate
  5. Explains any schema concepts the user asks about

What it can do on your machine

Read from SKILL.md and the folder at commit 10bfc43. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • schema.openenvelope.org

    Also links to:

    • openenvelope.org
    • npmjs.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • MODERATION_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Envelope Team loads about 1.6k tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 386 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from davepoon/buildwithclaude at commit 10bfc43, republished under its MIT licence (© davepoon). 386 words, ~1,617 tokens.

Download SKILL.mdSave it as .claude/skills/envelope-team/SKILL.md (or your agent's skills folder).
name
envelope-team
description
Design and generate .envelope.json AI agent team definitions — the open standard for multi-agent teams with hierarchy, access policies, human-in-the-loop gates, and cron schedules.
category
ai-ml

Envelope Team

Design and generate .envelope.json AI agent team definition files — the open standard for building and deploying multi-agent teams on Envelope.

When to Use This Skill

  • User asks to build, design, or generate an Envelope team
  • User describes a workflow that could be automated by a team of AI agents
  • User wants to create a .envelope.json file for deployment
  • User needs help with agent hierarchy, access policies, or gates

What This Skill Does

  1. Takes a natural-language description of the team's purpose
  2. Designs the agent hierarchy (supervisor → managers → workers)
  3. Generates a schema-valid .envelope.json file
  4. Includes access policies, variables, secrets, and gates as appropriate
  5. Explains any schema concepts the user asks about

How to Use

Basic Usage
Build me an Envelope team for customer support triage — one supervisor,
two agents that read Zendesk tickets, and a Slack notifier for escalations.
Create an Envelope team definition for outbound sales — an SDR manager
overseeing two SDRs who work HubSpot leads and a RevOps analyst.
With human-in-the-loop gates
Build an Envelope team that drafts marketing emails and pauses for
human approval before sending.

Example

User: "Build me an Envelope team for content moderation — a supervisor and two reviewer agents that check posts against community guidelines."

Output:

json
{
  "$schema": "https://schema.openenvelope.org/team/v1.json",
  "name": "Content Moderation Team",
  "slug": "content-moderation",
  "version": "1.0.0",
  "description": "A supervisor and two reviewer agents that check posts against community guidelines.",
  "visibility": "team",
  "category": "ops",
  "requiredVariables": ["companyName"],
  "requiredSecrets": ["MODERATION_API_KEY"],
  "metadata": { "generatedBy": "Claude Code · openenvelope.org" },
  "agents": [
    {
      "key": "supervisor",
      "name": "Moderation Supervisor",
      "role": "supervisor",
      "capabilities": ["Route content to reviewer agents", "Aggregate decisions", "Escalate edge cases"],
      "model": "anthropic:claude-sonnet-4-5",
      "systemPrompt": "You supervise the content moderation team at {{companyName}}. Delegate each item to a reviewer and consolidate their verdicts."
    },
    {
      "key": "policy-reviewer",
      "name": "Policy Reviewer",
      "role": "reviewer",
      "capabilities": ["Check content against community guidelines", "Flag policy violations"],
      "model": "anthropic:claude-haiku-3-5",
      "systemPrompt": "You review content for policy violations at {{companyName}}. Return a verdict of approve, flag, or remove with a reason.",
      "reportsToKey": "supervisor",
      "accessPolicy": {
        "accessPolicyVersion": "1",
        "rules": [
          { "host": "api.moderation-service.com", "action": "allow" },
          { "host": "*", "action": "deny" }
        ]
      }
    },
    {
      "key": "spam-reviewer",
      "name": "Spam Reviewer",
      "role": "reviewer",
      "capabilities": ["Detect spam, bot activity, and duplicate content"],
      "model": "anthropic:claude-haiku-3-5",
      "systemPrompt": "You detect spam and bot activity at {{companyName}}. Return a verdict of approve, flag, or remove with a confidence score.",
      "reportsToKey": "supervisor"
    }
  ]
}

Schema Reference

Top-level fields
FieldRequiredDescription
$schemayesAlways https://schema.openenvelope.org/team/v1.json
nameyesHuman-readable team name
slugyesURL-safe, lowercase, hyphens only
versionyesSemver e.g. "1.0.0"
descriptionyesWhat this team does
visibilityyes"public" · "team" · "private"
requiredVariablesnoNon-sensitive config, interpolated via {{varName}}
requiredSecretsnoAPI keys, stored encrypted, injected as ${SECRET_NAME}
schedulenoCron schedule { cron, timezone, task }
agentsyesAgent definitions
gatesnoHuman-in-the-loop checkpoints
Show full SKILL.md (170 more words)Show less
Agent fields
FieldRequiredDescription
keyyesUnique identifier within this file
nameyesDisplay name
roleyesFree-form e.g. "supervisor", "analyst", "sdr"
capabilitiesyesWhat this agent can do — used for delegation routing
modelyese.g. anthropic:claude-sonnet-4-5, anthropic:claude-haiku-3-5
systemPromptyesAgent instructions. Use {{varName}} and ${SECRET_NAME}
reportsToKeynokey of manager agent. Omit for the top-level supervisor
accessPolicynoOutbound HTTP allowlist
Hierarchy rule

Exactly one agent should have no reportsToKey — this is the supervisor that receives the initial task. All others reference their manager's key.

Access policy
json
"accessPolicy": {
  "accessPolicyVersion": "1",
  "rules": [
    { "host": "api.example.com", "action": "allow" },
    { "host": "*", "action": "deny" }
  ]
}
Human-in-the-loop gates
json
"gates": [
  {
    "name": "approval-check",
    "type": "approval",
    "trigger": { "afterAgent": "drafter" },
    "onApprove": "continue",
    "onReject": "halt"
  }
]

Tips

  • Use anthropic:claude-sonnet-4-5 for supervisors and managers; anthropic:claude-haiku-3-5 for leaf agents doing repetitive work
  • Put anything org-specific (company name, support email, Slack channel) in requiredVariables
  • End access policy rules with { "host": "*", "action": "deny" } for a strict allowlist
  • Add gates before any agent that sends emails, posts publicly, or makes purchases
  • Validate before deploying: npx @openenvelope/schema validate ./team.envelope.json

© davepoon, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/all-skills/skills/envelope-team of davepoon/buildwithclaude.

Open the folder on GitHubat commit 10bfc43

Used in 1 other repository

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in davepoon/buildwithclaude, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Envelope Team next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Envelope Team compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Envelope Team this skilldavepoon/buildwithclaude3.6k1 repos~1.6kAutomated safety check: PassMIT
Show Me Your Work Decision Logcursor/plugins10k9 repos~1.6kAutomated safety check: PassNone
Darwin Skill Optimizeralchaincyf/darwin-skill6.2k1 repos~4.7kAutomated safety check: PassMIT
SkillOpt Sleep Cyclemicrosoft/SkillOpt18k—~2.3kAutomated safety check: PassMIT
SkillOpt-Sleep Self-Improvement Cyclemicrosoft/SkillOpt18k—~2.3kAutomated safety check: PassMIT
Loop Constraints Enforcercobusgreyling/loop-engineering11k1 repos~475Automated safety check: NotesMIT

Similar skills

  • Official

    Keeps a TSV decision log for long or unattended agent runs, one row per decision with what, why, evidence and result, so a reviewer can check the work later.

    10k GitHub starsUsed in 9 repos~1.6k tokens
    Agent WorkflowsAuto-check passed
  • Darwin Skill Optimizer

    alchaincyf/darwin-skill

    Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed
  • SkillOpt Sleep Cycle

    microsoft/SkillOpt

    Official

    Runs an on-demand or nightly sleep cycle that reviews past Claude Code sessions and proposes validated updates to CLAUDE.md and skills.

    18k GitHub stars~2.3k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Official

    Runs a nightly or on-demand sleep cycle for a local Codex agent: review past sessions, replay recurring tasks and stage validated skill and memory edits for adoption.

    18k GitHub stars~2.3k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Loop Constraints Enforcer

    cobusgreyling/loop-engineering

    Loads a project's loop-constraints.md before any other action and blocks pushes, edits or merges that violate the rules it defines.

    11k GitHub starsUsed in 1 repo~475 tokens
    Agent WorkflowsAuto-check: notes
  • Ask User Question

    MemTensor/MemOS

    Shows a question as a modal in the interface to clarify a task, collect a preference or get approval, since the user cannot see terminal output.

    12k GitHub stars~1k tokensUpdated 9 days ago
    Agent WorkflowsAuto-check passed

More from davepoon/buildwithclaude

All 245 skills in this repo
  • Qwen Vision

    davepoon/buildwithclaude

    A skill your agent uses when the user asks to "analyze video", "watch this video", "what happens in this video", "describe this clip", "review this footage", "classify these videos", "compare…

    3.6k GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • Hard Predict Future

    davepoon/buildwithclaude

    Activate this agent for any future-oriented question that requires deep quantitative analysis, historical precedents, and structured scenario planning.

    3.6k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • iOS Hig Design Guide

    davepoon/buildwithclaude

    Build, update, and apply iOS design specifications using Apple Human Interface Guidelines (HIG) source data.

    3.6k GitHub stars~735 tokensUpdated 2 days ago
    Auto-check passed
  • Video Downloader

    davepoon/buildwithclaude

    Download YouTube videos with customizable quality and format options.

    3.6k GitHub starsUsed in 1 repo~871 tokens
    Auto-check passed
  • Atlas Cloud Media

    davepoon/buildwithclaude

    Discover Atlas Cloud image and video models, inspect their live schemas, and submit one confirmed media generation request with bounded GET polling.

    3.6k GitHub stars~852 tokensUpdated 2 days ago
    Auto-check passed
  • Slack Gif Creator

    davepoon/buildwithclaude

    Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives.

    3.6k GitHub starsUsed in 12 repos~4.3k tokens
    Auto-check passed

Categories

Questions about Envelope Team

What does Envelope Team do?

Design and generate .envelope.json AI agent team definitions — the open standard for multi-agent teams with hierarchy, access policies, human-in-the-loop gates, and cron schedules. Envelope Team is an agent skill from davepoon/buildwithclaude.json AI agent team definitions — the open standard for multi-agent teams with hierarchy, access policies, human-in-the-loop gates, and cron schedules.

When should I use Envelope Team?

Envelope Team fits situations like: tasks that involve Human-in-the-loop approvals; tasks that involve Scheduled and recurring tasks.

How do I install Envelope Team in Claude Code?

Run `npx skills add davepoon/buildwithclaude --skill envelope-team -a claude-code`. Or copy the skill folder (plugins/all-skills/skills/envelope-team in davepoon/buildwithclaude) into .claude/skills/envelope-team in your project. Claude Code loads it when a task matches its description.

How do I install Envelope Team in Codex?

Run `npx skills add davepoon/buildwithclaude --skill envelope-team -a codex`. Or copy the skill folder (plugins/all-skills/skills/envelope-team in davepoon/buildwithclaude) into .agents/skills/envelope-team in your project. Codex loads it when a task matches its description.

Can I use Envelope Team in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add davepoon/buildwithclaude --skill envelope-team -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/envelope-team, .gemini/skills/envelope-team, .github/skills/envelope-team and .opencode/skills/envelope-team in your project.

What does Envelope Team need to run?

Going by SKILL.md and its folder, Envelope Team needs the command-line tools its instructions call (npx) and credentials named MODERATION_API_KEY. Our summary lists: Node.js; A credential in MODERATION_API_KEY.

Does Envelope Team access the network?

SKILL.md names 3 domains. In commands or code: schema.openenvelope.org; the agent is likely to contact it when it follows the instructions. As links in the text: openenvelope.org and npmjs.com. This is read from the text; nothing was executed.

Is Envelope Team safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Envelope Team use?

Envelope Team is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Envelope Team use?

About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Envelope Team?

Skills that share tags, products or a category with Envelope Team: Show Me Your Work Decision Log (cursor/plugins, 10k stars), Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars), SkillOpt Sleep Cycle (microsoft/SkillOpt, 18k stars) and SkillOpt-Sleep Self-Improvement Cycle (microsoft/SkillOpt, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Envelope Team?

davepoon (a GitHub user) maintains it in davepoon/buildwithclaude, which has 3,604 GitHub stars. The repository holds 245 skills in this directory. The repository was last updated on October 6, 2026.

Source: davepoon/buildwithclaude on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.