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- [resolving-secrets](skills/resolving-secrets/SKILL.md): Wraps shell
 31  commands to resolve secret references in environment variables. Use
 32  when invoking `synu`, `crush`, `gh`, `hut`, etc.
 33- [creating-tasks-through-lunatask](skills/creating-tasks-through-lunatask/SKILL.md):
 34  Creates tasks in Lunatask for todos, reminders, deferred work, and
 35  handoffs.
 36- [resuming-work-through-lunatask](skills/resuming-work-through-lunatask/SKILL.md):
 37  Resumes previously deferred work from Lunatask. Use when user pastes a
 38  task note, shares a deep link, or references continuing earlier work.
 39
 40## Installation
 41
 42Clone the repository, then install skills via `make` or manual symlinks.
 43
 44```sh
 45git clone https://git.secluded.site/agent-skills
 46cd agent-skills
 47```
 48
 49### With Make
 50
 51Skills install to `~/.config/crush/skills/` by default. Override by
 52setting `SKILL_DIR`. Tab completion works so you don't have to remember
 53skill names or copy/paste.
 54
 55```sh
 56# List available skills
 57make list
 58
 59# Install all skills to default dir
 60make all
 61
 62# Install specific skills to Claude Code
 63SKILL_DIR=$HOME/.claude/skills make authoring-skills formatting-commits
 64
 65# Remove a specific skill from Amp
 66make uninstall-authoring-skills SKILL_DIR=$HOME/.config/agents/skills
 67
 68# Remove all skills from Codex
 69make uninstall SKILL_DIR=$HOME/.codex/skills
 70```
 71
 72### With symlinks
 73
 74```sh
 75# Install all skills
 76for s in skills/*/; do ln -s "$PWD/$s" ~/.config/crush/skills/; done
 77
 78# Install specific skills
 79ln -s "$PWD/skills/authoring-skills" ~/.config/crush/skills/
 80
 81# Remove a skill
 82rm ~/.config/crush/skills/formatting-commits
 83```
 84
 85### Agent skill directories
 86
 87| Agent                   | Dir                        |
 88| ----------------------- | -------------------------- |
 89| Crush                   | `~/.config/crush/skills/`  |
 90| Amp                     | `~/.config/agents/skills/` |
 91| Anthropic's Claude Code | `~/.claude/skills/`        |
 92| OpenAI's Codex          | `~/.codex/skills/`         |
 93
 94## Updating
 95
 96```sh
 97cd ~/path/to/agent-skills
 98git pull
 99```
100
101Symlinked skills update automatically.
102
103## Contributions
104
105Patch requests are in [amolith/llm-projects] on [pr.pico.sh]. You don't
106need a new account to contribute, you don't need to fork this repo, you
107don't need to fiddle with `git send-email`, you don't need to faff with
108your email client to get `git request-pull` working...
109
110You just need:
111
112- Git
113- SSH
114- An SSH key
115
116```sh
117# Clone this repo, make your changes, and commit them
118# Create a new patch request with
119git format-patch origin/main --stdout | ssh pr.pico.sh pr create amolith/llm-projects
120# After potential feedback, submit a revision to an existing patch request with
121git format-patch origin/main --stdout | ssh pr.pico.sh pr add {prID}
122# List patch requests
123ssh pr.pico.sh pr ls amolith/llm-projects
124```
125
126See "How do Patch Requests work?" on [pr.pico.sh]'s home page for a more
127complete example workflow.
128
129[amolith/llm-projects]: https://pr.pico.sh/r/amolith/llm-projects
130[pr.pico.sh]: https://pr.pico.sh