Adds guidance on crafting effective rumilo queries, emphasizing scope
and coupling considerations. Includes a comparison of overloaded vs
sequenced queries, with examples showing how to break down complex
research tasks into focused calls.

Sends push notifications via ntfy.sh when the user explicitly asks to be
notified. Includes curl examples in SKILL.md and alternative HTTP client
references (ht, httpie, wget, python, nodejs) for environments where
curl is unavailable.

Convert skill descriptions from declarative to imperative form. Add
references to tools and projects mentioned throughout the descriptions.
Improve clarity and conciseness across all 21 skills.

Update cloning.md to reflect that wt no longer automatically pushes
after clone.

Add new skill for generating git tag annotations with formatted-tag CLI.

Also update formatting-commits skill to reference git-format tool and
regenerate token stats in README.

Change default skills directory from ~/.config/crush/skills to
~/.config/agents/skills across Makefile and documentation. This makes the
path more generic and accommodates multiple agents that use this location
(Crush, Octofriend, Shelley, and Amp). Also adds documentation about tested
agents and updates the agent directories table to reflect current
configurations.

Assisted-by: GLM 4.7 via Crush <crush@charm.land>

Restructure the fork rebase workflow to use a break after dropping stale
commits, enabling clean re-picking of feature branches before personal
commits are replayed.

- Rename Step 5 to clarify the drop+break pattern with sed command
- Add new Step 7 for continuing the rebase after re-picks
- Add section on handling bulk mechanical changes (renames, formatting)
- Add explicit warning to never skip commits during conflicts
- Fix anchor link reference to match new section name

Assisted-by: Kimi K2.5 via Crush

Very much a WIP, that's why I haven't listed it yet.

wt init now copies untracked/ignored files to the worktree before
cleanup.

Assisted-by: Claude Opus 4.5 via Amp

Reviews code for correctness, security, reliability, performance, and
quality with anti-noise rules to reduce false positives.

Assisted-by: Claude Opus 4.5 via Amp

Assisted-by: Claude Opus 4.5 via Amp

When amending to add more changes without altering the message, git
commit --amend --no-edit is cleaner than reconstructing the entire
message from reflog via formatted-commit --amend.

Assisted-by: Claude Opus 4.5 via Amp

Add detailed token statistics for each skill including name,
description, body, and references. Provides overall metadata usage
summary to help understand context window consumption.

Assisted-by: GLM 4.7 via Crush <crush@charm.land>

- Track metadata and body token deltas separately
- Fix deadlock by interleaving enqueue and drain operations
- Add HTTP timeout to prevent hanging requests
- Improve error handling throughout token counting
- Update summary output to show metadata/body/overall breakdown
- Fix empty body line counting
- Simplify name validation error message

Assisted-by: GLM 4.7 via Crush

Assisted-by: Kimi K2 Thinking via Crush

Add new resolving-secrets skill for wrapping shell commands with opx to
resolve secret references in environment variables. Update lunatask CLI
references to mention trying lune directly first before falling back to
the resolving-secrets skill.

Assisted-by: Kimi K2 Thinking via Crush <crush@charm.land>

- Renamed scripting-with-roc → writing-roc-lang
- Restructured SKILL.md to focus on general Roc programming
- Moved CLI scripting specifics to references/scripting.md
- Renamed reference files from .txt to .md
- Trimmed reference docs (56% token reduction from original)

Assisted-by: Claude Opus 4.5 via Amp

Adds skill-stats.go, a tool that analyzes skill files in the repository:
- Parses skill frontmatter and body content
- Counts tokens using the Synthetic API
- Validates skill structure and naming conventions
- Generates detailed reports with token breakdowns
- Supports comparison with git HEAD to track changes
- Includes parallel processing for efficiency

Can be run with optional --compare flag to show differences
from the previous commit. Comparisons are integrated into the
main output rather than shown as a separate section.

Assisted-by: Claude Opus 4.5 via Claude Code

Assisted-by: Kimi K2 Thinking via Crush

Enables creating executable Roc scripts with shebang support for
functional, type-safe CLI automation. Includes comprehensive reference
documentation (llms.txt and builtins-llms.txt) and emphasizes code
quality tooling (format, check, test).

Tested shebang execution with both #!/usr/bin/env roc and full paths.

Assisted-by: Claude Opus 4.5 via Claude Code

Enables creating executable Go scripts with shebang-like behavior using
the shell trick from https://lorentz.app/blog-item.html?id=go-shebang

Uses /**/usr/local/go/bin/go run "$0" "$@"; exit; to avoid gopls
formatting issues while allowing direct execution with ./script.go

Assisted-by: Claude Opus 4.5 via Claude Code

- Fix 'complete' → 'completed' (correct status value)
- Document status progression: later → in-progress → completed

Assisted-by: Claude Opus 4.5 via Crush

Replace slash shorthand (projects/crush) with explicit prose (area
`projects` and goal `crush`) to prevent agents from misinterpreting it
as CLI syntax.

Assisted-by: Claude Opus 4.5 via Crush

Assisted-by: Claude Opus 4.5 via Crush

- Add query.fish script (formerly doc-agent.fish from dotfiles)
- Add concrete examples for complex multi-symbol queries
- Rename installing-doc-agent.md → dependencies.md
- Clarify invocation uses absolute path for go doc compatibility

Assisted-by: Claude Opus 4.5 via Crush

- Add explicit note that subagents are cwd-scoped like any agent
- Example now shows cd to target repo before invoking
- Fix typo: "You make invoke" → "You may invoke"

Assisted-by: Claude Opus 4.5 via Crush

Assisted-by: Claude Opus 4.5 via Crush

Generates accessible HTML and frontend code following WCAG 2.2 AA.
Covers semantic HTML, keyboard accessibility, screen reader compat, ARIA
usage, and common antipatterns.

Assisted-by: Claude Opus 4.5 via Crush

- Add 'onboarding guides' framing and 'public good' phrasing
- Add 'What NOT to include' antipatterns section
- Add description as trigger mechanism note
- Add anti-duplication and grep patterns guidelines
- Add bridge/cliff metaphor to degrees of freedom
- Add script testing requirement to checklist
- Create process.md with requirements-gathering and analysis patterns

Assisted-by: Claude Opus 4.5 via Crush