Comment by dimitri-vs

Yeah I think "Skills" are just a more codified folder based approach to this TOC system. The main reason I haven't migrated yet is that the TOC approach lends itself better to the more generic AGENTS.md style - allowing me to swap over to alternative LLMs (such as Gemini) relatively easily.

Indeed, the article links to the skill documentation which says:

Skills are modular capabilities that extend Claude’s functionality through organized folders containing instructions, scripts, and resources.

And

Extend Claude’s capabilities for your specific workflows

E.g. building your project is definitely a workflow.

It als makes sense to put as much as you can into a skill as this an optimized mechanism for claude code to retrieve relevant information based on the skill’s frontmatter.