Felipe Martin
2494760df1
npx-managed skills stay copies so an installer update cannot land in the repo by accident; knowledge is a symlink outside home/ so maintain writes are tracked instead of dying on the next apply. Verified the live ~/.agents/knowledge link and that the lockfile is named dot_skill-lock.json so chezmoi does not ignore it. Co-authored-by: Cursor <cursoragent@cursor.com>
12 lines
1 KiB
Markdown
12 lines
1 KiB
Markdown
# Docs
|
|
|
|
| | |
|
|
|---|---|
|
|
| [config/metapac.md](config/metapac.md) | How packages are declared, why every host needs a baseline group, and what `metapac clean` does to a machine without one. Read before onboarding a new host. |
|
|
| [config/git.md](config/git.md) | Commit signing through 1Password over SSH rather than GPG, credential handling, aliases, and how to register a signing key with a forge. |
|
|
| [config/claude.md](config/claude.md) | Why `settings.json` is merged instead of owned, and what the status line shows — including the cache hit rate and how it degrades on team accounts. |
|
|
| [config/agents.md](config/agents.md) | Why `~/.agents/knowledge` is a symlink into the repo, why skills stay copies owned by `npx skills`, and why those writes never reach the source until `chezmoi add`. |
|
|
| [dotfiles-command.md](dotfiles-command.md) | The `dotfiles` maintenance command and the three things it deliberately refuses to do. |
|
|
|
|
Conventions for changing any of this, including what belongs in these files, are
|
|
in [AGENTS.md](../AGENTS.md).
|