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
 16- [authoring-skills](skills/authoring-skills/SKILL.md): Creates
 17  well-structured Agent Skills following best practices. Use when
 18  writing new skills, reviewing existing skills, or when the user
 19  mentions skill authoring.
 20- [formatting-commits](skills/formatting-commits/SKILL.md): Creates
 21  commits strictly following Conventional Commits format via the
 22  `formatted-commit` CLI.
 23- [invoking-subagents](skills/invoking-subagents/SKILL.md): Invokes
 24  ad-hoc subagents to read through lots of data and extract relevant
 25  information. Useful for exploring repositories, reading git logs,
 26  reviewing large diffs.
 27- [querying-documentation](skills/querying-documentation/SKILL.md):
 28  Spawns focused agents to search specific language/framework
 29  documentation and answer moderately complex queries.
 30- [creating-tasks-through-lunatask](skills/creating-tasks-through-lunatask/SKILL.md):
 31  Creates tasks in Lunatask for todos, reminders, deferred work, and
 32  handoffs.
 33- [resuming-work-through-lunatask](skills/resuming-work-through-lunatask/SKILL.md):
 34  Resumes previously deferred work from Lunatask. Use when user pastes a
 35  task note, shares a deep link, or references continuing earlier work.
 36- [frontend-accessibility](skills/frontend-accessibility/SKILL.md):
 37  Generates accessible HTML, React, and frontend code following WCAG 2.2
 38  AA guidelines. Focuses on semantic HTML, keyboard accessibility, and
 39  screen reader compatibility.
 40
 41## Installation
 42
 43Clone the repository, then install skills via `make` or manual symlinks.
 44
 45```sh
 46git clone https://git.secluded.site/agent-skills
 47cd agent-skills
 48```
 49
 50### With Make
 51
 52Skills install to `~/.config/crush/skills/` by default. Override by
 53setting `SKILL_DIR`. Tab completion works so you don't have to remember
 54skill names or copy/paste.
 55
 56```sh
 57# List available skills
 58make list
 59
 60# Install all skills to default dir
 61make all
 62
 63# Install specific skills to Claude Code
 64SKILL_DIR=$HOME/.claude/skills make authoring-skills formatting-commits
 65
 66# Remove a specific skill from Amp
 67make uninstall-authoring-skills SKILL_DIR=$HOME/.config/agents/skills
 68
 69# Remove all skills from Codex
 70make uninstall SKILL_DIR=$HOME/.codex/skills
 71```
 72
 73### With symlinks
 74
 75```sh
 76# Install all skills
 77for s in skills/*/; do ln -s "$PWD/$s" ~/.config/crush/skills/; done
 78
 79# Install specific skills
 80ln -s "$PWD/skills/authoring-skills" ~/.config/crush/skills/
 81
 82# Remove a skill
 83rm ~/.config/crush/skills/formatting-commits
 84```
 85
 86### Agent skill directories
 87
 88| Agent                   | Dir                        |
 89| ----------------------- | -------------------------- |
 90| Crush                   | `~/.config/crush/skills/`  |
 91| Amp                     | `~/.config/agents/skills/` |
 92| Anthropic's Claude Code | `~/.claude/skills/`        |
 93| OpenAI's Codex          | `~/.codex/skills/`         |
 94
 95## Updating
 96
 97```sh
 98cd ~/path/to/agent-skills
 99git pull
100```
101
102Symlinked skills update automatically.
103
104## Contributions
105
106Patch requests are in [amolith/llm-projects] on [pr.pico.sh]. You don't
107need a new account to contribute, you don't need to fork this repo, you
108don't need to fiddle with `git send-email`, you don't need to faff with
109your email client to get `git request-pull` working...
110
111You just need:
112
113- Git
114- SSH
115- An SSH key
116
117```sh
118# Clone this repo, make your changes, and commit them
119# Create a new patch request with
120git format-patch origin/main --stdout | ssh pr.pico.sh pr create amolith/llm-projects
121# After potential feedback, submit a revision to an existing patch request with
122git format-patch origin/main --stdout | ssh pr.pico.sh pr add {prID}
123# List patch requests
124ssh pr.pico.sh pr ls amolith/llm-projects
125```
126
127See "How do Patch Requests work?" on [pr.pico.sh]'s home page for a more
128complete example workflow.
129
130[amolith/llm-projects]: https://pr.pico.sh/r/amolith/llm-projects
131[pr.pico.sh]: https://pr.pico.sh