| name | rollout-basecoat |
| compatibility | ["github-copilot-cli"] |
| description | Use when refreshing a consumer repository to the latest BaseCoat build or a pinned BaseCoat release tag. USE FOR: refresh basecoat, update basecoat in a consumer repo, run sync.ps1 or sync.sh with .basecoat.yml defaults, verify installed basecoat version after sync, recover when rollout-basecoat skill invocation fails. DO NOT USE FOR: editing BaseCoat framework internals, designing new agents or skills, running unrelated CI/CD deployments. |
| category | operations |
| visibility | public |
| metadata | {"category":"operations","maturity":"stable","audience":["developer"]} |
| allowed-tools | [] |
Rollout BaseCoat Skill
Use this skill to refresh a consumer repository to the latest BaseCoat build or to
a pinned BaseCoat release.
Shortcut Phrases
- refresh basecoat
- update basecoat
- sync basecoat to latest
- upgrade basecoat in this repo
Workflow
- Read
.basecoat.yml (if present) for source and ref.
- Run sync using the platform script:
- Windows:
pwsh sync.ps1
- Linux or macOS:
./sync.sh
- Verify
.github/base-coat/version.json in the consumer repo.
- When
ref is pinned to a semver tag (for example v3.33.0), sync now
enforces provenance and fails if version.json does not match the tag.
- Known-bad tags with confirmed payload drift are auto-remapped to the first
corrected release, with a warning to update the consumer pin.
- Compare installed version with latest upstream release:
gh release list --repo IBuySpy-Shared/basecoat --limit 1.
- Report exactly what changed and any follow-up steps.
Fallback When Skill Routing Fails
If the environment reports Skill not found: rollout-basecoat, run direct sync
commands instead of stopping:
# PowerShell fallback (from consumer repo root)
$env:BASECOAT_REPO = 'https://github.com/ivegamsft/basecoat.git'
$env:BASECOAT_REF = 'main' # or vX.Y.Z
pwsh .\sync.ps1
BASECOAT_REPO=https://github.com/ivegamsft/basecoat.git \
BASECOAT_REF=main ./sync.sh
