This. Skills are exactly that, well structured markdown documents. Its the same with AI agents. You define the structure, what it can and can't do, setup rules and guidelines and then the AI sticks to that exact model. I sell skills on marketplace because sometimes, crafting the perfect prompt can be hard - you want something specific and very particular and don't know how to ask AI to do that. This is where skills come in. You can create your own skills or get them from someone else. They're great.
To add to what the other person said, they're also loaded differently than arbitrary docs.
They're presented as a list of titles and descriptions to the LLM and it can pick which ones seem relevant and load them.
Markdown docs the LLM needs to make a tool call to read the files and potentially multiple tool calls to discover data if there's a hierarchy. Additionally, it now has to decide if it should read the entire file or cherry pick parts of it.
Skills organize that in an atomic and composable way.
I think ChatGPT and Claude skills will also package arbitrary artifacts like scripts as well. Not sure if that's standard or not
> Why do frameworks like Claude Code or Codex have the concept of “skills” instead of just using well-organized Markdown docs?
"Well-organized markdown docs" are exactly what skills are.
More specifically, they are well-organized markdown docs that explain how to do some particular thing.
This. Skills are exactly that, well structured markdown documents. Its the same with AI agents. You define the structure, what it can and can't do, setup rules and guidelines and then the AI sticks to that exact model. I sell skills on marketplace because sometimes, crafting the perfect prompt can be hard - you want something specific and very particular and don't know how to ask AI to do that. This is where skills come in. You can create your own skills or get them from someone else. They're great.
To add to what the other person said, they're also loaded differently than arbitrary docs.
They're presented as a list of titles and descriptions to the LLM and it can pick which ones seem relevant and load them.
Markdown docs the LLM needs to make a tool call to read the files and potentially multiple tool calls to discover data if there's a hierarchy. Additionally, it now has to decide if it should read the entire file or cherry pick parts of it.
Skills organize that in an atomic and composable way.
I think ChatGPT and Claude skills will also package arbitrary artifacts like scripts as well. Not sure if that's standard or not