This directory contains skills that guide how AI agents work with your projects. Skills are modular, reusable expertise modules that agents consult automatically based on triggers.
New to skills? See Getting Started below, then read AGENTS.md for creation guidelines.
agents/
├── README.md # This file
├── AGENTS.md # Skill creation and management guidelines
├── skills/ # Personal skills
│ ├── cua-computer-use/
│ ├── my-agent-file-conventions/
│ ├── my-code-review/
│ ├── my-crawl4ai/
│ ├── my-krea/
│ ├── my-semantic-release/
│ ├── my-team-orchestrate/
│ ├── my-tech-stack/
│ ├── my-web-search-kagi/
│ └── my-workflow/
└── .pi/
└── agents/ # Agent definitions
| Skill | Trigger | Purpose |
|---|---|---|
cua-computer-use |
"computer-use", "screen control", "GUI automation" | macOS app control, screenshots, clicking |
my-agent-file-conventions |
"AGENT.md", "claude.md", "agent file" | What belongs in agent files, templates, boundaries |
my-code-review |
"code review", "PR review", "check my code" | Research-based code quality reviews |
my-crawl4ai |
"crawl4ai", "web scraping", "scrape data" | Web crawling with crawl4ai |
my-krea |
"generate image", "make a video", "AI image" | Image and video generation with Krea AI |
my-semantic-release |
"release", "changelog", "semver" | Semantic versioning and release workflows |
my-tech-stack |
"what should I use", "bun or node" | Preferred tools and technology recommendations |
my-web-search-kagi |
"search the web", "look up", "google" | Web search via agent-browser + Kagi |
my-workflow |
"assessing task direction", "should I switch" | Worktrunk discipline, commit timing, naming hygiene |
Quick setup for new users:
-
Clone this repo:
git clone https://github.com/alexleekt/agents.git ~/agents -
Symlink skills for Pi:
mkdir -p ~/.agents/skills ln -sf ~/git/my-agent-skills/skills/* ~/.agents/skills/
-
Verify setup:
ls ~/.agents/skills/ # Should show: my-agent-file-conventions, my-code-review, etc.
Creating your first skill:
- Read
AGENTS.md→ "Creating New Skills" section - Description must be ≤1024 characters (Pi constraint)
- Use
wc -cto check:head -20 SKILL.md | grep -A 100 "^description:" | wc -c
When starting work:
- Check for project-specific agent files — Look for
AGENT.mdorclaude.mdin the project root - Use skill references — Consult
@skills/my-tech-stackfor tool recommendations,@skills/my-agent-file-conventionsfor agent file creation - Skills auto-load — Pi reads from
~/.agents/skills/(symlinked from this directory)
- Adding skills: See
AGENTS.mdfor skill creation workflow - Updating skills: Edit files in
skills/<skill-name>/SKILL.md, changes auto-commit via chezmoi - Distributing: Skills are symlinked to
~/.agents/skills/for Pi and~/.claude/skills/for Claude Code
Previous conventions/agent-conventions.md and preferences/tech-preferences.md have been superseded by my-agent-file-conventions and my-tech-stack skills respectively. The legacy files are preserved in git history but removed from the working tree.
are preserved in git history but removed from the working tree.