[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7589YKBCH2SC5ASK0J2XJ7P":3,"skill-same:01M7589YKBCH2SC5ASK0J2XJ7P":67},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":44,"commitSha":45,"skillDirectory":46,"forksCount":47,"repositoryHtmlUrl":48,"repositoryHomepageUrl":49,"ownerHtmlUrl":50,"ownerBlogUrl":6,"ownerDescription":51,"updatedAt":52,"install":53,"resources":66},"01M7589YKBCH2SC5ASK0J2XJ7P","installer-validation",null,"Validate installers and strip post-decommission stale refs.","lukemcqueen\u002Fsteadfaste-fleet","lukemcqueen","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F405240?v=4","01M757MHPAGRXTJAT46SKZP98R","Luke McQueen","01M757MHPZ573KP8DT9GB8SBQ7",4,"MIT","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Finstaller-validation\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: installer-validation\ndescription: \"Validate installers and strip post-decommission stale refs.\"\nversion: 1.0.0\nauthor: Steadfaste Fleet\nlicense: MIT\nplatforms: [linux, macos]\nmetadata:\n  hermes:\n    tags: [installer, validation, stale-reference, decommission, deploy, sweep, orchestrator-gate]\n    related_skills: [shell-scripting, repo-gotchas, deploy-load-verification, enforcement-change-safety]\n---\n\n# Installer Validation\n\nWhen the repo's installers have been updated over time and a component was\ndecommissioned or renamed (real example: legacy brain → mycortex, 2026-08-02),\nrun a class-level validation sweep before touching anything. This skill is\nthe checklist for \"are the installers current and will they work\" plus the\ncommit-gate reality that attends repo `ops\u002F` work.\n\n## When to Use\n\n- User asks to \"validate the installers\", \"make sure everything is current\",\n  or \"remove stale components\u002Fdependencies\"\n- A component was decommissioned and installers still reference it\n- Before shipping a change to `ops\u002Finstall\u002F`, `ops\u002Fscripts\u002Finstall\u002F`,\n  any `install-*.sh`, `quick-start.sh`, or deploy templates\n- Preparing installer work for orchestrator handoff from a non-orchestrator host\n\n## Prerequisites\n\n- The current host may be a non-orchestrator (e.g. `titus`). Commits to\n  `ops\u002F` are blocked by the pre-commit hook in that case — see the\n  commit-gate section; the deliverable becomes a verified staged diff.\n\n## Procedure\n\n### 1. Survey the installer surface\n\nFind every installer and its referenced script paths. `bash -n` every one\nfirst — validates syntax before any semantic work.\n\n```bash\nbash -n ops\u002Finstall\u002Finstall.sh ops\u002Finstall\u002Fquick-start.sh \\\n  ops\u002Fscripts\u002Finstall\u002F*.sh ops\u002Fscripts\u002Finstall-crons.sh\n```\n\nVerify every path each installer references actually exists in the repo\n(`_scripts()`, `_deploy()`, `_offline()`, `_core_gov()`, `${SCRIPT_DIR}`,\n`${REPO_ROOT}` forms). Use a Python extraction pass rather than blind grep —\nfunction-call forms (`$(_scripts)\u002F...`) and quoted forms both appear.\n\n### 2. Decommissioned-component sweep\n\nGrep every location for the old name — do NOT stop at the obvious file:\n\n```bash\nfor d in ops\u002Finstall ops\u002Finstall\u002Fdeploy ops\u002Fscripts\u002Finstall ops\u002Fscripts\u002Fhealth \\\n         ops\u002Fscripts\u002Fagent docs\u002Finstall; do\n  [ -d \"$d\" ] && grep -rni '\u003Cold-name>' \"$d\" 2>\u002Fdev\u002Fnull\ndone\n# also fleet-update.sh register\u002Funregister blocks and\n# fleet_doctor\u002Fchecks.py (its remediation hints still name old units)\n```\n\nClassify each match:\n- **Dead dependency (remove):** an install block that existed only for the\n  old component and now uses a broken URL. Real case: the legacy-brain\n  `ollama-linux-*.tgz` `llama-server` tarball extraction — the `.tgz` format\n  is a 404 (became `.tar.zst`), and the replacement (mycortex) is pure Python\n  needing no `llama-server`. Remove the whole block.\n- **Compat logic (keep, relabel):** password-variable reuse\n  (`LEGACY_BRAIN_PG_PASSWORD` → `MYFLEET_PG_PASSWORD` (variable renamed)), legacy plugin-name checks\n  in `config.yaml`, decommission comments. Keep these; only fix wording that\n  claims the old component is installed\u002Fneeded.\n\n### 3. Remove orphaned deploy files only after proving zero refs\n\nA stale template (`deploy\u002F\u003Cold>-autopilot.service`) may be referenced by the\ndoctor or health scripts that detect the half-state on old hosts — those\nreference the **systemd unit name**, not the repo file, and are correct to\nkeep. Prove the repo file is safe to delete:\n\n```bash\ngrep -rn '\u003Cunit>' ops\u002Fscripts\u002Ffleet-update.sh ops\u002Finstall\u002Finstall.sh\n# if nothing deploys\u002Fcopies it → git rm is safe\n```\n\n### 4. Health-vector key drift — single source of truth\n\nThe `SERVICE_MAP` key list is duplicated across the live emitter\n(`ops\u002Fscripts\u002Fhealth\u002Fhealth-vector.py`) and several consumers that must agree:\n`agent-registry.template.json`, `agent-registry.json.example`,\n`orch-fleet-watchdog.py`, `orch-health-report.py`, and the push script's\nindex comments. After any rename (e.g. `legacy_brain_sources_ok` →\n`mycortex_sources_ok`) all five must match or the fleet watchdog\u002Freport misreads\nthe live vector. Treat the emitter's list as the authority and grep every copy\nof the old key. Validate the JSON files still parse after edits.\n\n### 5. Undefined `${SCRIPT_DIR}` in standalone helper installers\n\nSmall installers (`quick-start.sh`) sometimes reference `${SCRIPT_DIR}`\nwithout defining it, so the skill\u002Ffile-copy block silently no-ops (exit 0, no\nerror). Define it from `\"${BASH_SOURCE[0]}\"` and walk up to the repo root, and\ndrop from install lists any skill\u002Fpath that no longer exists in the repo\n(`find . -type d -name '\u003Cskill>'` returns nothing). Verify the copy actually\nlands by running the script with a temp `HERMES_HOME` — running is the only\nproof.\n\n### 6. Verify\n\n- `bash -n` every changed shell script\n- PY syntax check changed `.py` files\n- Run the changed `install.sh --check` from the real repo path (proves it\n  executes end-to-end)\n- Run the adversarial gate (A2 default; A4 for manage\u002Fquality\u002Fhooks) on every\n  changed script\n- targeted pytest on tests that touch the changed files\n- PII scan (`secret-leak-detector.sh`)\n\n### 7. Orchestrator-only commit gate\n\nThe pre-commit hook BLOCKS commits on `ops\u002F` (and other\n`docs\u002Forchestrator-only-paths.txt` entries) by reading the COMMITTED config —\nediting the working copy cannot bypass it, and `--no-verify` is a logged\ngovernance violation. Non-orchestrators:\n\n1. Do ALL validation on a branch first so the diff is commit-ready: `git\n   checkout -b titus\u002F\u003Cslug>`, apply changes, run the step-6 suite.\n2. Stage, then run `git commit` ONCE to confirm the block fires (expected).\n3. Deliverable is a **verified, staged diff for orchestrator handoff** (bus\n   message \u002F PR with the branch name), not a landed commit. Say so plainly in\n   the delivery so the orchestrator knows it is validated and ready to commit.\n\n## Pitfalls\n\n- **Missing `SCRIPT_DIR`** — a copy\u002Fskill block silently no-ops; verify by\n  running, not reading.\n- **`.tgz` Ollama URLs** are dead — the release format became `.tar.zst`.\n- **Don't grep only `ops\u002Finstall\u002F`** for a stale name — the same string lives\n  in health scripts, agent orch scripts, doctor checks, and `fleet-update.sh`.\n- **Orchestrator-only blocks are not bugs** — expect the commit to refuse on a\n  non-orchestrator host and hand off with the stage intact.\n- **Pre-existing test failures** (missing `yaml`, unrelated module import\n  exit) should be confirmed unrelated to your diff before reporting.\n\n## Verification\n\n- All changed scripts pass `bash -n` and the adversarial gate\n- The changed `install.sh --check` runs from the real path with no error\n- If on a non-orchestrator host: changes staged on a branch, commit-verify\n  attempted, handoff prepared\n","# Installer Validation\n\nWhen the repo's installers have been updated over time and a component was\ndecommissioned or renamed (real example: legacy brain → mycortex, 2026-08-02),\nrun a class-level validation sweep before touching anything. This skill is\nthe checklist for \"are the installers current and will they work\" plus the\ncommit-gate reality that attends repo `ops\u002F` work.\n\n## When to Use\n\n- User asks to \"validate the installers\", \"make sure everything is current\",\n  or \"remove stale components\u002Fdependencies\"\n- A component was decommissioned and installers still reference it\n- Before shipping a change to `ops\u002Finstall\u002F`, `ops\u002Fscripts\u002Finstall\u002F`,\n  any `install-*.sh`, `quick-start.sh`, or deploy templates\n- Preparing installer work for orchestrator handoff from a non-orchestrator host\n\n## Prerequisites\n\n- The current host may be a non-orchestrator (e.g. `titus`). Commits to\n  `ops\u002F` are blocked by the pre-commit hook in that case — see the\n  commit-gate section; the deliverable becomes a verified staged diff.\n\n## Procedure\n\n### 1. Survey the installer surface\n\nFind every installer and its referenced script paths. `bash -n` every one\nfirst — validates syntax before any semantic work.\n\n```bash\nbash -n ops\u002Finstall\u002Finstall.sh ops\u002Finstall\u002Fquick-start.sh \\\n  ops\u002Fscripts\u002Finstall\u002F*.sh ops\u002Fscripts\u002Finstall-crons.sh\n```\n\nVerify every path each installer references actually exists in the repo\n(`_scripts()`, `_deploy()`, `_offline()`, `_core_gov()`, `${SCRIPT_DIR}`,\n`${REPO_ROOT}` forms). Use a Python extraction pass rather than blind grep —\nfunction-call forms (`$(_scripts)\u002F...`) and quoted forms both appear.\n\n### 2. Decommissioned-component sweep\n\nGrep every location for the old name — do NOT stop at the obvious file:\n\n```bash\nfor d in ops\u002Finstall ops\u002Finstall\u002Fdeploy ops\u002Fscripts\u002Finstall ops\u002Fscripts\u002Fhealth \\\n         ops\u002Fscripts\u002Fagent docs\u002Finstall; do\n  [ -d \"$d\" ] && grep -rni '\u003Cold-name>' \"$d\" 2>\u002Fdev\u002Fnull\ndone\n# also fleet-update.sh register\u002Funregister blocks and\n# fleet_doctor\u002Fchecks.py (its remediation hints still name old units)\n```\n\nClassify each match:\n- **Dead dependency (remove):** an install block that existed only for the\n  old component and now uses a broken URL. Real case: the legacy-brain\n  `ollama-linux-*.tgz` `llama-server` tarball extraction — the `.tgz` format\n  is a 404 (became `.tar.zst`), and the replacement (mycortex) is pure Python\n  needing no `llama-server`. Remove the whole block.\n- **Compat logic (keep, relabel):** password-variable reuse\n  (`LEGACY_BRAIN_PG_PASSWORD` → `MYFLEET_PG_PASSWORD` (variable renamed)), legacy plugin-name checks\n  in `config.yaml`, decommission comments. Keep these; only fix wording that\n  claims the old component is installed\u002Fneeded.\n\n### 3. Remove orphaned deploy files only after proving zero refs\n\nA stale template (`deploy\u002F\u003Cold>-autopilot.service`) may be referenced by the\ndoctor or health scripts that detect the half-state on old hosts — those\nreference the **systemd unit name**, not the repo file, and are correct to\nkeep. Prove the repo file is safe to delete:\n\n```bash\ngrep -rn '\u003Cunit>' ops\u002Fscripts\u002Ffleet-update.sh ops\u002Finstall\u002Finstall.sh\n# if nothing deploys\u002Fcopies it → git rm is safe\n```\n\n### 4. Health-vector key drift — single source of truth\n\nThe `SERVICE_MAP` key list is duplicated across the live emitter\n(`ops\u002Fscripts\u002Fhealth\u002Fhealth-vector.py`) and several consumers that must agree:\n`agent-registry.template.json`, `agent-registry.json.example`,\n`orch-fleet-watchdog.py`, `orch-health-report.py`, and the push script's\nindex comments. After any rename (e.g. `legacy_brain_sources_ok` →\n`mycortex_sources_ok`) all five must match or the fleet watchdog\u002Freport misreads\nthe live vector. Treat the emitter's list as the authority and grep every copy\nof the old key. Validate the JSON files still parse after edits.\n\n### 5. Undefined `${SCRIPT_DIR}` in standalone helper installers\n\nSmall installers (`quick-start.sh`) sometimes reference `${SCRIPT_DIR}`\nwithout defining it, so the skill\u002Ffile-copy block silently no-ops (exit 0, no\nerror). Define it from `\"${BASH_SOURCE[0]}\"` and walk up to the repo root, and\ndrop from install lists any skill\u002Fpath that no longer exists in the repo\n(`find . -type d -name '\u003Cskill>'` returns nothing). Verify the copy actually\nlands by running the script with a temp `HERMES_HOME` — running is the only\nproof.\n\n### 6. Verify\n\n- `bash -n` every changed shell script\n- PY syntax check changed `.py` files\n- Run the changed `install.sh --check` from the real repo path (proves it\n  executes end-to-end)\n- Run the adversarial gate (A2 default; A4 for manage\u002Fquality\u002Fhooks) on every\n  changed script\n- targeted pytest on tests that touch the changed files\n- PII scan (`secret-leak-detector.sh`)\n\n### 7. Orchestrator-only commit gate\n\nThe pre-commit hook BLOCKS commits on `ops\u002F` (and other\n`docs\u002Forchestrator-only-paths.txt` entries) by reading the COMMITTED config —\nediting the working copy cannot bypass it, and `--no-verify` is a logged\ngovernance violation. Non-orchestrators:\n\n1. Do ALL validation on a branch first so the diff is commit-ready: `git\n   checkout -b titus\u002F\u003Cslug>`, apply changes, run the step-6 suite.\n2. Stage, then run `git commit` ONCE to confirm the block fires (expected).\n3. Deliverable is a **verified, staged diff for orchestrator handoff** (bus\n   message \u002F PR with the branch name), not a landed commit. Say so plainly in\n   the delivery so the orchestrator knows it is validated and ready to commit.\n\n## Pitfalls\n\n- **Missing `SCRIPT_DIR`** — a copy\u002Fskill block silently no-ops; verify by\n  running, not reading.\n- **`.tgz` Ollama URLs** are dead — the release format became `.tar.zst`.\n- **Don't grep only `ops\u002Finstall\u002F`** for a stale name — the same string lives\n  in health scripts, agent orch scripts, doctor checks, and `fleet-update.sh`.\n- **Orchestrator-only blocks are not bugs** — expect the commit to refuse on a\n  non-orchestrator host and hand off with the stage intact.\n- **Pre-existing test failures** (missing `yaml`, unrelated module import\n  exit) should be confirmed unrelated to your diff before reporting.\n\n## Verification\n\n- All changed scripts pass `bash -n` and the adversarial gate\n- The changed `install.sh --check` runs from the real path with no error\n- If on a non-orchestrator host: changes staged on a branch, commit-verify\n  attempted, handoff prepared\n",{"name":5,"author":24,"license":15,"version":25,"metadata":26,"platforms":41,"description":7},"Steadfaste Fleet","1.0.0",{"hermes":27},{"tags":28,"related_skills":36},[29,30,31,32,33,34,35],"installer","validation","stale-reference","decommission","deploy","sweep","orchestrator-gate",[37,38,39,40],"shell-scripting","repo-gotchas","deploy-load-verification","enforcement-change-safety",[42,43],"linux","macos","main","9dc0e92c5fa81d4db5292b205716e8ea0c00d10e","skills\u002Fdevops\u002Finstaller-validation",1,"https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet","steadfaste.com","https:\u002F\u002Fgithub.com\u002Flukemcqueen","AI Architect | Building Hermes Cortex: governed multi-agent AI for autonomous software engineering | Enterprise Tech Consultant","2026-11-14 22:33:34",{"source":8,"skillName":5,"commands":54,"prompt":64,"zipAvailable":65},[55,58,61],{"tool":56,"command":57},"npx","npx skills add lukemcqueen\u002Fsteadfaste-fleet --skill installer-validation",{"tool":59,"command":60},"bunx","bunx skills add lukemcqueen\u002Fsteadfaste-fleet --skill installer-validation",{"tool":62,"command":63},"pnpm","pnpm dlx skills add lukemcqueen\u002Fsteadfaste-fleet --skill installer-validation","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Finstaller-validation\u002FSKILL.md",true,[],[68,76,83,90,97,104],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":75},"01M7DXY4G8NSVB59K8B6S2AQNP","macbook-linux-maintenance","Legacy MacBook Linux fixes: GPU wedge, reboot hang, thermal.","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fmacbook-linux-maintenance\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":75},"01M7DXXYJCXFJ3TGB84ZQ8KFE6","governance-regression-triage","Triage a host's governance issues: what changed.","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fgovernance-regression-triage\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":75},"01M7DXXSAP1G8FDRJAMXQGBBMK","enforcement-immutability","Use when enforcement files lose their immutable flag.","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fenforcement-immutability\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":75},"01M78SSDQVRYX64Y16X32TC0NS","steadfaste-fleet-repo-deploy","Use when committing to the steadfaste-fleet repo.","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fsteadfaste-fleet-repo-deploy\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":75},"01M78SS928F3R2RJAYVW4E30CE","steadfaste-fleet-maintenance","Maintain an installed Steadfaste Fleet instance — update both the upstream Hermes Agent and the fleet repo layer, merge diverged histories, sync skills safely, and troubleshoot common issues. Covers the dual-update workflow (hermes update + fleet-update.sh), encrypted brain data backup, mycortex import, and recovery techniques.","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fsteadfaste-fleet-maintenance\u002FSKILL.md",[],[],{"skillNo":105,"name":106,"nameZh":6,"description":107,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":108,"categories":109,"keywords":110,"publishedAt":75},"01M78SP1CHW0T0BWE5ZT6JBPX8","fleet-preflight","DEPRECATED alias — merged into survey-before-action (2026-08-20). Load survey-before-action instead; its \"Repo-Specific Pre-Flight\" section covers git search, Hermes boundary, and deployment verification.","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Ffleet-preflight\u002FSKILL.md",[],[]]