Hacker ApprovedDepartments

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%
Each figure is 2 people. RecommendsCriticizes

Recommended in 11 of 13 months

  1. November 2025: recommended
  2. December 2025: recommended
  3. January 2026: recommended
  4. February 2026: recommended
  5. March 2026: recommended
  6. April 2026: recommended
  7. May 2026: recommended
  8. June 2026: recommended
  9. July 2026: recommended
  10. August 2026: recommended
  11. September 2026: recommended
  12. October 2026: not recommended
  13. 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]”
  • 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”
  • 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”
  • 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”

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”
  • 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”
  • 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”

RecommendsComment from 17 Aug 2026 in “Agent skills should be compiled, not just read”

“It feels a bit like the most likely outcomes are increased token burn, review surface, and time per task”

CriticizesComment from 4 Aug 2026 in “Agent skills that bring team coding standards to Claude Code and Codex”

“Letting an instruction following llm deep research and iterate has given fantastic results before.”

RecommendsComment from 22 Jun 2026 in “You're probably using Agent Skills wrong”

“I tried it on my macOS apps and I noticed some improvements codewise and updated some deprecations I didn’t know existed in Swift.”

RecommendsComment from 14 Jun 2026 in “No, everyone is not using AI for everything”

“I experimented with skills, but they were skipped too often for the tool to work as reliably as it now does”

CriticizesComment 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.”

CriticizesComment from 7 May 2026 in “Show HN: Agent-skills-eval – Test whether Agent Skills improve outputs”

“The real issue is that prompts are not tightly coupled with capabilities. If we admit that, then skills are over hyped.”

CriticizesComment from 7 May 2026 in “Show HN: Agent-skills-eval – Test whether Agent Skills improve outputs”

“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.”

RecommendsComment from 7 May 2026 in “Agents can now create Cloudflare accounts, buy domains, and deploy”

“implementing skills to manually call and use while working side by side with an AI is definitely nice”

RecommendsComment from 5 May 2026 in “Agent Skills”

“Despite my previous efforts with skills, I've found agents will still do things like call help on CLIs”

CriticizesComment from 11 Apr 2026 in “I Still Prefer MCP over Skills”

“Skills are better than MCP because they basically encode the API docs/context in an LLM friendly manner.”

RecommendsComment from 10 Apr 2026 in “I Still Prefer MCP over Skills”

“they have progressive disclosure so you don't bloat your context with an inefficietly designed MCP”

RecommendsComment from 10 Apr 2026 in “I Still Prefer MCP over Skills”

“cli tool+skill can perfectly replace it with less token overhead and better matching due to skill's front matter”

RecommendsComment from 10 Apr 2026 in “I Still Prefer MCP over Skills”

“Skills are great for pure knowledge and teaching an LLM how to use an existing tool”

RecommendsComment from 10 Apr 2026 in “I Still Prefer MCP over Skills”

“Skills are good for instilling non-repeatable, yet intuitive or institutional knowledge.”

RecommendsComment from 10 Apr 2026 in “I Still Prefer MCP over Skills”

“OCI packaged, verifiable skills for Flux that should progressively discovery instead of loading everything into context”

RecommendsComment from 8 Apr 2026 in “Why GitOps still matters in a world of AI agents (FluxCon) [video]”

“skills use progressive disclosure. The AI agent does not load up the entire context, if the skill is not being used.”

RecommendsComment from 16 Mar 2026 in “Let your Coding Agent debug the browser session with Chrome DevTools MCP”

“You've just reversed the context benefits because the content of the skill...goes into context.”

CriticizesComment from 15 Mar 2026 in “MCP Is Dead; Long Live MCP”

“The reason SKILLs work so well is because there's 50 years of accumulated knowledge of how to run rudimentary Unix tools.”

RecommendsComment from 7 Mar 2026 in “Filesystems Are Having a Moment”

“a markdown doc that tells the agent what CLI tools are available and when to use them”

RecommendsComment from 26 Feb 2026 in “I made MCP cheaper in one command”

“Existing paradigms like Skills already mitigate context bloat and selection overhead pretty well”

RecommendsComment from 26 Feb 2026 in “I made MCP cheaper in one command”

“It's a great idea: really neat take on programmability, and can be reloaded while the agent is running”

RecommendsComment from 24 Feb 2026 in “HuggingFace Agent Skills”

“Everyone else is using skills to provide updating knowledge and cli tools for extra functionality.”

RecommendsComment from 18 Feb 2026 in “AI Doesn't Reduce Work–It Intensifies It”

“With these Skills in place, the agent is able to do things it would really struggle with otherwise”

RecommendsComment from 16 Feb 2026 in “Study: Self-generated Agent Skills are useless”

“most of the more than 100,000 skills on GitHub don't have any secure verification processes”

CriticizesComment from 6 Feb 2026 in “Are OpenClaw and AgentSkills Safe?”

“I do see other comments speculating these skills work more efficiently but I'm not sure I have seen any evidence for that”

CriticizesComment from 3 Feb 2026 in “Agent Skills”

“it smells like a hack, just like "think extra hard and I'll tip you $200" was a few years ago”

CriticizesComment from 3 Feb 2026 in “Agent Skills”

“Is any of this standardization really needed? Who does it benefit, except the people who enjoy writing specs and establishing standards like this?”

CriticizesComment from 3 Feb 2026 in “Agent Skills”

“this feels like a grift or more charitably trying to build a presence/market around nothing”

CriticizesComment from 3 Feb 2026 in “Agent Skills”

“Sometimes they reach for skills, sometimes they don’t and just try to do the thing on their own.”

MixedComment from 3 Feb 2026 in “Agent Skills”

“Experimenting with skills over the last few months has completely changed the way I think about using LLMs.”

RecommendsComment from 3 Feb 2026 in “Agent Skills”

“the key advantage of the SKILLs is that they get loaded to the end of the context when needed”

RecommendsComment from 29 Jan 2026 in “Compressed Agents.md > Agent Skills”

“As someone who has found skills useful, seeing skills like this raises the same question about (a subset of) skills as did MCP”

MixedComment from 20 Jan 2026 in “Show HN: Agent Skills Leaderboard”

“they're certainly superior to MCP in ways, being much easier to implement and reducing context usage by being discoverable”

RecommendsComment from 16 Jan 2026 in “First impressions of Claude Cowork, Anthropic's general agent”

“I found a bunch of potential vulnerabilities in the example Skills .py files provided by Anthropic.”

CriticizesComment from 15 Jan 2026 in “Claude Cowork Exfiltrates Files”

“You've effectively flattened that MCP server into some Markdown and Bash, only the thing you have now is more flexible”

RecommendsComment from 1 Jan 2026 in “2025: The Year in LLMs”

“We built a universal installer with the most popular claude skills that you can now install into any agent directly”

RecommendsComment from 19 Dec 2025 in “We built a universal installer for agent skills based on the new open standard”

“I think that they often do solve the problem, just maybe they have some other side effects/trade offs.”

MixedComment from 18 Dec 2025 in “Skills for organizations, partners, the ecosystem”

“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.”

RecommendsComment from 13 Dec 2025 in “OpenAI are quietly adopting skills, now available in ChatGPT and Codex CLI”

“Skills seem to me like the simplest possible design for a mechanism for adding extra capabilities to an existing coding agent.”

RecommendsComment from 13 Dec 2025 in “OpenAI are quietly adopting skills, now available in ChatGPT and Codex CLI”

Counts come from 1,795,640 Hacker News comments, November 2025 to November 2026. How we count. Report a mistake.