Menu
Draft or update pkg/{name}/README.md in this dotfiles repo — summarizes what the package installs, what it configures, and how to invoke it via make.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Create or modify a pkg/{name}/ in this dotfiles repo. Use for both scaffolding new packages and editing existing ones (adding deps, splitting platforms, adding stow configs, rewiring Makefile targets).
Use this skill whenever the user wants to add, create, or capture a single agent rule into `.agents/rules/`. Triggers on phrases like 'add a rule', 'capture this as a rule', 'this should be a rule', 'turn this into a rule', 'I need a rule for X', or any time the user formulates a single standing guideline they want the agent to follow across sessions. Also use when the user asks whether a fact belongs in a hook, `AGENTS.md`, a rule, or a skill. Knows the classification (hook vs AGENTS.md vs rule vs skill) and the path-scoping conventions for `.agents/rules/`.
Based on SOC occupation classification
| name | pkg-readme |
| description | Draft or update pkg/{name}/README.md in this dotfiles repo — summarizes what the package installs, what it configures, and how to invoke it via make. |
Generate or update pkg/{name}/README.md.
git, zsh, macos-finder.pkg/{name}/ for:
*.Brewfile / *.Aptfile — list of installed tools.{name}.sh, {os}-{name}.sh — scan for defaults write, defaults import, duti -s, ln -sf, stow invocations, mise/pipx/npm installs.stow/ contents — files symlinked into $HOME.makefiles/{os}.mk for the {os}-{name} target and its dependencies.prettier.# `{name}`
One-sentence purpose.
## Installs
| CLI | macOS | Debian |
| --------- | ------ | ------ |
| `<cli-1>` | `brew` | `apt` |
| `<cli-n>` | `brew` | `apt` |
## Configures
- `~/.foo` (stow)
- `defaults write com.example.App ...`
- File-type associations via `duti`
## Notes
- TODOs
- Worth Noting
## References
- [<site> - <page>](url): Why this reference is important to be noted here