1<!--
2SPDX-FileCopyrightText: Amolith <amolith@secluded.site>
3
4SPDX-License-Identifier: CC0-1.0
5-->
6
7# agent-skills
8
9A collection of [Agent Skills]: structured markdown that extends LLM agent
10capabilities through a standardised format. See [§ Available
11skills](#available-skills) for the full list.
12
13[Agent Skills]: https://agentskills.io/
14
15I've used and tested them most with [Crush], [Pi], [Amp], and [Shelley].
16
17[Crush]: https://github.com/charmbracelet/crush
18[Pi]: https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent
19[Amp]: https://ampcode.com
20[Shelley]: https://github.com/boldsoftware/shelley
21
22## Installation
23
24If you're using [Amp], run `amp skill add
25https://git.secluded.site/agent-skills`. Otherwise, clone the repository, then
26install via `make` or manual symlinks.
27
28[Amp]: https://ampcode.com
29
30```sh
31git clone https://git.secluded.site/agent-skills
32cd agent-skills
33```
34
35### With Make
36
37Skills install to `~/.agents/skills/` by default. Override by setting
38`SKILL_DIR`. Tab completion works so you don't have to remember skill names or
39copy/paste.
40
41```sh
42# List available skills
43make list
44
45# Install all skills to default dir
46make all
47
48# Install specific skills to Claude Code
49SKILL_DIR=$HOME/.claude/skills make authoring-skills formatting-commits
50
51# Remove a specific skill from the default dir
52make uninstall-authoring-skills
53
54# Remove all skills from Codex
55make uninstall SKILL_DIR=$HOME/.codex/skills
56```
57
58### With symlinks
59
60```sh
61# Install all skills
62for s in skills/*/; do ln -s "$PWD/$s" ~/.agents/skills/; done
63
64# Install specific skills
65ln -s "$PWD/skills/authoring-skills" ~/.agents/skills/
66
67# Remove a skill
68rm ~/.agents/skills/formatting-commits
69```
70
71### Agent skill directories
72
73| Agent | Dir |
74| ------------------------- | --------------------- |
75| [Crush], [Shelley], [Amp] | `~/.agents/skills/` |
76| [Pi] | `~/.pi/agent/skills/` |
77| Anthropic's Claude Code | `~/.claude/skills/` |
78| OpenAI's Codex | `~/.codex/skills/` |
79
80## Updating
81
82```sh
83cd ~/path/to/agent-skills
84git pull
85```
86
87Symlinked skills update automatically.
88
89## Available skills
90
91Each skill below lists its install command, source path, and token counts. The
92counts are computed by [./skill-stats.go](./skill-stats.go) against
93[Synthetic.new]'s [/messages/count_tokens] endpoint.
94
95[Synthetic.new]: https://synthetic.new
96[/messages/count_tokens]: https://dev.synthetic.new/docs/anthropic/messages/count-tokens
97
98### addressing-code-review-comments
99
100Finds `CR:` comments in code, gathers feedback, and carries out requested
101changes.
102
103- Install with: `make addressing-code-review-comments`
104- Source: [skills/addressing-code-review-comments/](skills/addressing-code-review-comments/)
105- Name/desc: 81 tok
106- SKILL.md: 444 tok
107- Full skill: 525 tok (all `.md` files in the folder)
108
109### amoliths-opinions
110
111Applies Amolith's opinions across project setup, tooling, licensing,
112dependencies, mise tasks, CLIs, TUIs, MCP servers, web apps, packaging/releases,
113testing, and Go-specific ecosystem defaults.
114
115- Install with: `make amoliths-opinions`
116- Source: [skills/amoliths-opinions/](skills/amoliths-opinions/)
117- Name/desc: 167 tok
118- SKILL.md: 958 tok
119- Full skill: 19392 tok (all `.md` files in the folder)
120
121### ast-grep
122
123Writes [ast-grep] rules for structural code search and modification.
124
125[ast-grep]: https://github.com/ast-grep/ast-grep
126
127- Install with: `make ast-grep`
128- Source: [skills/ast-grep/](skills/ast-grep/)
129- Name/desc: 137 tok
130- SKILL.md: 4731 tok
131- Full skill: 9172 tok (all `.md` files in the folder)
132
133### auditing-repositories
134
135Audits open source repositories for security, privacy, and unexpected behavior.
136
137- Install with: `make auditing-repositories`
138- Source: [skills/auditing-repositories/](skills/auditing-repositories/)
139- Name/desc: 113 tok
140- SKILL.md: 1983 tok
141- Full skill: 2902 tok (all `.md` files in the folder)
142
143### authoring-skills
144
145Creates and reviews Agent Skills following best practices. Covers skill
146structure, frontmatter, and progressive disclosure patterns.
147
148- Install with: `make authoring-skills`
149- Source: [skills/authoring-skills/](skills/authoring-skills/)
150- Name/desc: 71 tok
151- SKILL.md: 1499 tok
152- Full skill: 6733 tok (all `.md` files in the folder)
153
154### backing-up-with-keld
155
156Writes and manages keld configuration for restic backups. Covers TOML preset
157structure, split preset composition (`home@cloud`), config file discovery,
158environment variables, and systemd timer setup.
159
160- Install with: `make backing-up-with-keld`
161- Source: [skills/backing-up-with-keld/](skills/backing-up-with-keld/)
162- Name/desc: 72 tok
163- SKILL.md: 3077 tok
164- Full skill: 5662 tok (all `.md` files in the folder)
165
166### collaborating-through-pr-pico-sh
167
168Collaborates on git patches via [pr.pico.sh], a minimal patchbin service. Covers
169both contributing and reviewing patch requests using `git format-patch` and
170`git am`.
171
172[pr.pico.sh]: https://pr.pico.sh
173
174- Install with: `make collaborating-through-pr-pico-sh`
175- Source: [skills/collaborating-through-pr-pico-sh/](skills/collaborating-through-pr-pico-sh/)
176- Name/desc: 103 tok
177- SKILL.md: 849 tok
178- Full skill: 2785 tok (all `.md` files in the folder)
179
180### computing-golden-ratio-typography
181
182Computes Golden Ratio Typography line heights, spacing units, type scales, and
183readable measures from a font file or explicit font metrics.
184
185- Install with: `make computing-golden-ratio-typography`
186- Source: [skills/computing-golden-ratio-typography/](skills/computing-golden-ratio-typography/)
187- Name/desc: 120 tok
188- SKILL.md: 1901 tok
189- Full skill: 2021 tok (all `.md` files in the folder)
190
191### cooking
192
193Guides home cooking as a technically grounded collaborator. Helps plan meals,
194use odds and ends, troubleshoot techniques, handle substitutions, and reason
195through cuisine-specific flavor logic without flattening regional traditions.
196
197- Install with: `make cooking`
198- Source: [skills/cooking/](skills/cooking/)
199- Name/desc: 283 tok
200- SKILL.md: 5428 tok
201- Full skill: 47930 tok (all `.md` files in the folder)
202
203### creating-tasks-through-lunatask
204
205Creates tasks and handoffs in [Lunatask] via [lune]. Tasks are just tasks.
206Handoffs capture work to resume later across sessions without filling context
207windows.
208
209[lune]: https://git.secluded.site/lune
210[Lunatask]: https://lunatask.app/
211
212- Install with: `make creating-tasks-through-lunatask`
213- Source: [skills/creating-tasks-through-lunatask/](skills/creating-tasks-through-lunatask/)
214- Name/desc: 84 tok
215- SKILL.md: 1190 tok
216- Full skill: 3428 tok (all `.md` files in the folder)
217
218### fallback-code-review
219
220Provides a fallback-only external review flow via CLI tools like Amp,
221CodeRabbit, or Kodus.
222
223- Install with: `make fallback-code-review`
224- Source: [skills/fallback-code-review/](skills/fallback-code-review/)
225- Name/desc: 136 tok
226- SKILL.md: 773 tok
227- Full skill: 909 tok (all `.md` files in the folder)
228
229### formatting-commits
230
231Detects a project's commit style from recent history and formats messages
232accordingly. Supports Conventional Commits and kernel-style imperative commits.
233
234- Install with: `make formatting-commits`
235- Source: [skills/formatting-commits/](skills/formatting-commits/)
236- Name/desc: 116 tok
237- SKILL.md: 514 tok
238- Full skill: 2127 tok (all `.md` files in the folder)
239
240### frontend-accessibility
241
242Strives to generate accessible HTML, React, and frontend code following WCAG
2432.2 AA. Prioritizes semantic HTML over ARIA, keyboard navigation, and screen
244reader compatibility.
245
246- Install with: `make frontend-accessibility`
247- Source: [skills/frontend-accessibility/](skills/frontend-accessibility/)
248- Name/desc: 112 tok
249- SKILL.md: 1900 tok
250- Full skill: 8058 tok (all `.md` files in the folder)
251
252### handling-customer-data
253
254Queries customer data responsibly—the agent answers questions about the data
255without ever seeing it directly.
256
257- Install with: `make handling-customer-data`
258- Source: [skills/handling-customer-data/](skills/handling-customer-data/)
259- Name/desc: 93 tok
260- SKILL.md: 1221 tok
261- Full skill: 1314 tok (all `.md` files in the folder)
262
263### humanize
264
265Removes AI-generated patterns from text like promotional fluff, weasel words,
266and mechanical sentence structures. Based on Wikipedia's AI Cleanup research.
267Originally from [blader/humanizer].
268
269[blader/humanizer]: https://github.com/blader/humanizer
270
271- Install with: `make humanize`
272- Source: [skills/humanize/](skills/humanize/)
273- Name/desc: 191 tok
274- SKILL.md: 3110 tok
275- Full skill: 8132 tok (all `.md` files in the folder)
276
277### ideating-with-bdd
278
279Guides collaborative discovery of behaviour through structured conversation,
280iterating with the user to refine ideas into user stories and Gherkin
281scenarios. Works for any language or framework.
282
283- Install with: `make ideating-with-bdd`
284- Source: [skills/ideating-with-bdd/](skills/ideating-with-bdd/)
285- Name/desc: 223 tok
286- SKILL.md: 2533 tok
287- Full skill: 4393 tok (all `.md` files in the folder)
288
289### in-session-review
290
291Runs an extremely strict maintainability review for abstraction quality, giant
292files, and spaghetti-condition growth.
293
294- Install with: `make in-session-review`
295- Source: [skills/in-session-review/](skills/in-session-review/)
296- Name/desc: 109 tok
297- SKILL.md: 3958 tok
298- Full skill: 4067 tok (all `.md` files in the folder)
299
300### initialising-and-updating-agents-md
301
302Analyses a codebase and creates or updates `AGENTS.md` to help future agents
303work effectively. Discovers commands, conventions, patterns, and gotchas from
304the project's source and config files.
305
306- Install with: `make initialising-and-updating-agents-md`
307- Source: [skills/initialising-and-updating-agents-md/](skills/initialising-and-updating-agents-md/)
308- Name/desc: 111 tok
309- SKILL.md: 1426 tok
310- Full skill: 1537 tok (all `.md` files in the folder)
311
312### invoking-subagents
313
314Spawns subagents with restricted tool access for parallel tasks across
315repositories. Requires [the Pi coding agent][Pi]. Useful for summarizing git
316history or processing large diffs without filling the main context window.
317
318- Install with: `make invoking-subagents`
319- Source: [skills/invoking-subagents/](skills/invoking-subagents/)
320- Name/desc: 85 tok
321- SKILL.md: 766 tok
322- Full skill: 851 tok (all `.md` files in the folder)
323
324### licensing-with-reuse
325
326Manages REUSE-compliant licensing with the `reuse` CLI. Covers `reuse annotate`,
327`.license` sidecars for prompt files, custom `LicenseRef-...` identifiers,
328`LICENSES/`, project conventions, and `reuse lint`.
329
330- Install with: `make licensing-with-reuse`
331- Source: [skills/licensing-with-reuse/](skills/licensing-with-reuse/)
332- Name/desc: 117 tok
333- SKILL.md: 2059 tok
334- Full skill: 2176 tok (all `.md` files in the folder)
335
336### maintaining-aur-packages
337
338Creates and updates AUR packages following Arch packaging standards. Covers
339PKGBUILDs for source, `-bin`, and `-git` package types, checksums with
340`updpkgsums`, linting with `namcap`, and `.SRCINFO` generation.
341
342- Install with: `make maintaining-aur-packages`
343- Source: [skills/maintaining-aur-packages/](skills/maintaining-aur-packages/)
344- Name/desc: 119 tok
345- SKILL.md: 2496 tok
346- Full skill: 4821 tok (all `.md` files in the folder)
347
348### managing-personal-knowledge
349
350Works inside a personal knowledge base as an exacting steward, shaping atomic,
351concept-oriented notes, a dense wikilink graph, and disciplined tags instead of
352dumping transcripts. Tool-agnostic across Markdown vaults like Obsidian,
353Logseq, Roam, and SilverBullet.
354
355- Install with: `make managing-personal-knowledge`
356- Source: [skills/managing-personal-knowledge/](skills/managing-personal-knowledge/)
357- Name/desc: 247 tok
358- SKILL.md: 2935 tok
359- Full skill: 7441 tok (all `.md` files in the folder)
360
361### monitoring-with-munin
362
363Deploys and manages Munin monitoring across servers. Sets up munin-node on
364hosts, writes plugins, configures masters, and handles alerts.
365
366- Install with: `make monitoring-with-munin`
367- Source: [skills/monitoring-with-munin/](skills/monitoring-with-munin/)
368- Name/desc: 117 tok
369- SKILL.md: 3432 tok
370- Full skill: 5522 tok (all `.md` files in the folder)
371
372### notifying-through-ntfy
373
374Sends push notifications via [ntfy.sh] when requested, such as at the end of its
375turn.
376
377[ntfy.sh]: https://ntfy.sh
378
379- Install with: `make notifying-through-ntfy`
380- Source: [skills/notifying-through-ntfy/](skills/notifying-through-ntfy/)
381- Name/desc: 70 tok
382- SKILL.md: 1832 tok
383- Full skill: 6058 tok (all `.md` files in the folder)
384
385### rebasing-with-git
386
387Manages git rebase workflows from simple rebases to the drop-and-repick
388integration branch pattern. Assumes `upstream` remote for forks and `rerere`
389enabled. Supports worktrees including `wt`-managed repos.
390
391- Install with: `make rebasing-with-git`
392- Source: [skills/rebasing-with-git/](skills/rebasing-with-git/)
393- Name/desc: 137 tok
394- SKILL.md: 3937 tok
395- Full skill: 4074 tok (all `.md` files in the folder)
396
397### researching-with-rumilo
398
399Dispatches AI research subagents via [rumilo] for web search and repository
400exploration. Research topics, look up library usage, or explore external
401codebases without filling the main context window.
402
403[rumilo]: https://git.secluded.site/rumilo
404
405- Install with: `make researching-with-rumilo`
406- Source: [skills/researching-with-rumilo/](skills/researching-with-rumilo/)
407- Name/desc: 101 tok
408- SKILL.md: 1970 tok
409- Full skill: 2071 tok (all `.md` files in the folder)
410
411### scripting-with-go
412
413Creates executable Go scripts using a shell trick (not a true shebang). For
414automation and tooling outside of Go projects. For scripting in a non-Go
415project, copy the header comment and adjust as needed.
416
417- Install with: `make scripting-with-go`
418- Source: [skills/scripting-with-go/](skills/scripting-with-go/)
419- Name/desc: 93 tok
420- SKILL.md: 1250 tok
421- Full skill: 1343 tok (all `.md` files in the folder)
422
423### testing-with-gocuke-and-gherkin
424
425Drives BDD, red/green TDD, and property-based testing in Go projects using
426[gocuke] and Gherkin feature files.
427
428[gocuke]: https://github.com/tenntenn/gocuke
429
430- Install with: `make testing-with-gocuke-and-gherkin`
431- Source: [skills/testing-with-gocuke-and-gherkin/](skills/testing-with-gocuke-and-gherkin/)
432- Name/desc: 150 tok
433- SKILL.md: 1093 tok
434- Full skill: 4107 tok (all `.md` files in the folder)
435
436### toki-pona-dictionary
437
438Searches the [nimi.li] toki pona dictionary by English meaning. Caches word
439data locally after a one-time fetch, then runs offline searches across
440definitions and community usage tags.
441
442[nimi.li]: https://nimi.li
443
444- Install with: `make toki-pona-dictionary`
445- Source: [skills/toki-pona-dictionary/](skills/toki-pona-dictionary/)
446- Name/desc: 128 tok
447- SKILL.md: 407 tok
448- Full skill: 535 tok (all `.md` files in the folder)
449
450### updating-llm-client-model-lists
451
452Synchronizes model configurations across Zed, Crush, and Pi from Plexus'
453/v1/models endpoint.
454
455- Install with: `make updating-llm-client-model-lists`
456- Source: [skills/updating-llm-client-model-lists/](skills/updating-llm-client-model-lists/)
457- Name/desc: 99 tok
458- SKILL.md: 3835 tok
459- Full skill: 3934 tok (all `.md` files in the folder)
460
461### using-exe-dev
462
463Guides working with [exe.dev] VMs, which provide Linux VMs with persistent
464disks, instant HTTPS, and built-in auth via SSH.
465
466[exe.dev]: https://exe.dev
467
468- Install with: `make using-exe-dev`
469- Source: [skills/using-exe-dev/](skills/using-exe-dev/)
470- Name/desc: 79 tok
471- SKILL.md: 705 tok
472- Full skill: 784 tok (all `.md` files in the folder)
473
474### using-jujutsu
475
476Guides [jujutsu] (jj) workflows, covering commit selection, change creation,
477diff reading, and common pitfalls that trip up agents.
478
479[jujutsu]: https://jj-vcs.github.io/jj/latest/
480
481- Install with: `make using-jujutsu`
482- Source: [skills/using-jujutsu/](skills/using-jujutsu/)
483- Name/desc: 101 tok
484- SKILL.md: 1170 tok
485- Full skill: 1271 tok (all `.md` files in the folder)
486
487### working-with-zmx
488
489Manages persistent terminal sessions for background processes, dev servers, and
490long-running tasks. Creates sessions, runs commands detached, checks output, and
491writes files into sessions over SSH.
492
493- Install with: `make working-with-zmx`
494- Source: [skills/working-with-zmx/](skills/working-with-zmx/)
495- Name/desc: 108 tok
496- SKILL.md: 838 tok
497- Full skill: 946 tok (all `.md` files in the folder)
498
499### writing-git-tags
500
501Generates git tag annotations from commit history following Semantic Versioning
502and Conventional Commits via [git-format].
503
504[git-format]: https://git.secluded.site/git-format
505
506- Install with: `make writing-git-tags`
507- Source: [skills/writing-git-tags/](skills/writing-git-tags/)
508- Name/desc: 80 tok
509- SKILL.md: 1440 tok
510- Full skill: 1557 tok (all `.md` files in the folder)
511
512### writing-rust
513
514Writes idiomatic Rust with strict quality gates: `cargo fmt`, `clippy -- -D
515warnings`, and required tests. Enforces `thiserror` for libs, `anyhow` for apps,
516warns against common anti-patterns.
517
518- Install with: `make writing-rust`
519- Source: [skills/writing-rust/](skills/writing-rust/)
520- Name/desc: 91 tok
521- SKILL.md: 2348 tok
522- Full skill: 5426 tok (all `.md` files in the folder)
523
524## Contributions
525
526Patch requests are in [amolith/llm-projects] on [pr.pico.sh]. You don't need a
527new account to contribute, you don't need to fork this repo, you don't need to
528fiddle with `git send-email`, you don't need to faff with your email client to
529get `git request-pull` working...
530
531You just need:
532
533- Git
534- SSH
535- An SSH key
536
537```sh
538# Clone this repo, make your changes, and commit them
539# Create a new patch request with
540git format-patch origin/main --stdout | ssh pr.pico.sh pr create amolith/llm-projects
541# After potential feedback, submit a revision to an existing patch request with
542git format-patch origin/main --stdout | ssh pr.pico.sh pr add {prID}
543# List patch requests
544ssh pr.pico.sh pr ls amolith/llm-projects
545```
546
547See "How do Patch Requests work?" on [pr.pico.sh]'s home page for a more
548complete example workflow.
549
550[amolith/llm-projects]: https://pr.pico.sh/r/amolith/llm-projects
551[pr.pico.sh]: https://pr.pico.sh
552
553---
554
555Some other tools if these interested you
556
557- [wt](https://git.secluded.site/wt) - CLI for managing git worktrees
558- [git-format](https://git.secluded.site/git-format) - CLI that turns LLM input
559 into well-formatted conventional commits and tags
560- [garble](https://git.secluded.site/garble) - transform stdin with an LLM (fix
561 typos, translate, reformat)
562- [lune](https://git.secluded.site/lune) - CLI and MCP server for
563 [Lunatask.app](https://lunatask.app)