Skills

A collection of reusable agent skills (SKILL.md files) that enhance AI agent workflows.

Skills

Skill	Description
handoff	Create a summary document for another agent continue the work.
readme-writer	Provide/update a README.md file for a project.
squeeze	Find redundant or unnecessary code and refactor to make it efficient and readable.

Installation

1. Clone this repository.
2. Copy the skill directories into your agent's skills folder (e.g. ~/.agents/skills/).

git clone https://github.com/your-user/skills
cp -r skills/skills/* ~/.agents/skills/

Usage

Each skill directory contains a SKILL.md file with instructions the agent reads when triggered. Skills are invoked by matching their description to the task at hand.

• Ask for a project summary → triggers handoff
• Ask to document a project → triggers readme-writer
• Ask to clean up or refactor code → triggers squeeze

SKILL.md structure

Every skill must use the same structure so the content is easy to scan and consistent across the collection.

1. Frontmatter — name and description (the description is what triggers the skill).
2. Title — a # <Name> heading.
3. Use when — one paragraph describing when the skill triggers, including alternative phrasings.
4. Steps — a numbered ## Steps list with the concrete actions.
5. Guidelines — a bulleted ## Guidelines list with constraints and best practices.

Contributing

Add a new skill as a directory under skills/ containing a SKILL.md following the pattern above.