dot-skills
Maintain fmind/dot skill packages, catalog budgets, package contracts, and installed links.
Install
npx skills add https://github.com/fmind/dot/tree/main/.agents/skills/dot-skills
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
Maintain Dot Skills
Maintain first-party skills and chezmoi links. skillify and its package rules own authoring, package shape, and portability.
Workflow
- Choose the owner: inspect
git diff/git diff --cached, check neighboring descriptions, and apply the admission rule (skills/for reusable skills,.agents/skills/for repo-only procedures). - Register within budget: each scope (
AGENTS.md+ skill discovery) must stay below 5,000 estimated tokens (context budgets), enforced bymise run check:skills. Checkdot agent context --source . --project .first; if global headroom is under ~60 tokens, merge or retire an entry in the same change. Every global skill requiresdot_agents/skills/symlink_<name>.tmplcontaining{{ .chezmoi.sourceDir }}/skills/<name>. - Wire resources: set
metadata.kind(connector,task, orcollection), keep one procedure inSKILL.mdwith optional modes atreferences/<name>.mdorreferences/<name>/GUIDE.md, never nestSKILL.md, and runmise run format:skillsto sync routing indexes. SyncAGENTS.mdwhen ownership shifts (README.mdstays user-facing). - Validate: run
mise run check:skillsand edited-file formatters (isolate via git-worktree when unrelated edits exist); adduv run --frozen --project dot pytest -q dot/tests/test_skill_install_links.pyfor link changes.dot agent context --check(without--source) also checks third-party installs;--detailsinspects per-entry token estimates. - Exercise behavior: verify changed guidance per skillify and test host discovery separately when host integration changes.
Rename or remove
- Update atomically:
rgthe old name/path acrossskills/,.agents/skills/, docs, host configs, anddot/. Update directory, frontmattername,metadata.source,metadata.updated, inbound links, anddot_agents/skills/symlink_*.tmpltogether while keeping historical logs intact. - Retire deployed links: add retired
.agents/skills/<name>entries to.chezmoiremoveper chezmoi; use installed-link recovery for manual cleanup or checkout relocation.
Boundaries
- Keep
~/.agents/skills/a real shared directory: neverexact_or a whole-catalog symlink; third-party packages coexist there, and apply refuses collisions instead of overwriting. - Know check scope:
mise run check:skillsvalidates both catalogs (gh skill publish --dry-run skillschecks onlyskills/); standalone export requires the portability check.
Documentation
- skill_contracts.py · test_contracts.py · companions: agent-project, repository-docs.
Files (dot)
-
references
-
installed-links.md 922 B
Loading…
-
-
SKILL.md 3.4 KB
--- name: dot-skills description: "Maintain fmind/dot skill packages, context budgets, contracts, and installed links." license: MIT metadata: kind: task author: Médéric HURIER (Fmind) source: github.com/fmind/dot/tree/main/.agents/skills/dot-skills created: "2026-09-09" updated: "2026-11-10" --- # Maintain Dot Skills Maintain first-party skills and chezmoi links. [skillify](../../../skills/skillify/SKILL.md) and its [package rules](../../../skills/skillify/references/package-rules.md) own authoring, package shape, and portability. ## Workflow 1. **Choose the owner**: inspect `git diff` / `git diff --cached`, check neighboring descriptions, and apply the [admission rule](../../../skills/skillify/references/package-rules.md#categories-and-scope) (`skills/` for reusable skills, `.agents/skills/` for repo-only procedures). 1. **Register within budget**: each scope (`AGENTS.md` + skill discovery) must stay below 5,000 estimated tokens ([context budgets](../../../skills/dot-cli/references/context.md)), enforced by `mise run check:skills`. Check `dot agent context --source . --project .` first; if global headroom is under ~60 tokens, merge or retire an entry in the same change. Every global skill requires `dot_agents/skills/symlink_<name>.tmpl` containing `{{ .chezmoi.sourceDir }}/skills/<name>`. 1. **Wire resources**: set `metadata.kind` (`connector`, `task`, or `collection`), keep one procedure in `SKILL.md` with optional modes at `references/<name>.md` or `references/<name>/GUIDE.md`, never nest `SKILL.md`, and run `mise run format:skills` to sync routing indexes. Sync `AGENTS.md` when ownership shifts (`README.md` stays user-facing). 1. **Validate**: run `mise run check:skills` and edited-file formatters (isolate via [git-worktree](../../../skills/git-delivery/references/git-worktree/GUIDE.md) when unrelated edits exist); add `uv run --frozen --project dot pytest -q dot/tests/test_skill_install_links.py` for link changes. `dot agent context --check` (without `--source`) also checks third-party installs; `--details` inspects per-entry token estimates. 1. **Exercise behavior**: verify changed guidance per skillify and test host discovery separately when host integration changes. ## Rename or remove 1. **Update atomically**: `rg` the old name/path across `skills/`, `.agents/skills/`, docs, host configs, and `dot/`. Update directory, frontmatter `name`, `metadata.source`, `metadata.updated`, inbound links, and `dot_agents/skills/symlink_*.tmpl` together while keeping historical logs intact. 1. **Retire deployed links**: add retired `.agents/skills/<name>` entries to `.chezmoiremove` per [chezmoi](../chezmoi/SKILL.md); use [installed-link recovery](references/installed-links.md) for manual cleanup or checkout relocation. ## Boundaries - **Keep `~/.agents/skills/` a real shared directory**: never `exact_` or a whole-catalog symlink; third-party packages coexist there, and apply refuses collisions instead of overwriting. - **Know check scope**: `mise run check:skills` validates both catalogs (`gh skill publish --dry-run skills` checks only `skills/`); standalone export requires the portability check. ## Documentation - [skill_contracts.py](../../../dot/dot_tasks/skill_contracts.py) · [test_contracts.py](../../../dot/tests/test_contracts.py) · companions: [agent-project](../../../skills/agent-project/SKILL.md), [repository-docs](../../../skills/repository-docs/SKILL.md).
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.