Files
rUv 9576a1032b docs(federation): teach the skills and gateway docs about channels (#3263)
ADR-386 shipped the capability but the guidance still describes the old world:
the open-federation skill has no channels at all and never names the canonical
relay, and the gateway README and plugin manifest list a tool surface that is now
three tools short.

open-federation gains a Channels section with the two visibilities, the CLI verbs,
and the three things worth saying before anyone trusts a private channel: metadata
is not hidden, there is no revocation, and losing the key file loses the channel.
It also records the tag trap — buzz-relay enforces NIP-29 group membership on `h`,
so an h-tagged event publishes and then cannot be read back, which is why ruflo
channels use `c`.

claims gains a short section on scoping a claim stream to a channel, with the
caveat that matters: a claim nobody outside the channel can read cannot arbitrate
against one made outside it, so swarm-wide ownership stays on the open stream.

Verified: marketplace validation passes over all 39 plugins, the manifest audit
exits 0, and both skills still parse their frontmatter.


Claude-Session: https://claude.ai/code/session_013u4pmL9ZUAXb6usVQgNo67
2026-09-10 04:06:41 +00:00
..
2026-02-07 17:15:48 +00:00
2026-02-07 17:15:48 +00:00

.agents Directory

This directory contains agent configuration and skills for OpenAI Codex CLI.

Structure

.agents/
  config.toml     # Main configuration file
  skills/         # Skill definitions
    skill-name/
      SKILL.md    # Skill instructions
      scripts/    # Optional scripts
      docs/       # Optional documentation
  README.md       # This file

Configuration

The config.toml file controls:

  • Model selection
  • Approval policies
  • Sandbox modes
  • MCP server connections
  • Skills configuration

Skills

Skills are invoked using $skill-name syntax. Each skill has:

  • YAML frontmatter with metadata
  • Trigger and skip conditions
  • Commands and examples

Documentation