How I built the skills system in my AI assistant: markdown files, strict validation, zero code

Description and use

<p>Ankita, my open-source desktop AI assistant, has a growing number of repeatable workflows: reviewing commits, drafting release notes, doing structured web research, reproducing bugs. For a long time each of those was just a paragraph buried in my notes, copy-pasted whenever I needed it.</p> <p>So I built a skills system. A skill is not code. It's a folder with a markdown file. That's the whole idea, and it's held up better than anything clever I considered.</p> <h2> What a skill actually is </h2> <p>Every skill lives in a <code>skills/</code> directory at the repo root as a single folder co

Problem

<p>Ankita, my open-source desktop AI assistant, has a growing number of repeatable workflows: reviewing commits, drafting release notes, doing structured web research, reproducing bugs. For a long time each of those was just a paragraph buried in my notes, copy-pasted whenever I needed it.</p> <p>So I built a skills system. A skill is not code. It's a folder with a markdown file. That's the whole idea, and it's held up better than anything clever I considered.</p> <h2> What a skill actually is </h2> <p>Every skill lives in a <code>skills/</code> directory at the repo root as a single folder co

Outcome

<p>Ankita, my open-source desktop AI assistant, has a growing number of repeatable workflows: reviewing commits, drafting release notes, doing structured web research, reproducing bugs. For a long time each of those was just a paragraph buried in my notes, copy-pasted whenever I needed it.</p> <p>So I built a skills system. A skill is not code. It's a folder with a markdown file. That's the whole idea, and it's held up better than anything clever I considered.</p> <h2> What a skill actually is </h2> <p>Every skill lives in a <code>skills/</code> directory at the repo root as a single folder co

Evidence

How I built the skills system in my AI assistant: markdown files, strict validation, zero code

Source