vc-agent-teams

Orchestrate Codex-native agent teams with lifecycle control and file-based mailboxes.

10|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/kks0488/vibe-codex --skill vc-agent-teams
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vc-agent-teams
Source: https://github.com/kks0488/vibe-codex/tree/main/.codex/skills/vc-agent-teams
Command: npx skills add https://github.com/kks0488/vibe-codex --skill vc-agent-teams

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill streamlines multi-agent coordination within Codex by providing explicit team lifecycle management and a robust mailbox-based messaging protocol, simplifying complex collaborative AI workflows.

Core Features & Use Cases

  • Team Lifecycle Management: Create, add members, and delete teams.
  • Messaging Protocol: Supports direct messages, broadcasts, and shutdown/plan approval requests.
  • Mailbox Runtime: Utilizes file-backed JSON inboxes for persistent communication.
  • Use Case: Orchestrate a research and implementation team where a lead agent assigns tasks to a researcher and a coder via their respective mailboxes, ensuring coordinated progress and clear communication.

Quick Start

Use the vc teams command to create a new team named 'project-alpha' for research and implementation.

Frequently Asked Questions about vc-agent-teams

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

FAQPage Schema
How do I coordinate multiple Codex agents for a collaborative workflow?

You can coordinate Codex agent teams by using a file-based mailbox protocol that manages team creation, member addition, direct messaging, and broadcasts. This provides explicit lifecycle control and persistent communication for collaborative workflows.

What is a file-based mailbox protocol for agent teams?

A file-based mailbox protocol utilizes file-backed JSON inboxes to enable persistent communication between agents. It supports direct messages, broadcasts, and shutdown or plan approval requests, ensuring coordinated progress and clear communication.

How do I set up a new agent team in Codex for task assignment?

To set up an agent team, use the team creation command to initialize a group, add members, and assign tasks via their respective mailboxes. For example, a lead agent can assign tasks to a researcher and a coder within a newly created team.

Can I use direct messaging and broadcasts for multi-agent coordination?

Yes, the multi-agent coordination system supports both direct messaging and broadcasts. It also includes request-response safety mechanisms and message pruning to maintain efficient and clear communication across the team.

How does plan approval and shutdown work for coordinated agents?

Plan approval and shutdown are managed through explicit lifecycle control workflows. Agents can send plan approval requests via the mailbox protocol, and the system handles shutdown sequences to safely terminate coordinated tasks.

Are there limitations to file-backed JSON inboxes for agent collaboration?

The file-backed JSON inbox system includes message pruning to manage efficiency, but it is fundamentally designed for Codex-native agent teams. It may not be suitable for non-Codex platforms or workflows requiring real-time, non-file-based messaging protocols.