.agents/skills/source-command-verify-setup

stars:9739
forks:1214
watches:102
last updated:2026-07-13 22:59:17

source-command-verify-setup

Use this skill when the user asks to run the migrated source command verify-setup.

Command Template

Run the Codex infrastructure health check and get it fully green.

Steps

  1. Run the health check from the project root:

    bash .Codex/scripts/verify-setup.sh
    
  2. For every [FAIL] line, apply the printed fix. Common fixes:

    • Dependencies missing: cd .Codex/hooks && npm install
    • Scripts not executable: chmod +x .Codex/hooks/*.sh
    • Invalid JSON in .Codex/settings.json or .Codex/skills/skill-rules.json: read the file, find the syntax error (usually a trailing comma), and repair it without changing any settings values
    • Missing hook scripts registered in settings.json: ask the user whether to copy them from the showcase repo (https://github.com/diet103/Codex-infrastructure-showcase) or remove the dead registrations
  3. Re-run the script after each fix until it reports 0 failed.

  4. [WARN] lines are optional features (session intelligence, jq-based file tracking, AI classification keys). Do NOT install API keys or system packages on the user's behalf - summarize what each warning means and let the user decide.

  5. Report the final result to the user: what was broken, what you fixed, and what (if anything) remains as a warning.

    Good AI Tools