On Thu, Oct 15, 2026 at 3:42 PM Sasha Levin <[email protected]> wrote: > > Sorry, what I meant to say is that the spec seems to require markdown as it's > preferred format. We can experiment with other options, but then the risk is > that we'll break some tools.
Ah, got it, thanks! Yeah, at the very least the `SKILL.md` main file should most likely be all Markdown inside (and of course the filename). Now, if we go with `agents/` instead of `Documentation/`, then I would personally prefer Markdown for the other files in the same folder like the `guide.rst`, but that is just my bias, and it has a small disadvantage: if we happen to move things between `Doc/` and `agents/`, then it is a bit painful to reformat. In fact, if it is all Markdown, perhaps we don't need that file to be separate? Actually, is it a separate file in the current patch because of the markup language difference? Cheers, Miguel
