@@ -24,55 +24,74 @@ token count, plus overall metadata usage. I've used and tested them most with
[Pi]: https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent
- [addressing-agent-comments](skills/addressing-agent-comments/SKILL.md): Finds
- `AGENT:` comments in code, gathers feedback, and carries out requested changes
-- [ast-grep](skills/ast-grep/SKILL.md): have the LLM write ast-grep rules to
- perform structural code search and analysis using the AST
-- [authoring-skills](skills/authoring-skills/SKILL.md): Creates
- well-structured Agent Skills following best practices. Use when
- writing new skills, reviewing existing skills, or when the user
- mentions skill authoring.
+ `AGENT:` comments in code, gathers feedback, and carries out requested
+ changes.
+- [ast-grep](skills/ast-grep/SKILL.md): Write [ast-grep] rules for structural
+ code search and analysis. Find patterns the way the compiler sees them, not
+ just as text.
+- [authoring-skills](skills/authoring-skills/SKILL.md): Create and review Agent
+ Skills following best practices. Covers skill structure, frontmatter, and
+ progressive disclosure patterns.
- [creating-tasks-through-lunatask](skills/creating-tasks-through-lunatask/SKILL.md):
- Creates tasks in Lunatask for todos, reminders, deferred work, and
- handoffs.
-- [formatting-commits](skills/formatting-commits/SKILL.md): Creates
- commits strictly following Conventional Commits format via the
- `formatted-commit` CLI.
-- [frontend-accessibility](skills/frontend-accessibility/SKILL.md):
- Generates accessible HTML, React, and frontend code following WCAG 2.2
- AA guidelines. Focuses on semantic HTML, keyboard accessibility, and
- screen reader compatibility.
-- [handling-customer-data](skills/handling-customer-data/SKILL.md):
- Handles customer data responsibly by answering questions about data
- without ever seeing the data directly.
-- [humanizer](skills/humanizer/SKILL.md): removes signs of AI-generated writing
- from text, making it sound more natural and human (initially copied from
- [blader/humanizer] then customised)
-- [invoking-subagents](skills/invoking-subagents/SKILL.md): Invokes
- ad-hoc subagents to read through lots of data and extract relevant
- information. Useful for exploring repositories, reading git logs,
- reviewing large diffs.
+ Create tasks and handoffs in [Lunatask] via [lune]. Tasks are just tasks.
+ Handoffs capture work to resume later across sessions without filling context
+ windows.
+- [formatting-commits](skills/formatting-commits/SKILL.md): Create commits
+ following Conventional Commits format via [git-format].
+- [frontend-accessibility](skills/frontend-accessibility/SKILL.md): Generate
+ accessible HTML, React, and frontend code following WCAG 2.2 AA. Prioritizes
+ semantic HTML over ARIA, keyboard navigation, and screen reader compatibility.
+- [handling-customer-data](skills/handling-customer-data/SKILL.md): Query
+ customer data responsibly—the agent answers questions about the data without
+ ever seeing it directly.
+- [humanizer](skills/humanizer/SKILL.md): Remove AI-generated patterns from text
+ like promotional fluff, weasel words, and mechanical sentence structures.
+ Based on Wikipedia's AI Cleanup research. Originally from [blader/humanizer].
+- [invoking-subagents](skills/invoking-subagents/SKILL.md): Spawn subagents with
+ restricted tool access for parallel tasks across repositories. Requires [synu]
+ and the `claude` CLI. Useful for summarizing git history or processing large
+ diffs without filling the main context window.
- [managing-and-navigating-worktrees](skills/managing-and-navigating-worktrees/SKILL.md):
- Manages git worktrees and repos using the wt CLI. Use when cloning or
- creating new repos, adding worktrees, switching branches.
-- [querying-documentation](skills/querying-documentation/SKILL.md):
- Spawns focused agents to search specific language/framework
- documentation and answer moderately complex queries.
+ Git worktree management using [wt] with a bare repository structure. Each
+ branch lives in its own sibling directory. Requires [wt], git, and [gum].
+- [querying-documentation](skills/querying-documentation/SKILL.md): Query Go
+ documentation with focused subagents for complex questions spanning multiple
+ packages or external libraries. Requires Fish shell and [synu]. Currently
+ Go-only.
+- [rebasing-with-git](skills/rebasing-with-git/SKILL.md): Git rebase workflows
+ from simple rebases to the drop-and-repick integration branch pattern. Assumes
+ `upstream` remote for forks and `rerere` enabled. Supports worktrees including
+ `wt`-managed repos.
- [resuming-work-through-lunatask](skills/resuming-work-through-lunatask/SKILL.md):
- Resumes previously deferred work from Lunatask. Use when user pastes a
- task note, shares a deep link, or references continuing earlier work.
-- [reviewing-code](skills/reviewing-code/SKILL.md): Reviews code for
- correctness, security, reliability, performance, and quality. Use when
- asked to review code, a PR, a diff, or changes.
-- [scripting-with-go](skills/scripting-with-go/SKILL.md): Creates
- executable Go scripts with shebang-like behavior for long-lived
- automation.
-- [working-with-tmux](skills/working-with-tmux/SKILL.md): Lets the LLM create,
- manage, and capture output from tmux sessions/windows
-- [writing-roc-lang](skills/writing-roc-lang/SKILL.md): Writes Roc code
- with strong static types, helpful compiler errors, and functional
- programming. Covers both full applications and one-off scripts.
+ Resume deferred work from [Lunatask] handoff notes via [lune].
+- [reviewing-code](skills/reviewing-code/SKILL.md): Review code for correctness,
+ security, reliability, performance, and quality. Covers PRs, diffs, and
+ general change review.
+- [scripting-with-go](skills/scripting-with-go/SKILL.md): Create executable Go
+ scripts using a shell trick (not a true shebang). For automation and tooling
+ outside of Go projects.
+- [working-with-tmux](skills/working-with-tmux/SKILL.md): Spawn and manage
+ background processes via tmux. Create windows, send commands, and capture
+ output without blocking the main session. Useful for servers and long tasks.
+- [writing-git-tags](skills/writing-git-tags/SKILL.md): Generate git tag
+ annotations from commit history following Semantic Versioning and Conventional
+ Commits via [git-format].
+- [writing-roc-lang](skills/writing-roc-lang/SKILL.md): Write Roc code with
+ strong static types, helpful compiler errors, and functional programming.
+ Covers both full applications and one-off scripts.
+- [writing-rust](skills/writing-rust/SKILL.md): Write idiomatic Rust with strict
+ quality gates: `cargo fmt`, `clippy -- -D warnings`, and required tests.
+ Enforces `thiserror` for libs, `anyhow` for apps, warns against common
+ anti-patterns.
[blader/humanizer]: https://github.com/blader/humanizer
+[ast-grep]: https://github.com/ast-grep/ast-grep
+[git-format]: https://git.secluded.site/git-format
+[lune]: https://git.secluded.site/lune
+[Lunatask]: https://lunatask.app/
+[synu]: https://git.secluded.site/synu
+[wt]: https://git.secluded.site/wt
+[gum]: https://github.com/charmbracelet/gum
## Installation