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