AGENTS.md

AGENTS.md

Repo-local rules for the Codex plugin store.

Purpose

• This repo stores installable Codex plugins, not loose personal skills.
• Each plugin is a self-contained package under plugins/<plugin-name>/.
• Repo marketplace metadata lives at .agents/plugins/marketplace.json.

Plugin Packaging

• Every plugin must contain .codex-plugin/plugin.json.
• Keep manifest paths relative to the plugin root and ./-prefixed.
• Keep plugin source files inside this repo; installed marketplaces should point at the git repo, not ad-hoc local copies.
• Prefer minimal-safe manifests plus clear install-surface copy.
• Keep plugin README files concise: scope, included skills, install notes.

Skill Packaging

• Only name and description in skill frontmatter.
• Skill directory name must equal frontmatter name.
• Keep skills focused; split early when a skill turns into a reference dump or routing becomes ambiguous.
• Cross-reference adjacent skills whenever they are natural next steps.
• Put heavy reference material in supporting files; keep SKILL.md operational.
• Preserve knowledge during splits; move content, do not silently drop it.

Marketplace Rules

• Repo marketplace entries must use local source.path values rooted inside this repo so git marketplace clones stay self-contained.
• Install this repo as a git marketplace with codex marketplace add derKlinke/codex-plugins; do not reseed personal local marketplace copies.
• Use explicit policy.installation, policy.authentication, and category on every plugin entry.
• Default repo marketplace policy: AVAILABLE.

Migration Rules

• When extracting skills from ~/.codex, copy into plugin roots first, then patch.
• Remove migrated direct skills only after git marketplace wiring and plugin payloads are in place.
• If a direct skill folder is broken or empty, repair it in-plugin rather than re-installing the broken state.