dot-release
Prepare, publish, recover, and verify fmind/dot releases through the repository task.
Install
npx skills add https://github.com/fmind/dot/tree/main/.agents/skills/dot-release
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install fmind-dot@llmmart
git clone https://github.com/fmind/dot.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole fmind/dot collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Dot Release
Qualify fmind/dot and ship releases through mise run release. Run Qualification standalone when asked to verify the tree without committing or releasing; run Publish only on /dot-release or an explicit release request. The global release guide owns generic versioning; full-review, repository-docs, dot-development, and dot-skills own domain checks.
Qualification
- Capture baseline: record
git status --short, staged/unstaged diffs, untracked files, andgit fetchvsorigin/main. Include commits since the last tag and preserve unrelated work. - Review changes: inspect
git diff <tag>plus uncommitted work (excluding generated locks), fanning out read-only subreviews by area (dot/, chezmoi/harnesses, docs/skills) on large sets. Verify findings against code or live data and add regression tests for behavior fixes. - Sync docs & metadata: align
README.md,AGENTS.md,dot_agents/AGENTS.md,.github/*.md,.agents/skills/, andskills/with live--help,mise tasks, and JSON schemas; bumpupdated:on edited skills and runmise run format:skills. - Run gates:
mise run format(isolated if unrelated edits exist),mise run all,mise run check:completions, andmise run test:starters; rerun anything invalidated by later fixes. - Smoke-test
dotfrom repo root viauv run --frozen --project dot dot(--directory dotresolves.todot/):--helpon every top-level command, thendoctor,agent doctor,agent context --check,config show,status,orphan,cache,prune --dry-run,prune --aggressive --dry-run,pull --dry-run,trust --dry-run ., andagent stats --no-sync(all exit 0 or explained). - Check workstation when dotfiles or tools changed:
mise run diff,dot orphan(report only), andmise run doctor(installeddotshowingSTALEis expected beforedeploy/release). Stop here on qualification-only runs and report fixed/deferred items and gate results.
Publish
- Confirm authority:
/dot-releaseor an explicit release request authorizes commits, pushingmain,mise run release, and forward CI/CD fixes; stop if any qualification gate stays red or needs a user decision. - Commit and sync
main: group work into logical Conventional Commits (used bygit-cliff), thengit fetchand pushmain(pre-push runs network checks and tests). Integrate upstream moves without rewriting history only if commits are disjoint; otherwise stop. - Check preconditions:
dprint,git,git-cliff,mise, anduvpresent; cleanmainmatching fetchedorigin/main; next tag absent locally; at least one new Conventional Commit. Preserve unrelated work if preflight stops. - Run from source (
uv run --frozen --directory dot python -m dot_tasks.releaseviamise):
Updatesmise run release # interactive mise run release -- -y # non-interactive when authorizeddot/pyproject.toml,CHANGELOG.md(dprint-formatted), anddot/uv.lock, gates the bump (check:network,test:starters,build,check:completions), commits with visible Lefthook output, tags, runsgit push --atomic, and runsmise run deploy. - Verify CI/CD: tag push triggers cd.yml (read-only
gaterunsmise run all+git-cliff; checkout-freepublishwithcontents: writecreates the GitHub release). Watch CI (including macOS) and CD viagh run list --workflow cd.yml --branch <tag>andgh run watch <id> --exit-status, then confirmgh release view <tag>. On failure, inspectgh run view <id> --log-failed, fix forward onmain(never rerun to mask flakes), and cut the next release per Recovery if CD failed.
Gotchas
- Scope scanner suppressions narrowly: confirm resolved versions first; record confirmed false positives in a path-scoped
.trivyignore.yaml(statement+expired_at, wired viaignorefile:indot_config/trivy/trivy.yaml), never by lowering severity. - Fix upstream tool breaks at source: update repo configs and skills rather than deployed copies when an upgraded CLI changes flags or completions.
Recovery
Inspect git status --short, local commit/tag, and remote state before retrying (release.py, test_release.py).
| Failure boundary | Next action |
|---|---|
| Preflight failed | Worktree and index remain intact; inspect git status --short, fix cause, rerun. |
| Gate failed after prepare | Revert prepared bump with git restore --staged --worktree -- CHANGELOG.md dot/pyproject.toml dot/uv.lock, fix cause, rerun. |
| Local tag already exists | Confirm tag never reached remote, run git tag -d <tag>, rerun. |
| Commit created, tagging failed | Nothing reached remote; fix cause and run the printed tag, push, and deploy commands. |
| Atomic push failed | Check remote state; reconcile upstream divergence without losing the release commit, then retry. |
Push succeeded, deploy failed |
Confirm remote commit, tag, and CD first, then rerun mise run deploy. |
CD gate failed on pushed tag |
No release published; fix forward on main and cut the next version (never move tags or force-push). |
Documentation
- Releases: fmind/dot · changelog
- Companions: dot-development, commit messages.
Files (dot)
-
SKILL.md 6.6 KB
--- name: dot-release description: "Qualify, publish, verify, and recover fmind/dot releases via mise run release." license: MIT metadata: kind: task author: Médéric HURIER (Fmind) source: github.com/fmind/dot/tree/main/.agents/skills/dot-release created: "2026-07-08" updated: "2026-11-11" --- # Dot Release Qualify `fmind/dot` and ship releases through `mise run release`. Run **Qualification** standalone when asked to verify the tree without committing or releasing; run **Publish** only on `/dot-release` or an explicit release request. The global [release guide](../../../skills/git-delivery/references/release/GUIDE.md) owns generic versioning; [full-review](../../../skills/full-review/SKILL.md), [repository-docs](../../../skills/repository-docs/SKILL.md), [dot-development](../dot-development/SKILL.md), and [dot-skills](../dot-skills/SKILL.md) own domain checks. ## Qualification 1. **Capture baseline**: record `git status --short`, staged/unstaged diffs, untracked files, and `git fetch` vs `origin/main`. Include commits since the last tag and preserve unrelated work. 1. **Review changes**: inspect `git diff <tag>` plus uncommitted work (excluding generated locks), fanning out read-only subreviews by area (`dot/`, chezmoi/harnesses, docs/skills) on large sets. Verify findings against code or live data and add regression tests for behavior fixes. 1. **Sync docs & metadata**: align `README.md`, `AGENTS.md`, `dot_agents/AGENTS.md`, `.github/*.md`, `.agents/skills/`, and `skills/` with live `--help`, `mise tasks`, and JSON schemas; bump `updated:` on edited skills and run `mise run format:skills`. 1. **Run gates**: `mise run format` (isolated if unrelated edits exist), `mise run all`, `mise run check:completions`, and `mise run test:starters`; rerun anything invalidated by later fixes. 1. **Smoke-test `dot`** from repo root via `uv run --frozen --project dot dot` (`--directory dot` resolves `.` to `dot/`): `--help` on every top-level command, then `doctor`, `agent doctor`, `agent context --check`, `config show`, `status`, `orphan`, `cache`, `prune --dry-run`, `prune --aggressive --dry-run`, `pull --dry-run`, `trust --dry-run .`, and `agent stats --no-sync` (all exit 0 or explained). 1. **Check workstation** when dotfiles or tools changed: `mise run diff`, `dot orphan` (report only), and `mise run doctor` (installed `dot` showing `STALE` is expected before `deploy`/release). Stop here on qualification-only runs and report fixed/deferred items and gate results. ## Publish 1. **Confirm authority**: `/dot-release` or an explicit release request authorizes commits, pushing `main`, `mise run release`, and forward CI/CD fixes; stop if any qualification gate stays red or needs a user decision. 1. **Commit and sync `main`**: group work into logical [Conventional Commits](../../../skills/git-delivery/SKILL.md#commit-messages) (used by `git-cliff`), then `git fetch` and push `main` (pre-push runs network checks and tests). Integrate upstream moves without rewriting history only if commits are disjoint; otherwise stop. 1. **Check preconditions**: `dprint`, `git`, `git-cliff`, `mise`, and `uv` present; clean `main` matching fetched `origin/main`; next tag absent locally; at least one new Conventional Commit. Preserve unrelated work if preflight stops. 1. **Run from source** (`uv run --frozen --directory dot python -m dot_tasks.release` via `mise`): ```bash mise run release # interactive mise run release -- -y # non-interactive when authorized ``` Updates `dot/pyproject.toml`, `CHANGELOG.md` (dprint-formatted), and `dot/uv.lock`, gates the bump (`check:network`, `test:starters`, `build`, `check:completions`), commits with visible Lefthook output, tags, runs `git push --atomic`, and runs `mise run deploy`. 1. **Verify CI/CD**: tag push triggers [cd.yml](../../../.github/workflows/cd.yml) (read-only `gate` runs `mise run all` + `git-cliff`; checkout-free `publish` with `contents: write` creates the GitHub release). Watch CI (including macOS) and CD via `gh run list --workflow cd.yml --branch <tag>` and `gh run watch <id> --exit-status`, then confirm `gh release view <tag>`. On failure, inspect `gh run view <id> --log-failed`, fix forward on `main` (never rerun to mask flakes), and cut the next release per [Recovery](#recovery) if CD failed. ## Gotchas - **Scope scanner suppressions narrowly**: confirm resolved versions first; record confirmed false positives in a path-scoped `.trivyignore.yaml` (`statement` + `expired_at`, wired via `ignorefile:` in `dot_config/trivy/trivy.yaml`), never by lowering severity. - **Fix upstream tool breaks at source**: update repo configs and skills rather than deployed copies when an upgraded CLI changes flags or completions. ## Recovery Inspect `git status --short`, local commit/tag, and remote state before retrying ([release.py](../../../dot/dot_tasks/release.py), [test_release.py](../../../dot/tests/test_release.py)). | Failure boundary | Next action | | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | | Preflight failed | Worktree and index remain intact; inspect `git status --short`, fix cause, rerun. | | Gate failed after prepare | Revert prepared bump with `git restore --staged --worktree -- CHANGELOG.md dot/pyproject.toml dot/uv.lock`, fix cause, rerun. | | Local tag already exists | Confirm tag never reached remote, run `git tag -d <tag>`, rerun. | | Commit created, tagging failed | Nothing reached remote; fix cause and run the printed tag, push, and deploy commands. | | Atomic push failed | Check remote state; reconcile upstream divergence without losing the release commit, then retry. | | Push succeeded, `deploy` failed | Confirm remote commit, tag, and CD first, then rerun `mise run deploy`. | | CD `gate` failed on pushed tag | No release published; fix forward on `main` and cut the next version (never move tags or force-push). | ## Documentation - Releases: [fmind/dot](https://github.com/fmind/dot/releases) · [changelog](https://github.com/fmind/dot/blob/main/CHANGELOG.md) - Companions: [dot-development](../dot-development/SKILL.md), [commit messages](../../../skills/git-delivery/SKILL.md#commit-messages).
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.