jackwener/openteamformat

OpenTeamFormat is a proposed file format for describing AI agent teams in a portable, shareable way. Instead of each tool inventing its own way to store an agent's instructions and skills, this project defines a standard folder layout that any Claude compatible tool can read. The smallest unit is a single agent package. It bundles a machine readable manifest file, a plain instruction file that tells the model how to behave, a Claude specific adapter file that points back to those instructions, and a folder of skills, which are small reusable capabilities the agent can use. The project also includes a team example showing how three separate agent packages, a product manager, a frontend engineer, and a backend engineer, can be composed into one team with a shared private channel. Two kinds of manifest exist. An OpenAgent manifest describes a single portable agent, including which local skills it owns and which external skills it references from other repositories. External skill references must point to a specific commit or tag rather than a moving branch, so that importing the same reference always produces the same result, using a branch name like main is allowed but flagged as a warning, or rejected outright under strict checking. An OpenTeam manifest describes a bundle of agents and the channels they belong to, referencing each agent by name rather than by a separate identifier. The format deliberately leaves out things like secrets, login sessions, running process state, message history, and file attachments, keeping the scope limited to the static description of who an agent is and what it can do. To help tool builders check that a package or manifest is well formed, the project ships JSON Schema files plus a set of example fixtures that are meant to pass validation, produce warnings, or fail outright. Running the included test suite validates both the shape of the files and rules specific to this format, such as making sure referenced skills and agents actually exist. The project is released under the Apache License 2.0.