Skip to content

cat work/agent-skills.md

agent-skills: shareable agentic AI skills for Claude Code

role:
Author and maintainer
timeline:
2025, ongoing
stack:
Markdown · Claude Code · Shell

View the source ↗

agent-skills repository readme showing the skill catalog

Problem and constraints

TODO: why shareable skills needed to exist, what was missing in the Claude Code workflow, and the constraint of keeping skills portable across machines and teams.

Key decisions

TODO: 3 to 5 decisions in Decision, Why, Tradeoff format. Candidates: plain Markdown over a custom format, one skill per file, how triggers are worded, versioning approach.

The hard part

TODO: one war story in depth. Candidate: getting skill triggers to fire reliably without over-triggering.

Results and lessons

TODO: adoption numbers (stars, forks, users), what the open source process taught, 2 to 3 lessons.