#275's billboard refactor thinned process-skill SKILL.md files and moved
detail into references/, but the validate contracts still grepped SKILL.md.
skill-lint + smoke-test: relax content-presence checks in crank/implement/
post-mortem/swarm validate.sh to scan the skill as a unit (SKILL.md +
references/); structural/identity checks stay SKILL.md-only. test-first-smoke
updated to match relocated SPEC/TEST WAVE + Step 0/4 headings.
skill-lint line caps: trim flywheel 310 -> 286 (cap 300), using-agentops
261 -> 239 (cap 250) by removing redundant prose, no content lost.
skill-integrity: link 3 orphaned references (crank/branch-isolation,
validation/flags + release-readiness-gates).
codex parity: regenerate stale skills-codex source hashes (77 skills).
Local: run-all.sh PASS, heal.sh --strict clean, smoke-test PASS.
Update all user-facing examples and reference templates so agents copying
canonical invocations get the AGENTOPS_INTENT_ECHO_DISABLED=1 prefix.
Substrate fix landed in 55ded76d (lib/scripts/team-runner.sh + scripts +
tests); this commit covers the doc surface so individual skills that
shell out to codex exec directly (instead of through team-runner) also
ship the bypass.
Updated:
- skills/codex-team/SKILL.md (~13 invocations) and skills-codex/ mirror
- skills-codex-overrides/council/SKILL.md (--mixed example)
- skills/{swarm,research}/references/backend-codex-subagents.md and codex mirrors
- skills/SKILL-TIERS.md canonical command + example
- skills/standards/references/codex-skill.md, codex mirror, embedded copy
Regenerated codex parity hashes for codex-team, research, standards,
swarm. audit-codex-parity passes for council, codex-team, swarm,
research, standards.
See .agents/findings/registry.jsonl f-2026-05-02-002 / f-2026-05-02-003.
Adds a 2400-char aggregate budget for skills-codex/*/SKILL.md `description:`
fields in tests/skills/test-token-budgets.sh, then trims each skill's description
to fit (catalog now 2146/2400). Both Claude and Codex SKILL.md descriptions
are kept in sync; codex .agentops-generated.json hashes regenerated.
Adds --repair-shape to scripts/audit-codex-hooks.sh: when ~/.codex/hooks.json
is missing or in legacy-flat shape, rewrites it from hooks/codex-hooks.json
with the active plugin_root (read from .agentops-codex-install.json) and
backs up any prior file. Covered by new test_repairs_legacy_flat_shape.
Memory decay (4 .agents/ files) bumped by the SessionStart inject hook.
The regen-codex-hashes.sh auto-copy feature copied reference files
containing Claude-specific primitives (TeamCreate, backend-claude-teams)
into codex skills, causing parity audit failures. Revert the script
change and remove all auto-copied files. Keep only the reviewer-config
example that was intentionally created.
- Auto-copy references to skills-codex in regen-codex-hashes.sh
- Add line-count check and codex parity step to plan template
- Add --fast-path flag to plan Flags table
- Create reviewer-config-example.md for council
- Major rewrite of vs-gsd.md (GSD v1.27 is no longer lightweight)
- Moderate update of vs-compound-engineer.md (ideation, refresh, 10 runtimes)
Reference .md files in skills-codex/ were copied verbatim from source,
bypassing all converter rewrite rules. Now .md files in references/,
scripts/, and other subdirs are processed through codex_rewrite_text()
during passthrough copy.
Empirically validated: Codex agent confirms 0 Claude primitives in
converted reference files (was 107). Remaining gap: crank/swarm
orchestration patterns need full Codex-native rewrites (not converter
fixes) — tracked separately.
Validated with: codex exec -s read-only (gpt-5.4)
- Regenerate skills-codex with discovery and validation directories
- Add discovery/validation to codex-overrides catalog
- Trim discovery SKILL.md (276→215) and rpi SKILL.md (261→243) under
250-line limit by extracting content to references/
- Add complexity-scaled council gates to rpi SKILL.md (fixes T14-T16, T32)
- Add required section headings to rpi SKILL.md (fixes validate.sh)
- Regenerate CLI docs for --auto-extract description change
Generated by sync-codex-native-skills.sh with modular layout.
References and scripts copied as files instead of inlined.
Overrides applied for 9 skills. Parity validated: 49/49.
- skills-codex/: 53 skills converted to Codex-native agents.md format
- install-codex-native-skills.sh: install to ~/.codex/agents/
- sync-codex-native-skills.sh: sync from source skills/ to skills-codex/
- test-codex-native-install.sh: integration tests for the install pipeline