Personal Agent Skills#
This repository is the canonical home for reusable personal agent skills.
Layout#
skills/
<skill-name>/
SKILL.md
references/ # optional, loaded on demand
scripts/ # optional, invoked by the skill
scripts/
link-skills.sh # installs every skill by symlink
Each directory under skills/ is an independent Agent Skills package. Keep project-specific facts in the consuming repository's AGENTS.md; skills should contain reusable workflows.
Install all skills#
./scripts/link-skills.sh
The installer creates links in both locations used by the local agent setup:
~/.agents/skills/<name>→ this repository~/.pi/agent/skills/<name>→ the corresponding universal skill link
It is idempotent and refuses to overwrite unrelated files or links.
Preview or remove managed links:
./scripts/link-skills.sh --dry-run
./scripts/link-skills.sh --unlink
Add a skill#
mkdir -p skills/my-skill
$EDITOR skills/my-skill/SKILL.md
./scripts/link-skills.sh
The name in SKILL.md must match its lowercase, hyphenated directory name. Restart the agent session after adding or changing skill discovery links.