docs(agents): add gator launch skill

[johntmyers]

Summary

Add a main repository skill for launching and supervising OpenShell gator agents through scripts/agents/run.sh.

Related Issue

N/A

Changes

• Added .agents/skills/launch-openshell-gator/SKILL.md with preflight, launch, monitoring, restart, and troubleshooting workflows.
• Documented the skill in the CONTRIBUTING.md agent skills inventory.

Testing

• git diff --check passes
• mise run pre-commit passes
• Unit tests added/updated (not applicable)
• E2E tests added/updated (not applicable)

Checklist

• Follows Conventional Commits
• Commits are signed off (DCO)

[pimlock]

🚢

Couple of nits, around how this skill would be included in the context.

[drew]

lgtm

[drew]

gator-agent

PR Review Status

Validation: This is a concentrated repository documentation/agent-skill update for launching supervised OpenShell gator agents, so it is project-valid.
Head SHA: 5427f87a50ed877049a44e6b28d24936dd107925

Thanks @pimlock, I checked the trigger-scope and intro concerns you raised. The latest commits removed the broad gateway/model trigger wording and trimmed the extra intro, so that feedback appears addressed.

Review findings:

• .agents/skills/launch-openshell-gator/SKILL.md:108 and .agents/skills/launch-openshell-gator/SKILL.md:233: the skill shows commands where agents substitute PR/issue/sandbox placeholders directly into shell arguments. Please add an explicit guardrail to normalize PR/issue IDs to digits only and sandbox names to a safe character set such as [A-Za-z0-9_.-]+, and to avoid pasting raw operator text into --name, --from, or numeric placeholders. This avoids command/argument injection risk in the operator workflow.
• .agents/skills/launch-openshell-gator/SKILL.md:173 and .agents/skills/launch-openshell-gator/SKILL.md:183: the model/image experiment example uses a hard-coded host-specific temp path. Please switch this to a portable generated temp directory, for example tmp_context="$(mktemp -d "${TMPDIR:-/tmp}/gator-codex-XXXXXX")", and pass that path to --from.

Docs: No Fern docs navigation update is needed because this does not change user-facing CLI/API behavior.

Next state: gator:in-review

[copy-pr-bot]

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

[johntmyers]

/ok to test 3b066eb