I Built a Collection of AI Agent Skills — Here's How They Work

Description and use

Create a repository of SKILL.md files, place them in .agents/skills/, and your AI agent will automatically apply rules (e.g., Conventional Commits) without manual prompts.

Problem

AI coding agents are generalists and produce inconsistent results for specific tasks like enforcing Conventional Commits or auditing Dockerfiles.

Outcome

Teams achieve consistent AI agent behavior, faster onboarding, and reduced prompt fatigue by committing a shared .agents/skills/ folder.

Workflow

• Create a free, open‑source repo of SKILL.md files.
• Place a skill folder in .agents/skills/ with a YAML frontmatter and markdown instructions.
• Configure the agent to read .agents/skills/ (e.g., Antigravity IDE).
• When the agent is about to perform a task (commit, review, audit), it loads the matching skill and applies its rules.
• Commit .agents/skills/ to the project repo so all team members inherit the same AI behavior.

Evidence

Agent generates: git commit -m "fix stuff" without a skill.

Agent generates: git commit -m "fix(auth): resolve token expiry not clearing session cookie" with the skill.