Claude Skill

dot-skills

Maintain fmind/dot skill packages, catalog budgets, package contracts, and installed links.

LLM Mart · 0 points · 1 views 0 listing impressions 0 install-command copies
Download fmind-dot-.agents_skills_dot-skills-3bbe830.zip · 2 KB

Install

skills CLI npx skills add https://github.com/fmind/dot/tree/main/.agents/skills/dot-skills
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install fmind-dot@llmmart
Git 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

  1. 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).
  2. Register within budget: each scope (AGENTS.md + skill discovery) must stay below 5,000 estimated tokens (context budgets), 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>.
  3. 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).
  4. Validate: run mise run check:skills and edited-file formatters (isolate via git-worktree 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.
  5. 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.
  2. Retire deployed links: add retired .agents/skills/<name> entries to .chezmoiremove per chezmoi; use installed-link recovery 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

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.

No comments yet.

Reviews (0)

No reviews yet.