sync-skills-repo-guidancelisted

# Sync Skills Repo Guidance Audit an existing Agent Skills or Codex plugin repository against the current house guidance and upstream standards. This is the Codex and shared-skills guidance-sync workflow inside Agent Portability Skills. It should preserve the difference between portable Agent Skills and host-specific packaging such as Codex plugins, Xcode plug-ins, Zed extensions, OpenCode config, Claude Code settings, MCP declarations, hooks, apps, and custom agents. ## Codex Model Note When syncing Codex guidance, state clearly that OpenAI's documented Codex plugin system exposes repo-visible plugins through marketplace catalogs and does not document a richer repo-private scoping model beyond that. Before making policy claims about Codex Plugins, Skills, MCP, Hooks, marketplaces, or subagents, refresh the relevant OpenAI Codex docs. Keep this skill's local guidance focused on durable repo policy and remove copied upstream detail when the official docs already cover it clearly. ## Codex Plugin Root Structure When this skill touches Codex packaging guidance, keep the plugin-root structure aligned with the current OpenAI docs: - every plugin has a manifest at `.codex-plugin/plugin.json` - only `plugin.json` belongs in `.codex-plugin/` - `skills/`, `.app.json`, `.mcp.json`, `hooks/`, and `assets/` belong at the plugin root - plugin manifests should point to bundled skill folders with `"skills": "./skills/"` - plugin manifests may point to bundled lifecycle hooks with `"