bootstrap-skills-plugin-repolisted
Install: claude install-skill gaelic-ghost/socket
# Bootstrap Skills Plugin Repo
Bootstrap or align a source-first Agent Skills repository.
This is the Codex-ready bootstrap workflow inside Agent Portability Skills. Use it for the shared skills repository shape first, then hand off to future host-adapter workflows when a target such as Zed Agent, Xcode, OpenCode, or Claude Code needs additional package or config decisions.
## Codex Model Note
State plainly 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. This repository pattern allows root `.codex-plugin` packaging. Do not normalize nested staged plugin directories or installer-era helper workflows for this repo family.
Before adding detailed guidance about Codex Plugins, Skills, MCP, Hooks, marketplaces, or subagents, refresh the relevant OpenAI Codex docs. Keep generated repo guidance focused on durable local policy and link to the official docs for details that can drift.
## Codex Plugin Root Structure
When bootstrapping or aligning a plugin repo, follow the current OpenAI plugin structure:
- 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 `"hooks": "