Gemskills Codex Agent Setup
Install Lisa's generated Codex adapter as a regular file. Run this skill only after an explicit request to install, update, check, or uninstall Lisa.
Safety contract
- Default to the current project's
.codex/agents/directory. - Use
--useronly when the user explicitly requests a user-wide install. - Never edit
~/.codex/config.tomlor any global Codex configuration. - Never create plugin-cache symlinks or delete unrelated custom agents.
- Run
--checkwhen the user asks what would change.
Commands
bash "${SKILL_DIR}/scripts/setup.sh" [--check|--uninstall|--force]
bash "${SKILL_DIR}/scripts/setup.sh" --user [--check|--uninstall|--force]
bash "${SKILL_DIR}/scripts/setup.sh" --target /custom/agents/directory
The installer manages only gemskills-content.toml and records ownership in
.gemskills-agents.json. An unmanaged collision is refused unless the user
explicitly authorizes --force.
After a successful install or update, tell the user to start a new Codex
session, then invoke Lisa using the runtime name gemskills_content.
Maintainer generation
bash "${SKILL_DIR}/scripts/generate.sh"
bash "${SKILL_DIR}/scripts/generate.sh" --check