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.
• creating-tasks-through-lunatask: Creates tasks in Lunatask for todos, reminders, deferred work, and handoffs.
• 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.
• frontend-accessibility: Generates accessible HTML, React, and frontend code following WCAG 2.2 AA guidelines. Focuses on semantic HTML, keyboard accessibility, and screen reader compatibility.
• handling-customer-data: Handles customer data responsibly by answering questions about data without ever seeing the data directly.
• scripting-with-go: Creates executable Go scripts with shebang-like behavior for long-lived automation.
• writing-roc-lang: Writes Roc code with strong static types, helpful compiler errors, and functional programming. Covers both full applications and one-off scripts.
• resolving-secrets: Wraps shell commands to resolve secret references in environment variables.

Installation

Clone the repository, then install skills via make or manual symlinks.

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

With Make

Skills install to ~/.config/crush/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 Amp
make uninstall-authoring-skills SKILL_DIR=$HOME/.config/agents/skills

# Remove all skills from Codex
make uninstall SKILL_DIR=$HOME/.codex/skills

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 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.