naps62
a1f95a1161
Replaces public-comms.md and code-comments.md (749 words, ~25 rules, almost all prohibitions, no examples) with a single writing.md that leads with worked examples. The rule is selection, not compression: keep output short by cutting whole ideas that don't change what the reader does next, then write what survives as plain sentences. Not by dropping articles or writing fragments, which Anthropic's Fable 5 guide calls out as the wrong lever. Prompt style leaks into output style, so the file is written in the voice it asks for. Drops the BLUF ask-line rule entirely: everyone on a PR already knows who reviews and who merges, and read literally it produced openers like "Ask: reviewers please merge". Links the contract to ~/.agents/AGENTS.md, which Codex had nothing in at all, and to the nix module for the NixOS machine.
29 lines
1.4 KiB
Nix
29 lines
1.4 KiB
Nix
# Home-manager module: link centralized agent skills into Claude Code + Codex.
|
|
# Usage: add this flake as an input, then import this module in your home config.
|
|
#
|
|
# inputs.agent-skills.url = "git+https://git.naps.pt/yolo/agent-skills.git";
|
|
# # in home.nix imports: inputs.agent-skills.homeModules.default
|
|
#
|
|
# recursive=true links each FILE individually, so machine-local skills can still
|
|
# live alongside the managed ones in the same dir (a whole-dir symlink would not).
|
|
{ agent-skills }:
|
|
{ ... }:
|
|
{
|
|
home.file = {
|
|
".claude/skills" = { source = "${agent-skills}/skills"; recursive = true; };
|
|
".agents/skills" = { source = "${agent-skills}/skills"; recursive = true; };
|
|
".claude/commands" = { source = "${agent-skills}/commands"; recursive = true; };
|
|
".claude/hooks" = { source = "${agent-skills}/hooks"; recursive = true; };
|
|
|
|
# CLAUDE.md fragments land in ~/.claude root, pulled in by `@name.md` imports.
|
|
# Listed one by one: recursive on ~/.claude would fight every other tool
|
|
# writing there (settings.json, projects/, file-history/).
|
|
".claude/writing.md".source = "${agent-skills}/claude-md/writing.md";
|
|
|
|
# Codex has no @import, so the contract is the file itself.
|
|
".agents/AGENTS.md".source = "${agent-skills}/claude-md/writing.md";
|
|
};
|
|
}
|
|
# Hook wiring lives in ~/.claude/settings.json, which this module does not own.
|
|
# See hooks/README.md for the snippet.
|