moss-links - SKILL.md Agent Skill

name: moss-links description: Create or edit Moss links, including wiki note links, heading links, aliases, Markdown links, YouTube embeds, and media/link preservation rules.

Moss Links

Use this skill when adding, editing, or reviewing links in Moss notes: note links, heading links, display aliases, Markdown links, YouTube links, and media references.

Wiki Note Links

Wiki links connect notes and headings inside the Moss workspace.

[[Project Plan]]
[[#Local Heading]]
[[Project Plan#Scope]]
[[Project Plan|display text]]

Rules:

Use the exact note title for cross-note links.
Verify the target note exists before adding a cross-note link.
Use [[#Heading]] for a heading in the current note.
Use [[Note#Heading]] for a heading in another note.
Use [[Note|display text]] when the visible label should differ from the note title.
Do not escape brackets inside [[...]]; brackets in note titles are allowed, so write the exact title.

Markdown Links

Use standard Markdown links for web URLs, external references, and non-Moss destinations.

[Website](https://www.mossnotes.app/)
[Repository](https://github.com/brsbl/moss-skills)

Preserve existing URLs exactly unless the user asks to change them.
Prefer descriptive link text over raw URLs in prose.
Use wiki links for Moss note-to-note navigation; use Markdown links for external destinations.

YouTube Links and Video

Moss treats YouTube URLs as video-capable references when written as image/video markdown.

![Demo walkthrough](https://youtu.be/dQw4w9WgXcQ)

Use image/video markdown when the user wants an embedded playable video preview.
Use a normal Markdown link when the user only wants a text link to YouTube.
Remote non-YouTube video files are not video nodes; use local video assets for .mp4, .webm, or .mov.

Local Assets and Media Links

Use note-local assets for files stored with the note.

![Screenshot](assets/screenshot.png)
![Demo recording](assets/demo.mp4)

Prefer assets/... paths for note-local media.
Do not use file:// or absolute local paths in notes.
Preserve existing asset paths unless relocating the asset is part of the task.

Review Checklist

Link type matches destination: wiki for Moss notes, Markdown for external URLs, image/video markdown for media.
Cross-note wiki targets use exact note titles.
YouTube embeds use image/video markdown only when an embedded video is intended.
No accidental changes to existing URLs, aliases, heading fragments, or asset paths.