brsbl/moss-skills

README preview

# Skills for working with [mossnotes.app](https://www.mossnotes.app/)

<img width="1392" height="912" alt="Screenshot 2026-05-20 at 3 30 23 PM" src="https://github.com/user-attachments/assets/da7cf452-e37e-41d9-8bff-e4173723dd41" />

This repository provides standalone skills for creating and editing [Moss](https://www.mossnotes.app/) notes with coding agents. The skills teach Moss writing guidelines, note structure, Markdown syntax, formulas and variables, comments, links, frontmatter, canvas, and embedded HTML.

## What this repo is for

- Install Moss note-authoring skills into agents such as Codex, Claude Code, and other tools that support skills.
- Help agents write valid Moss notes under `~/Moss/Notes/**` without breaking note directories, sidecars, comments, links, or embedded `moss-html` / `moss-canvas` blocks.
- Fork or customize the agent instructions while preserving Moss note syntax that the app expects.

### Important note ⚠️

If you customize these skills, do not change the Moss note syntax itself. The Moss app expects specific Markdown and sidecar shapes. You **can** customize how agents apply the syntax, such as whether they leave comments instead of editing directly or how they style embedded HTML.

Forking this repository only affects agents that install skills from it. It does not change the default behavior of the in-app Moss agent.

## Included skills

View full repository on GitHub →