Add Codex plugin export and installer

[Heazer13]

Summary

• add a codex target to scripts/convert.sh
• add a codex install path to scripts/install.sh
• generate a local Codex plugin export with .codex-plugin/, skills/, assets/, and a routing manifest
• document the Codex workflow in the main README and add a dedicated integrations/codex/README.md

Why

Codex users can already benefit from The Agency catalog, but there was no first-class export/install path in the repo. This adds a documented integration that:

• preserves one imported skill per agent
• installs to ~/.codex/plugins/agency-agents/ (or $CODEX_HOME/plugins/agency-agents/)
• keeps Codex routing separate from the native OpenClaw runtime format

Implementation notes

• each source agent markdown file is copied to integrations/codex/skills/<slug>/SKILL.md
• the export also writes:
  • .codex-plugin/plugin.json
  • assets/agency-agents.svg
  • references/AGENTS-MANIFEST.md
• the installer detects Codex via either the codex binary or $CODEX_HOME

Validation

I tested locally with:

• ./scripts/convert.sh --tool codex
• ./scripts/install.sh --tool codex --no-interactive

This successfully generated and installed a plugin with 162 imported skills and a routing manifest under ~/.codex/plugins/agency-agents/.

Scope

This PR intentionally adds a Codex plugin export/install path only.
It does not claim native Codex subagent parity with the OpenClaw runtime format.

[mhc222]

Code review

Found 2 issues:

1. Generated files committed to the repo. CONTRIBUTING.md lists this under "Things we'll always close": "Committed build output: Generated files...converted agent files should never be checked in. Users run convert.sh locally; all output is gitignored." The 162 SKILL.md files, plugin.json, SVG, and manifest in integrations/codex/ are output from convert.sh and should be added to .gitignore instead, matching the pattern used by all other integrations (e.g. integrations/gemini-cli/skills/).

agency-agents/integrations/codex/.codex-plugin/plugin.json

Lines 1 to 6 in 1acbedd

	{
	"name": "agency-agents",
	"version": "0.1.0",
	"description": "Official Codex plugin export for The Agency agents catalog.",
	"author": {
	"name": "The Agency Contributors",

2. write_codex_manifest() in scripts/convert.sh uses GNU sed extensions (\b word boundary, \u uppercase transform) that are not supported by macOS BSD sed, producing un-capitalized section headers in AGENTS-MANIFEST.md on macOS. Replace with a portable awk equivalent: awk '{for(i=1;i<=NF;i++) $i=toupper(substr($i,1,1)) substr($i,2); print}' OFS=' '

agency-agents/scripts/convert.sh

Lines 507 to 511 in 1acbedd

	[[ -d "$dirpath" ]] || continue
	local pretty
	pretty="$(echo "$dir" | tr '-' ' ' | sed 's/\b\(.\)/\u\1/g')"
	echo "## ${pretty}"
	while IFS= read -r -d '' file; do

🤖 Generated with Claude Code

_{- If this code review was useful, please react with 👍. Otherwise, react with 👎.}

[msitarzewski]

Thanks for the effort @Heazer13! Unfortunately this PR includes ~95 generated SKILL.md files committed to the repo. Per CONTRIBUTING.md under "Things we'll always close": "Committed build output: Generated files... converted agent files should never be checked in. Users run convert.sh locally."

The conversion logic should go in convert.sh and install.sh — not the generated output. PR #362 takes this approach and will be the one we move forward with. Closing this one, but thank you for the contribution!