AI world is a wild west, and AI coding agents are the new cowboys. It makes things exciting, but also chaotic. In this post, I try to explain the current situation on AI Agent Skills, because I also didn't know and had to learn it the hard way.
TL;DR : AI Skills are reusable packages. They are NPM packages to your React website, plugable devices to your laptop, and mods to your Skyrim game.
So, let's sit through the chaos and see what we can learn.
What Is an Agent Skill?
The Agent Skills specification defines a portable format centered around a SKILL.md file.
A skill typically looks like this:
my-skill/ βββ SKILL.md βββ scripts/ β βββ validate.sh βββ references/ β βββ guidelines.md βββ assets/
Enter fullscreen mode
Exit fullscreen mode
Only SKILL.md is required. The other directories are optional.
The file begins with YAML frontmatter:
--- name: my-skill description: "Validate a project against" security best practices. ---
# Security Validation 1. Inspect the project. 2.β¦