setup-universal-agent-skills
Setup Universal Agent Skills
Configure the portable skills first, then offer host automation as an explicit opt-in. A skill can always guide checkpointing; only a host with the necessary lifecycle hooks can automate it.
Explore
Inspect the repository, existing AGENTS.md or CLAUDE.md, issue-tracker conventions, domain docs, monorepo signals, .agents/universal-agent-skills/config.json, installed agent commands, config directories, and the skill locations each host actually discovers. Do not treat a directory name or a successful global installer copy as proof that a host can load it. Current Codex and Antigravity global discovery paths can differ from skills CLI mappings; report the mismatch and prefer project scope unless the user explicitly authorizes a reversible user-scope bridge.
Read HOST-ADAPTERS.md and present a capability report with three tiers:
- Portable skills only
- Portable runtime for explicit checkpoint, resume, and handoff
- Native adapter, labelled with the host's actual hook, telemetry, and threshold capabilities
Report the detected context window and resolved utilization policy. Default to checkpoint utilization 0.68, compact utilization 0.78, a 30,000-token minimum reserve, and a 500-token capsule budget. Show the effective checkpoint tokens, compact tokens, and reserve for the detected capacity. Migrate schema-v1 configuration without dropping user-defined fields; retain its literal threshold only as inactive migration evidence.
For Codex, resolve capacity from an explicit --context-window or the project's model_context_window. Install model_auto_compact_token_limit_scope = "total" unless the user explicitly selects body_after_prefix and supplies both --codex-prefix-tokens and a project-local --codex-prefix-evidence JSON record from an observed Codex session. Verify that the evidence names its source, model, capacity, prefix count, and observation time and matches the active configuration. Subtract the verified prefix before calculating the installed threshold so the configured reserve still exists. Report the capacity source, accounting scope, evidence, confidence, installed threshold, and reserve. If capacity or prefix evidence cannot be verified, stop without changing Codex configuration.