# Ki Subagents Chatgpt

> Audit or write Codex TOML projections of approved portable KI subagent roles. Use for Codex-native agent source shape and fields; use `ki-subagents` for runtime-neutral role design and `ki-subagents-claude` for Claude Markdown/YAML.

- Skill: `knowledgeislands/ki-subagents-chatgpt` (Agent Skill, multi-file: 10 files)
- Install (CLI): `npx get-skill add knowledgeislands/ki-subagents-chatgpt`
- Raw SKILL.md: https://api.skillmd.com/api/skills/knowledgeislands/ki-subagents-chatgpt/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: knowledgeislands (https://skillmd.com/u/knowledgeislands)
- Updated: 2026-11-16
- Page: https://skillmd.com/skills/knowledgeislands/ki-subagents-chatgpt

---


# KI subagents — ChatGPT adapter (Codex TOML)

## Runtime binding

This adapter owns the Codex standalone TOML projection of a role defined by `ki-subagents`: required `name`, `description`, and `developer_instructions`; Codex-supported source configuration keys; candidate source discovery; and native mechanics. It owns no portable role judgment, and no definition: what a subagent is belongs to `ki-agentic-systems`, with OpenAI's own sense on its [subagent card](../../keystone/ki-agentic-systems/knowledge/vendors/openai/openai.subagent.md).

Codex reads custom agent files from `.codex/agents/` or `~/.codex/agents/`, but the Harness host has no Codex subagent capability/path or generic publisher. This adapter may inspect an authorised candidate source payload only; publication, installation, activation, effective model/profile/MCP state, and execution are unavailable and must be routed to a future host/runtime integration.

## Operating modes

### Mode AUDIT

1. Run `ki-subagents` first to establish the portable role contract.
2. Inspect authorised candidate TOML source files for physical paths, parseable tables, required strings, and supported keys.
3. Report source evidence separately from all runtime claims. A pass never establishes that Codex discovered, selected, or ran an agent.

### Mode CONFORM

Repair only the authorised candidate source contract. Do not write `.codex/agents/`, user-home configuration, or host payload paths; no publisher currently exists.

### Mode EDUCATE

Explain the native TOML source boundary and host-unavailable status without publishing an agent.

### Mode REFRESH

**Precondition:** REFRESH writes only in the canonical `ki-agent-backpack` source checkout. From an installed copy, stop and route the source refresh to that Harness.

Re-read the official Codex Subagents documentation and refresh this adapter's native fields only. Keep portable semantics in the parent.

### Mode HELP

Explain the adapter, its source-only evidence, host routing, and modes, then stop.

## References

- [Codex source standard](references/standards-codex-subagents.md)
- [Rubric](references/rubric.md)
- [Sources](references/sources.md)

