README.md

agent-skills

A collection of Agent Skills: structured markdown that extends LLM agent capabilities through a standardised format. See § Available skills for the full list.

I've used and tested them most with Crush, Pi, Amp, and Shelley.

Installation

If you're using Amp, run amp skill add https://git.secluded.site/agent-skills. Otherwise, clone the repository, then install via make or manual symlinks.

git clone https://git.secluded.site/agent-skills
cd agent-skills

With Make

Skills install to ~/.agents/skills/ by default. Override by setting SKILL_DIR. Tab completion works so you don't have to remember skill names or copy/paste.

# List available skills
make list

# Install all skills to default dir
make all

# Install specific skills to Claude Code
SKILL_DIR=$HOME/.claude/skills make authoring-skills formatting-commits

# Remove a specific skill from the default dir
make uninstall-authoring-skills

# Remove all skills from Codex
make uninstall SKILL_DIR=$HOME/.codex/skills

# Install all skills
for s in skills/*/; do ln -s "$PWD/$s" ~/.agents/skills/; done

# Install specific skills
ln -s "$PWD/skills/authoring-skills" ~/.agents/skills/

# Remove a skill
rm ~/.agents/skills/formatting-commits

Agent skill directories

Agent Dir
Crush, Shelley, Amp ~/.agents/skills/
Pi ~/.pi/agent/skills/
Anthropic's Claude Code ~/.claude/skills/
OpenAI's Codex ~/.codex/skills/

Updating

cd ~/path/to/agent-skills
git pull

Symlinked skills update automatically.

Available skills

Each skill below lists its install command, source path, and token counts. The counts are computed by ./skill-stats.go against Synthetic.new's /messages/count_tokens endpoint.

addressing-code-review-comments

Finds CR: comments in code, gathers feedback, and carries out requested changes.

amoliths-opinions

Applies Amolith's opinions across project setup, tooling, licensing, dependencies, mise tasks, CLIs, TUIs, MCP servers, web apps, packaging/releases, testing, and Go-specific ecosystem defaults.

  • Install with: make amoliths-opinions
  • Source: skills/amoliths-opinions/
  • Name/desc: 50 tok
  • SKILL.md: 271 tok
  • Full skill: 5210 tok (all .md files in the folder)

ast-grep

Writes ast-grep rules for structural code search and modification.

  • Install with: make ast-grep
  • Source: skills/ast-grep/
  • Name/desc: 43 tok
  • SKILL.md: 1272 tok
  • Full skill: 2457 tok (all .md files in the folder)

auditing-repositories

Audits open source repositories for security, privacy, and unexpected behavior.

  • Install with: make auditing-repositories
  • Source: skills/auditing-repositories/
  • Name/desc: 32 tok
  • SKILL.md: 480 tok
  • Full skill: 707 tok (all .md files in the folder)

authoring-skills

Creates and reviews Agent Skills following best practices. Covers skill structure, frontmatter, and progressive disclosure patterns.

  • Install with: make authoring-skills
  • Source: skills/authoring-skills/
  • Name/desc: 24 tok
  • SKILL.md: 401 tok
  • Full skill: 1787 tok (all .md files in the folder)

backing-up-with-keld

Writes and manages keld configuration for restic backups. Covers TOML preset structure, split preset composition (home@cloud), config file discovery, environment variables, and systemd timer setup.

  • Install with: make backing-up-with-keld
  • Source: skills/backing-up-with-keld/
  • Name/desc: 27 tok
  • SKILL.md: 796 tok
  • Full skill: 1478 tok (all .md files in the folder)

collaborating-through-pr-pico-sh

Collaborates on git patches via pr.pico.sh, a minimal patchbin service. Covers both contributing and reviewing patch requests using git format-patch and git am.

computing-golden-ratio-typography

Computes Golden Ratio Typography line heights, spacing units, type scales, and readable measures from a font file or explicit font metrics.

cooking

Guides home cooking as a technically grounded collaborator. Helps plan meals, use odds and ends, troubleshoot techniques, handle substitutions, and reason through cuisine-specific flavor logic without flattening regional traditions.

  • Install with: make cooking
  • Source: skills/cooking/
  • Name/desc: 86 tok
  • SKILL.md: 1292 tok
  • Full skill: 12751 tok (all .md files in the folder)

creating-tasks-through-lunatask

Creates tasks and handoffs in Lunatask via lune. Tasks are just tasks. Handoffs capture work to resume later across sessions without filling context windows.

fallback-code-review

Provides a fallback-only external review flow via CLI tools like Amp, CodeRabbit, or Kodus.

  • Install with: make fallback-code-review
  • Source: skills/fallback-code-review/
  • Name/desc: 44 tok
  • SKILL.md: 228 tok
  • Full skill: 272 tok (all .md files in the folder)

formatting-commits

Detects a project's commit style from recent history and formats messages accordingly. Supports Conventional Commits and kernel-style imperative commits.

  • Install with: make formatting-commits
  • Source: skills/formatting-commits/
  • Name/desc: 34 tok
  • SKILL.md: 142 tok
  • Full skill: 596 tok (all .md files in the folder)

frontend-accessibility

Strives to generate accessible HTML, React, and frontend code following WCAG 2.2 AA. Prioritizes semantic HTML over ARIA, keyboard navigation, and screen reader compatibility.

  • Install with: make frontend-accessibility
  • Source: skills/frontend-accessibility/
  • Name/desc: 32 tok
  • SKILL.md: 498 tok
  • Full skill: 2173 tok (all .md files in the folder)

handling-customer-data

Queries customer data responsibly—the agent answers questions about the data without ever seeing it directly.

  • Install with: make handling-customer-data
  • Source: skills/handling-customer-data/
  • Name/desc: 29 tok
  • SKILL.md: 331 tok
  • Full skill: 360 tok (all .md files in the folder)

humanize

Removes 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.

  • Install with: make humanize
  • Source: skills/humanize/
  • Name/desc: 55 tok
  • SKILL.md: 860 tok
  • Full skill: 2289 tok (all .md files in the folder)

ideating-with-bdd

Guides collaborative discovery of behaviour through structured conversation, iterating with the user to refine ideas into user stories and Gherkin scenarios. Works for any language or framework.

  • Install with: make ideating-with-bdd
  • Source: skills/ideating-with-bdd/
  • Name/desc: 69 tok
  • SKILL.md: 730 tok
  • Full skill: 1253 tok (all .md files in the folder)

in-session-review

Runs an extremely strict maintainability review for abstraction quality, giant files, and spaghetti-condition growth.

  • Install with: make in-session-review
  • Source: skills/in-session-review/
  • Name/desc: 32 tok
  • SKILL.md: 1015 tok
  • Full skill: 1047 tok (all .md files in the folder)

initialising-and-updating-agents-md

Analyses a codebase and creates or updates AGENTS.md to help future agents work effectively. Discovers commands, conventions, patterns, and gotchas from the project's source and config files.

invoking-subagents

Spawns subagents with restricted tool access for parallel tasks across repositories. Requires the Pi coding agent. Useful for summarizing git history or processing large diffs without filling the main context window.

  • Install with: make invoking-subagents
  • Source: skills/invoking-subagents/
  • Name/desc: 27 tok
  • SKILL.md: 210 tok
  • Full skill: 237 tok (all .md files in the folder)

licensing-with-reuse

Manages REUSE-compliant licensing with the reuse CLI. Covers reuse annotate, .license sidecars for prompt files, custom LicenseRef-... identifiers, LICENSES/, project conventions, and reuse lint.

  • Install with: make licensing-with-reuse
  • Source: skills/licensing-with-reuse/
  • Name/desc: 33 tok
  • SKILL.md: 560 tok
  • Full skill: 593 tok (all .md files in the folder)

maintaining-aur-packages

Creates and updates AUR packages following Arch packaging standards. Covers PKGBUILDs for source, -bin, and -git package types, checksums with updpkgsums, linting with namcap, and .SRCINFO generation.

  • Install with: make maintaining-aur-packages
  • Source: skills/maintaining-aur-packages/
  • Name/desc: 35 tok
  • SKILL.md: 689 tok
  • Full skill: 1274 tok (all .md files in the folder)

managing-personal-knowledge

Works inside a personal knowledge base as an exacting steward, shaping atomic, concept-oriented notes, a dense wikilink graph, and disciplined tags instead of dumping transcripts. Tool-agnostic across Markdown vaults like Obsidian, Logseq, Roam, and SilverBullet.

  • Install with: make managing-personal-knowledge
  • Source: skills/managing-personal-knowledge/
  • Name/desc: 68 tok
  • SKILL.md: 859 tok
  • Full skill: 2172 tok (all .md files in the folder)

monitoring-with-munin

Deploys and manages Munin monitoring across servers. Sets up munin-node on hosts, writes plugins, configures masters, and handles alerts.

  • Install with: make monitoring-with-munin
  • Source: skills/monitoring-with-munin/
  • Name/desc: 38 tok
  • SKILL.md: 907 tok
  • Full skill: 1470 tok (all .md files in the folder)

notifying-through-ntfy

Sends push notifications via ntfy.sh when requested, such as at the end of its turn.

  • Install with: make notifying-through-ntfy
  • Source: skills/notifying-through-ntfy/
  • Name/desc: 26 tok
  • SKILL.md: 478 tok
  • Full skill: 1541 tok (all .md files in the folder)

rebasing-with-git

Manages 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.

  • Install with: make rebasing-with-git
  • Source: skills/rebasing-with-git/
  • Name/desc: 41 tok
  • SKILL.md: 1057 tok
  • Full skill: 1098 tok (all .md files in the folder)

researching-with-rumilo

Dispatches AI research subagents via rumilo for web search and repository exploration. Research topics, look up library usage, or explore external codebases without filling the main context window.

  • Install with: make researching-with-rumilo
  • Source: skills/researching-with-rumilo/
  • Name/desc: 37 tok
  • SKILL.md: 557 tok
  • Full skill: 594 tok (all .md files in the folder)

scripting-with-go

Creates executable Go scripts using a shell trick (not a true shebang). For automation and tooling outside of Go projects. For scripting in a non-Go project, copy the header comment and adjust as needed.

  • Install with: make scripting-with-go
  • Source: skills/scripting-with-go/
  • Name/desc: 29 tok
  • SKILL.md: 333 tok
  • Full skill: 362 tok (all .md files in the folder)

testing-with-gocuke-and-gherkin

Drives BDD, red/green TDD, and property-based testing in Go projects using gocuke and Gherkin feature files.

toki-pona-dictionary

Searches the nimi.li toki pona dictionary by English meaning. Caches word data locally after a one-time fetch, then runs offline searches across definitions and community usage tags.

  • Install with: make toki-pona-dictionary
  • Source: skills/toki-pona-dictionary/
  • Name/desc: 48 tok
  • SKILL.md: 114 tok
  • Full skill: 162 tok (all .md files in the folder)

updating-llm-client-model-lists

Synchronizes model configurations across Zed, Crush, and Pi from Plexus' /v1/models endpoint.

using-exe-dev

Guides working with exe.dev VMs, which provide Linux VMs with persistent disks, instant HTTPS, and built-in auth via SSH.

  • Install with: make using-exe-dev
  • Source: skills/using-exe-dev/
  • Name/desc: 24 tok
  • SKILL.md: 176 tok
  • Full skill: 200 tok (all .md files in the folder)

using-jujutsu

Guides jujutsu (jj) workflows, covering commit selection, change creation, diff reading, and common pitfalls that trip up agents.

  • Install with: make using-jujutsu
  • Source: skills/using-jujutsu/
  • Name/desc: 35 tok
  • SKILL.md: 337 tok
  • Full skill: 372 tok (all .md files in the folder)

working-with-zmx

Manages persistent terminal sessions for background processes, dev servers, and long-running tasks. Creates sessions, runs commands detached, checks output, and writes files into sessions over SSH.

  • Install with: make working-with-zmx
  • Source: skills/working-with-zmx/
  • Name/desc: 35 tok
  • SKILL.md: 241 tok
  • Full skill: 276 tok (all .md files in the folder)

writing-git-tags

Generates git tag annotations from commit history following Semantic Versioning and Conventional Commits via git-format.

  • Install with: make writing-git-tags
  • Source: skills/writing-git-tags/
  • Name/desc: 26 tok
  • SKILL.md: 386 tok
  • Full skill: 425 tok (all .md files in the folder)

writing-rust

Writes 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.

  • Install with: make writing-rust
  • Source: skills/writing-rust/
  • Name/desc: 29 tok
  • SKILL.md: 607 tok
  • Full skill: 1425 tok (all .md files in the folder)

Contributions

Patch requests are in amolith/llm-projects on pr.pico.sh. You don't need a new account to contribute, you don't need to fork this repo, you don't need to fiddle with git send-email, you don't need to faff with your email client to get git request-pull working...

You just need:

  • Git
  • SSH
  • An SSH key
# Clone this repo, make your changes, and commit them
# Create a new patch request with
git format-patch origin/main --stdout | ssh pr.pico.sh pr create amolith/llm-projects
# After potential feedback, submit a revision to an existing patch request with
git format-patch origin/main --stdout | ssh pr.pico.sh pr add {prID}
# List patch requests
ssh pr.pico.sh pr ls amolith/llm-projects

See "How do Patch Requests work?" on pr.pico.sh's home page for a more complete example workflow.

Some other tools if these interested you

  • wt - CLI for managing git worktrees
  • git-format - CLI that turns LLM input into well-formatted conventional commits and tags
  • garble - transform stdin with an LLM (fix typos, translate, reformat)
  • lune - CLI and MCP server for Lunatask.app