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