A New Kind of Package for AI Agents: Markdown

In the past, GitHub's popular repositories were centered on executable code such as frameworks or databases. Recently, however, repositories where the Markdown files themselves are the core package have been rapidly increasing. This is due to the nature of AI coding agents, which read Instructions first before modifying code.

AI Agent Skills are reusable packages that include Markdown instructions, examples, scripts, and more to teach an agent how to perform a specific workflow. While existing libraries provide new features to software, skills improve the Behavior of agents.

These Markdown files are not replacing tests or CI/CD, but are establishing themselves as important engineering artifacts one level above that, directly influencing the code an agent will write, the tests it will add, and the risks it will check.