{"slug": "ai-agent-skills-everything-you-need-to-know", "title": "AI Agent Skills: Everything You Need to Know", "summary": "Vercel Labs has launched skills.sh, an open directory and CLI for distributing \"Agent Skills\" — a lightweight, open format that packages specialized knowledge and workflows for AI coding agents such as Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, and Gemini CLI. A skill is a folder containing a SKILL.md file with name and description frontmatter, and agents use progressive disclosure to load only the name and description at startup, pulling in full instructions when a request matches. Skills are installed with a single command, npx skills add owner/repo, and the CLI detects installed agents to place the skill correctly.", "body_md": "In 2024, AI coding agents (Claude, Cursor, Copilot, etc.) became capable enough to do real work. Teams started writing long instruction files and system prompts. But there was no standard way to package, share, or discover them. Every team reinvented the wheel.\n\nToday, we’re creating a complete handbook on how the solution to the issue above came about, how to use it, and how it became one of the most useful things in AI right now: **Agent Skills** and the platform that makes them easy to use — **skills.sh**.\n\nBy the end of this workflow, you will understand:\n\nThis is not Flutter-only. The same system works whether you write Flutter, React, backend code, DevOps, or even content. I’ll use Flutter as one practical example, but everything here is flexible.\n\nLet’s get into it.\n\nAn Agent Skill is a lightweight, open format for giving AI agents specialized knowledge and workflows. At its core, a skill is just a folder that contains a file called SKILL.md.\n\nHere’s the basic structure:\n\n```\nmy-skill/\n├── SKILL.md          ← Required\n├── scripts/          ← Optional\n├── references/       ← Optional\n└── assets/           ← Optional\n```\n\nThe `SKILL.md` file has two parts:\n\nThe description is extremely important. Agents only load the name and description of every skill at startup. When your request matches a skill’s description, the agent then loads the full instructions. This is called **progressive disclosure** — it keeps the context window clean even if you have dozens of skills installed.\n\nNow, what is **skills.sh**?\n\n[skills.sh](https://www.skills.sh/) is the open directory and CLI for the Agent Skills ecosystem. Think of it as the npm for AI agent capabilities. It was built by Vercel Labs and works across many agents, including Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, Gemini CLI, and more.\n\nYou install skills with a single command:\n\n`npx skills add owner/repo`\n\nThat’s it. The CLI detects which agents you have and installs the skill in the right place.\n\nYou can browse popular skills on [skills.sh](https://www.skills.sh/), see a leaderboard, and discover what the community is building.\n\nLet me show you how this looks in practice.\n\nFirst, installing a skill is simple; run: `npx skills add vercel-labs/agent-skills`\n\n*Note: You need to have Node.js installed on your machine; [download and install it](https://nodejs.org/en/download).*\n\nYou can also install any public repo that contains skills.\n\nOnce installed, the agent can automatically use them when relevant.\n\nHere are four strong examples of skills.\n\n```\n---\nname: pr-review\ndescription: \"Reviews pull requests for bugs, security issues, code quality, and adherence to best practices. Use when the user asks to review a PR, check a diff, or get feedback before merging.\"\n---\n```\n\nThis one works on any codebase.\n\n```\n---\nname: flutter-widget-test\ndescription: Generates high-quality Flutter widget tests following best practices. Use when the user asks to write tests for a Flutter widget, create widget tests, or improve test coverage for UI components.\n---\n```\n\nThis shows how you can encode framework-specific knowledge.\n\n```\n---\nname: generate-changelog\ndescription: Generates clean, professional changelog entries or release notes from git commits or PR descriptions. Use when the user asks for a changelog, release notes, or version summary.\n---\n```\n\nSuper practical for any project.\n\n```\n---\nname: brand-voice\ndescription: Writes content following a consistent professional brand voice. Use when creating LinkedIn posts, Twitter/X threads, blog intros, product announcements, or any marketing copy.\n---\n```\n\nThis proves skills are not only for code. You can package writing style, design systems, internal processes — anything repeatable.\n\nThis is the most important part of the workflow.\n\nCreating a skill is straightforward.\n\n**Step 1:** Create a folder and the required file\n\n```\nmkdir my-skill\ntouch my-skill/SKILL.md\n```\n\n**Step 2:** Write the frontmatter\n\nThe two required fields are **name** and **description**.\n\nThe description is what the agent uses to decide whether to activate the skill. Be specific. Include the kind of phrases a real user would say.\n\n```\n---\nname: my-skill-name\ndescription: What it does and when to use it.\nInclude real trigger phrases here.\n---\n```\n\n**Step 3:** Write clear instructions\n\nGood structure usually includes:\n\nWrite it like you’re explaining it to a smart new teammate.\n\n**Step 4:** Test with real prompts\n\nInstall locally with `npx skills add ./my-skill` then trigger it with exact phrases. If it doesn't activate, the description needs to be more specific.\n\n**Key tips while creating:**\n\nOnce you’re happy with it, you can install it locally and start using it right away.\n\nYou have two main ways to share.\n\n**1. With your team / private**\n\nJust commit the skills folder into your repository. Everyone who clones the project gets the skills.\n\n**2. Publicly with skills.sh**\n\nPush the skill to a public GitHub repository. You have two common structures:\n\n```\n# Single skill\nmy-repo/\n└── SKILL.md\n\n# Multi-skill\nmy-repo/\n├── pr-review/\n│ └── SKILL.md\n└── changelog/\n└── SKILL.md\n```\n\nThen anyone can install it with:\n\n```\n# Public: single-skill repo\nnpx skills add your-username/my-skill\n```\n\nor target a specific skill:\n\n```\n# Public: multi-skill repo \nnpx skills add you/repo --skill name\n```\n\nYou can also add the skills.sh badge to your README so people can see install counts.\n\nClear name + excellent description = more people will find and use your skill.\n\nHere are the practices that separate good skills from great ones:\n\nFollow these, and your skills will actually get used instead of sitting unused.\n\nThat’s the complete handbook.\n\nYou now know:\n\nThe biggest shift is this: instead of repeating the same instructions in every chat, you package the knowledge once and let any compatible agent use it.\n\nIf you create a skill after reading this, drop the GitHub link in the comments. I’d love to see what you build.\n\nIf you found this valuable, hit like, subscribe, and turn on notifications.\n\nI also offer 1-on-1 mentorship if you want help setting up skills or AI workflows for your team — [click here](https://calendar.app.google/j4FfEbsehwtmjgXn6).\n\nI’ll see you in the next one. Peace.", "url": "https://wpnews.pro/news/ai-agent-skills-everything-you-need-to-know", "canonical_source": "https://dev.to/techwithsam/ai-agent-skills-everything-you-need-to-know-44pi", "published_at": "2026-09-18 12:25:34+00:00", "updated_at": "2026-09-18 12:53:01.678755+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "developer-tools", "agent-protocols", "ai-products"], "entities": ["Vercel Labs", "Claude Code", "Cursor", "GitHub Copilot", "Windsurf", "Gemini CLI", "Codex"], "alternates": {"html": "https://wpnews.pro/news/ai-agent-skills-everything-you-need-to-know", "markdown": "https://wpnews.pro/news/ai-agent-skills-everything-you-need-to-know.md", "text": "https://wpnews.pro/news/ai-agent-skills-everything-you-need-to-know.txt", "jsonld": "https://wpnews.pro/news/ai-agent-skills-everything-you-need-to-know.jsonld"}}