What is ai-agent-skills?

ai-agent-skills is a curated collection of 191 skill files across 28 categories, designed to teach AI coding agents how to handle specific programming tasks. The core idea is simple: instead of letting an AI agent improvise when you ask it to debug code, review a pull request, or run a deployment, you give it a skill, a plain markdown file containing step by step procedures, best practices, and documented pitfalls for that workflow. Skills are just markdown files. There is no code to install and no library dependencies to manage. You copy them into the folder your agent reads, such as ~/.claude/skills/ for Claude Code or ~/.cursor/skills/ for Cursor, and the agent can follow proven workflows rather than guessing. The repository supports Hermes Agent, Claude Code, Cursor, and any other agent that reads markdown instruction files from a configured directory. Most of the 191 skills are aggregated from other publicly available repositories, with full attribution recorded in a NOTICE file and per-skill source metadata. The stated value add of this repo is the aggregation, categorization, conflict detection, validation tooling, and a single installer script that handles copying and setup. Installation takes one command. An interactive installer script lets you browse categories, choose curated starter packs (such as a developer preset covering around 92 skills or a minimal preset with 14 skills), install one category at a time, or preview changes with a dry run before anything is copied. The repo also exposes a local REST API on port 5555 and linting tooling that validates skill file frontmatter.