u/cromo_

▲ 24 r/orgmode+1 crossposts

ox-skills: manage AI agent skills in Org-mode

Just baked my new emacs package! This is how I manage my AI coding assistant skills, which is from a single SKILLS.org file, without touching a single line of YAML.

If you're used to ox-hugo or ox-zola, this should feel extremely natural (I actually took most of the ideas from rewriting the backend of ox-zola recently).

It's an Org export backend that writes {base-dir}/{name}/SKILL.md. Drop in your skill keywords, run C-c C-e s a (or SPC m e s a), and it batch-exports every subtree that has an EXPORT_SKILL_NAME property. Works with Claude Code, OpenCode, or any tool that reads SKILL.md files.

Another cool thing is you can write the skills as org-roam notes and export them into a specific directory hierarchy with ease. Section headings with EXPORT_SKILL_SUBDIR become path segments. You can scatter the skills across multiple Org files or put them in a single one: it's up to you. Whatever you choose, you can also create multiple directories by just creating nodes in the Org paragraph and you can easily add notes around your skills without contaminating the prompts.

Zero external deps (just ox-md from core).

Here's my actual skills repo as a simple live example:

https://github.com/gicrisf/skills

Explore it, fork it, have fun with it.

Would love feedback from you all!

github.com
u/cromo_ — 12 days ago