agent-skills

A collection of Agent Skills; structured markdown that extends LLM agent capabilities through a standardised format.

Available Skills

• authoring-skills: Creates well-structured Agent Skills following best practices. Use when writing new skills, reviewing existing skills, or when the user mentions skill authoring.
• formatting-commits: Creates commits strictly following Conventional Commits format via the formatted-commit CLI.
• invoking-subagents: Invokes ad-hoc subagents to read through lots of data and extract relevant information. Useful for exploring repositories, reading git logs, reviewing large diffs.
• querying-documentation: Spawns focused agents to search specific language/framework documentation and answer moderately complex queries.
• resolving-secrets: Wraps shell commands to resolve secret references in environment variables. Use when invoking synu, crush, gh, hut, etc.
• deferring-work-through-lunatask: Captures findings, suggestions, and deferred work items in Lunatask with rich context for future sessions.
• resuming-work-through-lunatask: Resumes previously deferred work from Lunatask. Use when user pastes a task note, shares a deep link, or references continuing earlier work.

Installation

Clone the repository, then symlink the skills you want into your agent's skills directory.

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

With GNU Stow

Get it from your preferred/available package manager (definitely true on Linux, I assume so on macOS and Windows)

# Install all skills
stow -d skills -t ~/.config/crush/skills .

# Install specific skills
stow -d skills -t ~/.config/crush/skills authoring-skills …

# Remove a skill
stow -D -d skills -t ~/.config/crush/skills formatting-commits

With symlinks

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

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

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

Agent skill directories

Updating

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

Symlinked skills, either with stow or regular symlinks, update automatically.

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.