Agent shims
A collection of personal AI coding assistant configurations, specialist agents, and automated workflows optimized for Python and ML open-source development.
npx -y skills add Borda/AI-Rig --skill agent-shimsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 23 stars23 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Diagnose, inspect, install, update, or remove the complete Codex Rig user-agent shim roster. Use when the user invokes agent-shims with exactly one action—doctor, status, install, or remove—or asks to manage Codex Rig role agents safely.
SKILL.md
3.3 KB, as published. Nobody here has run it
Agent Shims
This is an experimental lifecycle tool. Installing authenticated standalone agent TOML does not prove that the active collaboration interface can select that custom profile. A task name or child path matching the role name is not proof. Use installed shims only when the runtime exposes an explicit custom-agent selector and observed child metadata plus verifier output prove selection; otherwise use blank-agent role-card injection.
Accept exactly one action: doctor, status, install, or remove. Reject missing, extra, or unknown arguments without writes.
Locate ../../scripts/manage_role_agents.py relative to this installed SKILL.md. Run it with the current Python 3.10+ interpreter and the selected action. Do not copy the manager, resolve it through a source checkout, or edit generated agent files directly.
doctor: run the read-only live prerequisite check and render its JSON result for a person.status: run the read-only health and installed-roster summary and render its JSON result for a person.install: report the stable platform block. Do not request approval; no new shim plan or write is allowed.remove: use the same exact-digest flow to remove every intact managed shim. Never delete by filename prefix or marker alone.
Preserve the manager's exit contract: 0 success/converged, 2 usage, 3 cancelled, 4 drift/conflict, 5 prerequisite blocked, 6 untrusted state, 7 internal/recovery failure. Do not retry a mutating action after codes 4, 6, or 7; report the evidence and keep files untouched.
For doctor and status, do not return only the raw JSON or a generic safety label:
- Lead with
Healthy,Degraded, orBlocked, followed by the first non-pass check and its exact detail. - List every other non-pass check once, then summarize
state,targets,recovery, and namespace candidates. - State
No files changed. - Give the narrow safe next step. For package or active-package failures, refresh or reinstall Codex Rig and start a fresh session. For executable failures, report the selected path and rerun from a fresh session with stable Python and Codex selection. For permission, owner, type, or link failures, inspect only the named path and verify its metadata before changing anything. For corrupt, inconsistent, modified, or foreign evidence, back it up and do not adopt, edit, or delete it automatically. For recognized recovery residue, use
removeand review its authenticated approval digest.
Never recommend recursive chmod, chown, deletion, or link replacement from a diagnostic alone. A protected agent target may be readable by other users, but it must be owned by the current user and have no group/world write or special permission bits. Private lifecycle state remains exact mode 0700.
After successful install, update, or removal, tell the user to start a fresh Codex session. Thin shims intentionally depend on the installed plugin cache; uninstalling the plugin makes remaining shims unavailable until safely removed or reinstalled.