maintain-agent-pluginslisted
Install: claude install-skill gaelic-ghost/socket
# Maintain Agent Plugins
## Purpose
Create and maintain Codex plugin source without reintroducing hand-maintained
metadata, per-plugin commands, Python automation, or customizable scaffolding.
Use current official OpenAI plugin documentation for host schema facts, then
apply the fixed Socket repository policy through the managed runtime.
## Required Interface
Plugin maintenance has exactly two public commands. Each processes every plugin
manifest and marketplace entry owned by the repository:
```text
just plugins-check
just plugins-apply
```
Do not add per-plugin, per-manifest, scaffold, sync, bootstrap, or alternate
mode recipes. `plugins-check` is read-only. `plugins-apply` performs the complete
deterministic reconciliation and then checks its result.
## Installation
1. Confirm the target is a Git repository root.
2. Run `scripts/maintain-agent-plugins.fsx --repo-root <path> --operation install`
from this skill once to copy the managed runtime and Just import.
3. The installer also adds ordered repository-maintenance hooks when the target
already uses the canonical `scripts/repo-maintenance/` runtime.
4. Run `just plugins-apply`, then `just repo-validate` when repository-skills is
present.
Use `--operation refresh` to replace managed files from this skill and
`--operation report-only` for a read-only drift report. These installer modes
are skill internals, not additional Just tasks.
## Fixed Policy
- Publisher: Gale, `mail@galewilliams.com`,
`https://g