Agent Skills (SKILL.md)
Agent extension format in AI tools
A simple Markdown-based way to give AI agents extra knowledge and tool instructions, loaded only when needed to save context; agents often skip or ignore skills.
A simple Markdown-based way to give AI agents extra knowledge and tool instructions, loaded only when needed to save context; agents often skip or ignore skills.
155 people gave an opinion
- recommend it
- 98
- criticize it
- 57
- approval share
- 63%
Recommended in 11 of 13 months
- November 2025: recommended
- December 2025: recommended
- January 2026: recommended
- February 2026: recommended
- March 2026: recommended
- April 2026: recommended
- May 2026: recommended
- June 2026: recommended
- July 2026: recommended
- August 2026: recommended
- September 2026: recommended
- October 2026: not recommended
- November 2026: not recommended (month in progress)
Why it doesn’t carry the badge
- 98 people recommend itNeeds 10 or more, met.
- 1.7 recommenders for every criticNeeds 2 to 1 or better, not met.
- Recommended in 11 of 13 monthsNeeds 4 or more, met.
The same three rules apply to every product, and the badge can’t be bought. How the badge works
What people say about it
The reasons people give, with the number of comments that give each one. Open a reason to read what they said.
Why people recommend it
Each mark is one comment
Progressive disclosure saves context
“Skills also have a nicer way of working with the context, by default (and in the main web uis), with their overview-driven lazy loading.”
Comment from 13 Dec 2025 in “OpenAI are quietly adopting skills, now available in ChatGPT and Codex CLI” “they're certainly superior to MCP in ways, being much easier to implement and reducing context usage by being discoverable”
Comment from 16 Jan 2026 in “First impressions of Claude Cowork, Anthropic's general agent” “OCI packaged, verifiable skills for Flux that should progressively discovery instead of loading everything into context”
Comment from 8 Apr 2026 in “Why GitOps still matters in a world of AI agents (FluxCon) [video]” - Comment from 16 Mar 2026 in “Let your Coding Agent debug the browser session with Chrome DevTools MCP”
- Comment from 10 Apr 2026 in “I Still Prefer MCP over Skills”
- Comment from 10 Apr 2026 in “I Still Prefer MCP over Skills”
- Comment from 26 Feb 2026 in “I made MCP cheaper in one command”
- Comment from 29 Jan 2026 in “Compressed Agents.md > Agent Skills”
Teaches agents tools and knowledge
“The reason SKILLs work so well is because there's 50 years of accumulated knowledge of how to run rudimentary Unix tools.”
Comment from 7 Mar 2026 in “Filesystems Are Having a Moment” “Skills are better than MCP because they basically encode the API docs/context in an LLM friendly manner.”
Comment from 10 Apr 2026 in “I Still Prefer MCP over Skills” “With these Skills in place, the agent is able to do things it would really struggle with otherwise”
Comment from 16 Feb 2026 in “Study: Self-generated Agent Skills are useless” - Comment from 18 Feb 2026 in “AI Doesn't Reduce Work–It Intensifies It”
- Comment from 10 Apr 2026 in “I Still Prefer MCP over Skills”
- Comment from 10 Apr 2026 in “I Still Prefer MCP over Skills”
Lighter alternative to MCP
“they're certainly superior to MCP in ways, being much easier to implement and reducing context usage by being discoverable”
Comment from 16 Jan 2026 in “First impressions of Claude Cowork, Anthropic's general agent” “You've effectively flattened that MCP server into some Markdown and Bash, only the thing you have now is more flexible”
Comment from 1 Jan 2026 in “2025: The Year in LLMs” “cli tool+skill can perfectly replace it with less token overhead and better matching due to skill's front matter”
Comment from 10 Apr 2026 in “I Still Prefer MCP over Skills” - Comment from 10 Apr 2026 in “I Still Prefer MCP over Skills”
- Comment from 10 Apr 2026 in “I Still Prefer MCP over Skills”
Simple, low barrier to write
“Skills seem to me like the simplest possible design for a mechanism for adding extra capabilities to an existing coding agent.”
Comment from 13 Dec 2025 in “OpenAI are quietly adopting skills, now available in ChatGPT and Codex CLI” “they're certainly superior to MCP in ways, being much easier to implement and reducing context usage by being discoverable”
Comment from 16 Jan 2026 in “First impressions of Claude Cowork, Anthropic's general agent” “SKILL.md or AGENT.md is genuinely easier to use, with a low barrier to entry for building custom workflows”
Comment from 17 Aug 2026 in “Agent skills should be compiled, not just read” - Comment from 26 Feb 2026 in “I made MCP cheaper in one command”
What people warn about
Each mark is one comment
Agents often skip or ignore them
“I experimented with skills, but they were skipped too often for the tool to work as reliably as it now does”
Comment from 14 May 2026 in “A Claude Code and Codex Skill for Deliberate Skill Development” “I still get a lot of results where they are ignored even after spending time trying to tighten them up.”
Comment from 7 May 2026 in “Show HN: Agent-skills-eval – Test whether Agent Skills improve outputs” “Despite my previous efforts with skills, I've found agents will still do things like call help on CLIs”
Comment from 11 Apr 2026 in “I Still Prefer MCP over Skills” - Comment from 3 Feb 2026 in “Agent Skills”
Overhyped or unnecessary standardization
“Is any of this standardization really needed? Who does it benefit, except the people who enjoy writing specs and establishing standards like this?”
Comment from 3 Feb 2026 in “Agent Skills” “I do see other comments speculating these skills work more efficiently but I'm not sure I have seen any evidence for that”
Comment from 3 Feb 2026 in “Agent Skills” “The real issue is that prompts are not tightly coupled with capabilities. If we admit that, then skills are over hyped.”
Comment from 7 May 2026 in “Show HN: Agent-skills-eval – Test whether Agent Skills improve outputs” - Comment from 3 Feb 2026 in “Agent Skills”
- Comment from 3 Feb 2026 in “Agent Skills”
Security risks in shared skills
“I found a bunch of potential vulnerabilities in the example Skills .py files provided by Anthropic.”
Comment from 15 Jan 2026 in “Claude Cowork Exfiltrates Files” “most of the more than 100,000 skills on GitHub don't have any secure verification processes”
Comment from 6 Feb 2026 in “Are OpenClaw and AgentSkills Safe?” Can still add token overhead
“It feels a bit like the most likely outcomes are increased token burn, review surface, and time per task”
Comment from 4 Aug 2026 in “Agent skills that bring team coding standards to Claude Code and Codex” “You've just reversed the context benefits because the content of the skill...goes into context.”
Comment from 15 Mar 2026 in “MCP Is Dead; Long Live MCP”
What people said
40 of the 165 comments that mention it, newest first. Each links to the original comment.
“SKILL.md or AGENT.md is genuinely easier to use, with a low barrier to entry for building custom workflows”
“It feels a bit like the most likely outcomes are increased token burn, review surface, and time per task”
“Letting an instruction following llm deep research and iterate has given fantastic results before.”
“I tried it on my macOS apps and I noticed some improvements codewise and updated some deprecations I didn’t know existed in Swift.”
“I experimented with skills, but they were skipped too often for the tool to work as reliably as it now does”
“I still get a lot of results where they are ignored even after spending time trying to tighten them up.”
“The real issue is that prompts are not tightly coupled with capabilities. If we admit that, then skills are over hyped.”
“everything i would have done over hours on a bugged web dashboard, i saw opencode just deploy the structure in one go with api calls.”
“implementing skills to manually call and use while working side by side with an AI is definitely nice”
“Despite my previous efforts with skills, I've found agents will still do things like call help on CLIs”
“Skills are better than MCP because they basically encode the API docs/context in an LLM friendly manner.”
“they have progressive disclosure so you don't bloat your context with an inefficietly designed MCP”
“cli tool+skill can perfectly replace it with less token overhead and better matching due to skill's front matter”
“Skills are great for pure knowledge and teaching an LLM how to use an existing tool”
“Skills are good for instilling non-repeatable, yet intuitive or institutional knowledge.”
“OCI packaged, verifiable skills for Flux that should progressively discovery instead of loading everything into context”
“skills use progressive disclosure. The AI agent does not load up the entire context, if the skill is not being used.”
“You've just reversed the context benefits because the content of the skill...goes into context.”
“The reason SKILLs work so well is because there's 50 years of accumulated knowledge of how to run rudimentary Unix tools.”
“a markdown doc that tells the agent what CLI tools are available and when to use them”
“Existing paradigms like Skills already mitigate context bloat and selection overhead pretty well”
“It's a great idea: really neat take on programmability, and can be reloaded while the agent is running”
“Everyone else is using skills to provide updating knowledge and cli tools for extra functionality.”
“With these Skills in place, the agent is able to do things it would really struggle with otherwise”
“most of the more than 100,000 skills on GitHub don't have any secure verification processes”
“I do see other comments speculating these skills work more efficiently but I'm not sure I have seen any evidence for that”
“it smells like a hack, just like "think extra hard and I'll tip you $200" was a few years ago”
“Is any of this standardization really needed? Who does it benefit, except the people who enjoy writing specs and establishing standards like this?”
“this feels like a grift or more charitably trying to build a presence/market around nothing”
“Sometimes they reach for skills, sometimes they don’t and just try to do the thing on their own.”
“Experimenting with skills over the last few months has completely changed the way I think about using LLMs.”
“the key advantage of the SKILLs is that they get loaded to the end of the context when needed”
“As someone who has found skills useful, seeing skills like this raises the same question about (a subset of) skills as did MCP”
“they're certainly superior to MCP in ways, being much easier to implement and reducing context usage by being discoverable”
“I found a bunch of potential vulnerabilities in the example Skills .py files provided by Anthropic.”
“You've effectively flattened that MCP server into some Markdown and Bash, only the thing you have now is more flexible”
“We built a universal installer with the most popular claude skills that you can now install into any agent directly”
“I think that they often do solve the problem, just maybe they have some other side effects/trade offs.”
“Skills also have a nicer way of working with the context, by default (and in the main web uis), with their overview-driven lazy loading.”
“Skills seem to me like the simplest possible design for a mechanism for adding extra capabilities to an existing coding agent.”
Counts come from 1,795,640 Hacker News comments, November 2025 to November 2026. How we count. Report a mistake.