diff --git a/README.md b/README.md index 504c95af533fde56fa46cc3d901d7b795537b874..90b0f3f493d61679d3ddaed169689f0d5de10f3d 100644 --- a/README.md +++ b/README.md @@ -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