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: 167 tok
  • SKILL.md: 958 tok
  • Full skill: 19392 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: 137 tok
  • SKILL.md: 4731 tok
  • Full skill: 9172 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: 113 tok
  • SKILL.md: 1983 tok
  • Full skill: 2902 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: 71 tok
  • SKILL.md: 1499 tok
  • Full skill: 6733 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: 72 tok
  • SKILL.md: 3077 tok
  • Full skill: 5662 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: 283 tok
  • SKILL.md: 5428 tok
  • Full skill: 47930 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: 136 tok
  • SKILL.md: 773 tok
  • Full skill: 909 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: 116 tok
  • SKILL.md: 514 tok
  • Full skill: 2127 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: 112 tok
  • SKILL.md: 1900 tok
  • Full skill: 8058 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: 93 tok
  • SKILL.md: 1221 tok
  • Full skill: 1314 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: 191 tok
  • SKILL.md: 3110 tok
  • Full skill: 8132 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: 223 tok
  • SKILL.md: 2533 tok
  • Full skill: 4393 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: 109 tok
  • SKILL.md: 3958 tok
  • Full skill: 4067 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: 85 tok
  • SKILL.md: 766 tok
  • Full skill: 851 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: 117 tok
  • SKILL.md: 2059 tok
  • Full skill: 2176 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: 119 tok
  • SKILL.md: 2496 tok
  • Full skill: 4821 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: 247 tok
  • SKILL.md: 2935 tok
  • Full skill: 7441 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: 117 tok
  • SKILL.md: 3432 tok
  • Full skill: 5522 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: 70 tok
  • SKILL.md: 1832 tok
  • Full skill: 6058 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: 137 tok
  • SKILL.md: 3937 tok
  • Full skill: 4074 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: 101 tok
  • SKILL.md: 1970 tok
  • Full skill: 2071 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: 93 tok
  • SKILL.md: 1250 tok
  • Full skill: 1343 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: 128 tok
  • SKILL.md: 407 tok
  • Full skill: 535 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: 79 tok
  • SKILL.md: 705 tok
  • Full skill: 784 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: 101 tok
  • SKILL.md: 1170 tok
  • Full skill: 1271 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: 108 tok
  • SKILL.md: 838 tok
  • Full skill: 946 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: 80 tok
  • SKILL.md: 1440 tok
  • Full skill: 1557 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: 91 tok
  • SKILL.md: 2348 tok
  • Full skill: 5426 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