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
10agent capabilities through a standardised format.
11
12[Agent Skills]: https://agentskills.io/
13
14## Available Skills
15
16Refer to [§ Token stats](#token-stats) for a detailed breakdown of each skill's
17token count, plus overall metadata usage. I've used and tested them most with
18[Crush], [Amp], and [Shelley], and to a lesser degree, [Octofriend] and [Pi].
19
20[Crush]: https://github.com/charmbracelet/crush
21[Amp]: https://ampcode.com
22[Shelley]: https://github.com/boldsoftware/shelley
23[Octofriend]: https://github.com/synthetic-lab/octofriend
24[Pi]: https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent
25
26- [addressing-code-review-comments](skills/addressing-code-review-comments/SKILL.md):
27 Finds `CR:` comments in code, gathers feedback, and carries out requested
28 changes.
29- [ast-grep](skills/ast-grep/SKILL.md): Writes [ast-grep] rules for structural
30 code search and modification.
31- [auditing-repositories](skills/auditing-repositories/SKILL.md): Audits open
32 source repositories for security, privacy, and unexpected behavior.
33- [authoring-skills](skills/authoring-skills/SKILL.md): Creates and reviews
34 Agent Skills following best practices. Covers skill structure, frontmatter,
35 and progressive disclosure patterns.
36- [backing-up-with-keld](skills/backing-up-with-keld/SKILL.md): Writes and
37 manages keld configuration for restic backups. Covers TOML preset structure,
38 split preset composition (`home@cloud`), config file discovery, environment
39 variables, and systemd timer setup.
40- [collaborating-through-pr-pico-sh](skills/collaborating-through-pr-pico-sh/SKILL.md):
41 Collaborates on git patches via [pr.pico.sh], a minimal patchbin service.
42 Covers both contributing and reviewing patch requests using `git format-patch`
43 and `git am`.
44- [creating-tasks-through-lunatask](skills/creating-tasks-through-lunatask/SKILL.md):
45 Creates tasks and handoffs in [Lunatask] via [lune]. Tasks are just tasks.
46 Handoffs capture work to resume later across sessions without filling context
47 windows.
48- [formatting-commits](skills/formatting-commits/SKILL.md): Detects a project's
49 commit style from recent history and formats messages accordingly. Supports
50 Conventional Commits and kernel-style imperative commits.
51- [fallback-code-review](skills/fallback-code-review/SKILL.md): Provides a
52 fallback-only external review flow via CLI tools like Amp, CodeRabbit, or
53 Kodus.
54- [frontend-accessibility](skills/frontend-accessibility/SKILL.md): Strives to
55 generate accessible HTML, React, and frontend code following WCAG 2.2 AA.
56 Prioritizes semantic HTML over ARIA, keyboard navigation, and screen reader
57 compatibility.
58- [handling-customer-data](skills/handling-customer-data/SKILL.md): Queries
59 customer data responsibly—the agent answers questions about the data without
60 ever seeing it directly.
61- [humanizer](skills/humanizer/SKILL.md): Removes AI-generated patterns from
62 text like promotional fluff, weasel words, and mechanical sentence structures.
63 Based on Wikipedia's AI Cleanup research. Originally from [blader/humanizer].
64- [ideating-with-bdd](skills/ideating-with-bdd/SKILL.md): Guides collaborative
65 discovery of behaviour through structured conversation, iterating with the user
66 to refine ideas into user stories and Gherkin scenarios. Works for any
67 language or framework.
68- [initialising-and-updating-agents-md](skills/initialising-and-updating-agents-md/SKILL.md):
69 Analyses a codebase and creates or updates `AGENTS.md` to help future agents
70 work effectively. Discovers commands, conventions, patterns, and gotchas from
71 the project's source and config files.
72- [invoking-subagents](skills/invoking-subagents/SKILL.md): Spawns subagents
73 with restricted tool access for parallel tasks across repositories. Requires
74 [the Pi coding agent][Pi]. Useful for summarizing git history or processing
75 large diffs without filling the main context window.
76- [maintaining-aur-packages](skills/maintaining-aur-packages/SKILL.md): Creates
77 and updates AUR packages following Arch packaging standards. Covers PKGBUILDs
78 for source, `-bin`, and `-git` package types, checksums with `updpkgsums`,
79 linting with `namcap`, and `.SRCINFO` generation.
80- [managing-and-navigating-worktrees](skills/managing-and-navigating-worktrees/SKILL.md):
81 Manages git worktrees using [wt] with a bare repository structure. Each branch
82 lives in its own sibling directory. Requires [wt], git, and [gum].
83- [monitoring-with-munin](skills/monitoring-with-munin/SKILL.md): Deploys and
84 manages Munin monitoring across servers. Sets up munin-node on hosts, writes
85 plugins, configures masters, and handles alerts.
86- [notifying-through-ntfy](skills/notifying-through-ntfy/SKILL.md): Sends push
87 notifications via [ntfy.sh] when requested, such as at the end of its turn.
88- [rebasing-with-git](skills/rebasing-with-git/SKILL.md): Manages git rebase
89 workflows from simple rebases to the drop-and-repick integration branch
90 pattern. Assumes `upstream` remote for forks and `rerere` enabled. Supports
91 worktrees including `wt`-managed repos.
92- [researching-with-rumilo](skills/researching-with-rumilo/SKILL.md): Dispatches
93 AI research subagents via [rumilo] for web search and repository exploration.
94 Research topics, look up library usage, or explore external codebases without
95 filling the main context window.
96- [resuming-work-through-lunatask](skills/resuming-work-through-lunatask/SKILL.md):
97 Resumes deferred work from [Lunatask] handoff notes via [lune].
98- [scripting-with-go](skills/scripting-with-go/SKILL.md): Creates executable Go
99 scripts using a shell trick (not a true shebang). For automation and tooling
100 outside of Go projects.
101- [testing-with-gocuke-and-gherkin](skills/testing-with-gocuke-and-gherkin/SKILL.md):
102 Drives BDD, red/green TDD, and property-based testing in Go projects using
103 [gocuke] and Gherkin feature files.
104- [updating-llm-client-model-lists](skills/updating-llm-client-model-lists/SKILL.md):
105 Synchronizes model configurations across Zed, Crush, Octofriend, and Pi from
106 Plexus' /v1/models endpoint.
107- [using-exe-dev](skills/using-exe-dev/SKILL.md): Guides working with [exe.dev]
108 VMs, which provide Linux VMs with persistent disks, instant HTTPS, and
109 built-in auth via SSH.
110- [using-goji](skills/using-goji/SKILL.md): Manages goji workspaces and zmx
111 sessions for git worktrees and jj workspaces. Covers conversion, creation,
112 listing, attaching, removal, JSON output, and safe temp-repo testing.
113- [using-jujutsu](skills/using-jujutsu/SKILL.md): Guides [jujutsu] (jj)
114 workflows, covering commit selection, change creation, diff reading, and
115 common pitfalls that trip up agents.
116- [using-silverbullet](skills/using-silverbullet/SKILL.md): Manages notes in
117 [SilverBullet] via the CLI and Space Lua. Covers searching, reading, writing,
118 and editing pages, plus journal and task workflows.
119- [working-with-zmx](skills/working-with-zmx/SKILL.md): Manages persistent
120 terminal sessions for background processes, dev servers, and long-running tasks.
121 Creates sessions, runs commands detached, checks output, and writes files into
122 sessions over SSH.
123- [writing-git-tags](skills/writing-git-tags/SKILL.md): Generates git tag
124 annotations from commit history following Semantic Versioning and Conventional
125 Commits via [git-format].
126- [writing-roc-lang](skills/writing-roc-lang/SKILL.md): Writes Roc code with
127 strong static types, helpful compiler errors, and functional programming.
128 Covers both full applications and one-off scripts.
129- [writing-rust](skills/writing-rust/SKILL.md): Writes idiomatic Rust with
130 strict quality gates: `cargo fmt`, `clippy -- -D warnings`, and required
131 tests. Enforces `thiserror` for libs, `anyhow` for apps, warns against common
132 anti-patterns.
133
134[blader/humanizer]: https://github.com/blader/humanizer
135[ast-grep]: https://github.com/ast-grep/ast-grep
136[git-format]: https://git.secluded.site/git-format
137[gocuke]: https://github.com/tenntenn/gocuke
138[lune]: https://git.secluded.site/lune
139[Lunatask]: https://lunatask.app/
140[ntfy.sh]: https://ntfy.sh
141[rumilo]: https://git.secluded.site/rumilo
142[synu]: https://git.secluded.site/synu
143[wt]: https://git.secluded.site/wt
144[gum]: https://github.com/charmbracelet/gum
145[exe.dev]: https://exe.dev
146[jujutsu]: https://jj-vcs.github.io/jj/latest/
147[SilverBullet]: https://silverbullet.md
148
149## Installation
150
151If you're using [Amp], run `amp skill add
152https://git.secluded.site/agent-skills`. Otherwise, clone the repository, then
153install via `make` or manual symlinks.
154
155[Amp]: https://ampcode.com
156
157```sh
158git clone https://git.secluded.site/agent-skills
159cd agent-skills
160```
161
162### With Make
163
164Skills install to `~/.config/agents/skills/` by default. Override by
165setting `SKILL_DIR`. Tab completion works so you don't have to remember
166skill names or copy/paste.
167
168```sh
169# List available skills
170make list
171
172# Install all skills to default dir
173make all
174
175# Install specific skills to Claude Code
176SKILL_DIR=$HOME/.claude/skills make authoring-skills formatting-commits
177
178# Remove a specific skill from Amp
179make uninstall-authoring-skills SKILL_DIR=$HOME/.config/agents/skills
180
181# Remove all skills from Codex
182make uninstall SKILL_DIR=$HOME/.codex/skills
183```
184
185### With symlinks
186
187```sh
188# Install all skills
189for s in skills/*/; do ln -s "$PWD/$s" ~/.config/agents/skills/; done
190
191# Install specific skills
192ln -s "$PWD/skills/authoring-skills" ~/.config/agents/skills/
193
194# Remove a skill
195rm ~/.config/agents/skills/formatting-commits
196```
197
198### Agent skill directories
199
200| Agent | Dir |
201| --------------------------------------- | -------------------------- |
202| [Crush], [Octofriend], [Shelley], [Amp] | `~/.config/agents/skills/` |
203| [Pi] | `~/.pi/agent/skills/` |
204| Anthropic's Claude Code | `~/.claude/skills/` |
205| OpenAI's Codex | `~/.codex/skills/` |
206
207## Updating
208
209```sh
210cd ~/path/to/agent-skills
211git pull
212```
213
214Symlinked skills update automatically.
215
216## Contributions
217
218Patch requests are in [amolith/llm-projects] on [pr.pico.sh]. You don't need a
219new account to contribute, you don't need to fork this repo, you don't need to
220fiddle with `git send-email`, you don't need to faff with your email client to
221get `git request-pull` working...
222
223You just need:
224
225- Git
226- SSH
227- An SSH key
228
229```sh
230# Clone this repo, make your changes, and commit them
231# Create a new patch request with
232git format-patch origin/main --stdout | ssh pr.pico.sh pr create amolith/llm-projects
233# After potential feedback, submit a revision to an existing patch request with
234git format-patch origin/main --stdout | ssh pr.pico.sh pr add {prID}
235# List patch requests
236ssh pr.pico.sh pr ls amolith/llm-projects
237```
238
239See "How do Patch Requests work?" on [pr.pico.sh]'s home page for a more
240complete example workflow.
241
242[amolith/llm-projects]: https://pr.pico.sh/r/amolith/llm-projects
243[pr.pico.sh]: https://pr.pico.sh
244
245## Token stats
246
247Real token stats as reported by [Synthetic.new]'s [/messages/count_tokens]
248endpoint with [./skill-stats.go](./skill-stats.go).
249
250[Synthetic.new]: https://synthetic.new
251[/messages/count_tokens]: https://dev.synthetic.new/docs/anthropic/messages/count-tokens
252
253```
254=== addressing-code-review-comments ===
255
256Token breakdown:
257 Name: 9 tokens
258 Description: 40 tokens
259 Body: 290 tokens (38 lines)
260 ───────────────────────────────────────────────
261 Total: 339 tokens
262
263=== ast-grep ===
264
265Token breakdown:
266 Name: 7 tokens
267 Description: 76 tokens
268 Body: 2765 tokens (469 lines)
269 References:
270 rule_reference.md 2515 tokens
271 ───────────────────────────────────────────────
272 Total: 5363 tokens
273
274=== auditing-repositories ===
275
276Token breakdown:
277 Name: 8 tokens
278 Description: 51 tokens
279 Body: 1046 tokens (156 lines)
280 References:
281 llm-security.md 427 tokens
282 ───────────────────────────────────────────────
283 Total: 1532 tokens
284
285=== authoring-skills ===
286
287Token breakdown:
288 Name: 8 tokens
289 Description: 32 tokens
290 Body: 861 tokens (105 lines)
291 References:
292 checklist.md 301 tokens
293 patterns.md 880 tokens
294 process.md 311 tokens
295 specification.md 1441 tokens
296 ───────────────────────────────────────────────
297 Total: 3834 tokens
298
299=== backing-up-with-keld ===
300
301Token breakdown:
302 Name: 9 tokens
303 Description: 39 tokens
304 Body: 1742 tokens (235 lines)
305 References:
306 config-examples.md 1415 tokens
307 installation.md 19 tokens
308 ───────────────────────────────────────────────
309 Total: 3224 tokens
310
311=== collaborating-through-pr-pico-sh ===
312
313Token breakdown:
314 Name: 12 tokens
315 Description: 47 tokens
316 Body: 521 tokens (43 lines)
317 References:
318 contributing.md 162 tokens
319 jujutsu.md 516 tokens
320 reviewing.md 406 tokens
321 ───────────────────────────────────────────────
322 Total: 1664 tokens
323
324=== creating-tasks-through-lunatask ===
325
326Token breakdown:
327 Name: 12 tokens
328 Description: 41 tokens
329 Body: 741 tokens (88 lines)
330 References:
331 cli.md 218 tokens
332 handoff.md 1035 tokens
333 installing-lune.md 65 tokens
334 ───────────────────────────────────────────────
335 Total: 2112 tokens
336
337=== fallback-code-review ===
338
339Token breakdown:
340 Name: 7 tokens
341 Description: 79 tokens
342 Body: 489 tokens (56 lines)
343 ───────────────────────────────────────────────
344 Total: 575 tokens
345
346=== formatting-commits ===
347
348Token breakdown:
349 Name: 8 tokens
350 Description: 57 tokens
351 Body: 310 tokens (34 lines)
352 References:
353 conventional-commits.md 362 tokens
354 installing-git-format.md 22 tokens
355 kernel-style.md 526 tokens
356 ───────────────────────────────────────────────
357 Total: 1285 tokens
358
359=== frontend-accessibility ===
360
361Token breakdown:
362 Name: 7 tokens
363 Description: 52 tokens
364 Body: 1080 tokens (148 lines)
365 References:
366 antipatterns.md 1341 tokens
367 patterns.md 2279 tokens
368 ───────────────────────────────────────────────
369 Total: 4759 tokens
370
371=== handling-customer-data ===
372
373Token breakdown:
374 Name: 9 tokens
375 Description: 46 tokens
376 Body: 718 tokens (107 lines)
377 ───────────────────────────────────────────────
378 Total: 773 tokens
379
380=== humanize ===
381
382Token breakdown:
383 Name: 6 tokens
384 Description: 100 tokens
385 Body: 1869 tokens (135 lines)
386 References:
387 DETAILED_PATTERNS.md 1903 tokens
388 REPLACEMENTS.md 1125 tokens
389 ───────────────────────────────────────────────
390 Total: 5003 tokens
391
392=== ideating-with-bdd ===
393
394Token breakdown:
395 Name: 9 tokens
396 Description: 133 tokens
397 Body: 1582 tokens (177 lines)
398 References:
399 gherkin-reference.md 984 tokens
400 ───────────────────────────────────────────────
401 Total: 2708 tokens
402
403=== initialising-and-updating-agents-md ===
404
405Token breakdown:
406 Name: 12 tokens
407 Description: 59 tokens
408 Body: 850 tokens (63 lines)
409 ───────────────────────────────────────────────
410 Total: 921 tokens
411
412=== invoking-subagents ===
413
414Token breakdown:
415 Name: 8 tokens
416 Description: 42 tokens
417 Body: 450 tokens (20 lines)
418 ───────────────────────────────────────────────
419 Total: 500 tokens
420
421=== maintaining-aur-packages ===
422
423Token breakdown:
424 Name: 9 tokens
425 Description: 58 tokens
426 Body: 1439 tokens (103 lines)
427 References:
428 build-patterns.md 1120 tokens
429 ───────────────────────────────────────────────
430 Total: 2626 tokens
431
432=== managing-and-navigating-worktrees ===
433
434Token breakdown:
435 Name: 11 tokens
436 Description: 60 tokens
437 Body: 703 tokens (96 lines)
438 ───────────────────────────────────────────────
439 Total: 774 tokens
440
441=== monitoring-with-munin ===
442
443Token breakdown:
444 Name: 10 tokens
445 Description: 62 tokens
446 Body: 1981 tokens (238 lines)
447 References:
448 writing-plugins.md 1151 tokens
449 ───────────────────────────────────────────────
450 Total: 3204 tokens
451
452=== notifying-through-ntfy ===
453
454Token breakdown:
455 Name: 10 tokens
456 Description: 37 tokens
457 Body: 1052 tokens (89 lines)
458 References:
459 ht.md 383 tokens
460 httpie.md 385 tokens
461 nodejs.md 541 tokens
462 python.md 517 tokens
463 wget.md 430 tokens
464 ───────────────────────────────────────────────
465 Total: 3355 tokens
466
467=== rebasing-with-git ===
468
469Token breakdown:
470 Name: 8 tokens
471 Description: 71 tokens
472 Body: 2317 tokens (232 lines)
473 ───────────────────────────────────────────────
474 Total: 2396 tokens
475
476=== researching-with-rumilo ===
477
478Token breakdown:
479 Name: 10 tokens
480 Description: 60 tokens
481 Body: 1217 tokens (112 lines)
482 ───────────────────────────────────────────────
483 Total: 1287 tokens
484
485=== resuming-work-through-lunatask ===
486
487Token breakdown:
488 Name: 12 tokens
489 Description: 44 tokens
490 Body: 466 tokens (42 lines)
491 References:
492 cli.md 195 tokens
493 installing-lune.md 65 tokens
494 ───────────────────────────────────────────────
495 Total: 782 tokens
496
497=== scripting-with-go ===
498
499Token breakdown:
500 Name: 8 tokens
501 Description: 46 tokens
502 Body: 727 tokens (138 lines)
503 ───────────────────────────────────────────────
504 Total: 781 tokens
505
506=== testing-with-gocuke-and-gherkin ===
507
508Token breakdown:
509 Name: 14 tokens
510 Description: 77 tokens
511 Body: 633 tokens (67 lines)
512 References:
513 bdd-practices.md 261 tokens
514 gocuke-api.md 1427 tokens
515 ───────────────────────────────────────────────
516 Total: 2412 tokens
517
518=== updating-llm-client-model-lists ===
519
520Token breakdown:
521 Name: 13 tokens
522 Description: 50 tokens
523 Body: 1204 tokens (134 lines)
524 ───────────────────────────────────────────────
525 Total: 1267 tokens
526
527=== using-exe-dev ===
528
529Token breakdown:
530 Name: 8 tokens
531 Description: 32 tokens
532 Body: 380 tokens (45 lines)
533 ───────────────────────────────────────────────
534 Total: 420 tokens
535
536=== using-jujutsu ===
537
538Token breakdown:
539 Name: 9 tokens
540 Description: 55 tokens
541 Body: 735 tokens (92 lines)
542 ───────────────────────────────────────────────
543 Total: 799 tokens
544
545=== working-with-zmx ===
546
547Token breakdown:
548 Name: 8 tokens
549 Description: 58 tokens
550 Body: 522 tokens (69 lines)
551 ───────────────────────────────────────────────
552 Total: 588 tokens
553
554=== writing-git-tags ===
555
556Token breakdown:
557 Name: 7 tokens
558 Description: 38 tokens
559 Body: 821 tokens (107 lines)
560 References:
561 installing-git-format.md 22 tokens
562 ───────────────────────────────────────────────
563 Total: 888 tokens
564
565=== writing-roc-lang ===
566
567Token breakdown:
568 Name: 8 tokens
569 Description: 53 tokens
570 Body: 693 tokens (117 lines)
571 References:
572 builtins-llms.md 25216 tokens
573 llms.md 4253 tokens
574 scripting.md 614 tokens
575 ───────────────────────────────────────────────
576 Total: 30837 tokens
577
578=== writing-rust ===
579
580Token breakdown:
581 Name: 7 tokens
582 Description: 45 tokens
583 Body: 1324 tokens (139 lines)
584 References:
585 idioms.md 1708 tokens
586 ───────────────────────────────────────────────
587 Total: 3084 tokens
588
589============================================================
590SUMMARY
591============================================================
592
593Skills: 31
594Metadata: 2023 tokens
595Combined bodies: 31528 tokens
596Overall: 90092 tokens
597Validation errors: 0
598
599Largest skills (by total tokens):
600 1. writing-roc-lang 30837 tokens
601 2. ast-grep 5363 tokens
602 3. humanize 5003 tokens
603 4. frontend-accessibility 4759 tokens
604 5. authoring-skills 3834 tokens
605```
606
607---
608
609Some other tools if these interested you
610
611- [wt](https://git.secluded.site/wt) - CLI for managing git worktrees
612- [git-format](https://git.secluded.site/git-format) - CLI that turns LLM input
613 into well-formatted conventional commits and tags
614- [garble](https://git.secluded.site/garble) - transform stdin with an LLM (fix
615 typos, translate, reformat)
616- [lune](https://git.secluded.site/lune) - CLI and MCP server for
617 [Lunatask.app](https://lunatask.app)