agentic-dotfiles

Skills, rules and workflows for agentic coding, installable with skills.

The richdocs showcase demonstrates the visual surface shipped by the skill.

Install

# Browse what's in here
npx skills@latest add neozenith/agentic-dotfiles -l

# Install one skill into this project
npx skills@latest add neozenith/agentic-dotfiles -s richdocs -y

# Install globally (~/.claude) instead
npx skills@latest add neozenith/agentic-dotfiles -s richdocs -g -y

# Everything, every agent
npx skills@latest add neozenith/agentic-dotfiles --all

npx skills@latest list
npx skills@latest update
npx skills@latest remove -s richdocs

Skills

richdocs

Markdown → interactive HTML (mermaid, cytoscape, plotly, draw.io cloud stencils) with a localhost server.

npx skills@latest add neozenith/agentic-dotfiles -s richdocs -y

mermaidjs-diagrams

Render Mermaid diagrams in markdown with enforced complexity limits and WCAG contrast checks.

npx skills@latest add neozenith/agentic-dotfiles -s mermaidjs-diagrams -y

gooddocs

Audit docs for drift, write/improve them with the Diátaxis lens, or restructure for readability.

npx skills@latest add neozenith/agentic-dotfiles -s gooddocs -y

coach

Researches a topic, summarises it in ≤5 bullets, then runs a Socratic one-question-at-a-time quiz loop.

npx skills@latest add neozenith/agentic-dotfiles -s coach -y

concise-decisions

Resolve multiple blocking ambiguities with one high-leverage multiple-choice question, a recommended default, and a cascade across related decisions.

npx skills@latest add neozenith/agentic-dotfiles -s concise-decisions -y

librarian

Organise repository documentation by checking canonical files, names, locations, and required cross-links.

npx skills@latest add neozenith/agentic-dotfiles -s librarian -y

introspect

Query Claude Code session history: conversations, tool usage, event trees, costs.

npx skills@latest add neozenith/agentic-dotfiles -s introspect -y

dadjoke

Workshop themed dad jokes in short, feedback-led waves. The theme is the invocation argument; add a count or "Q&A" to the same argument to shape the wave.

npx skills@latest add neozenith/agentic-dotfiles -s dadjoke -y

/dadjoke kubernetes                         # Claude Code
$dadjoke five Q&A jokes about kubernetes    # Codex

Hooks

tool_coach

A PreToolUse hook that turns a dead-end "permission denied" into a redirect: every blocked call comes back with the thing to do instead, so the model stops retrying near-miss variants. Structural checks (no deletions, no scratch space outside the project) parse the command's argv; tool-choice coaching lives in an editable rules file. Stdlib only.

See hooks/README.md for what it checks and how to wire it into settings.json.

make hooks-test