How do I install the Notes skill?

Run npx skillmds@latest add dvcrn/notes in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Notes safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Notes?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Notes free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Notes by dvcrn — Agent Skill

Name: Notes
Rating: 4.2 (5 reviews)
Author: dvcrn

File contents

Notes Skill

Personal notes manager. Notes live in /home/node/.openclaw/workspace/notes/ as markdown files with optional YAML frontmatter.

On the host (VPS) this maps to /root/.openclaw/workspace/notes/ — data persists across container restarts.

Setup

On first use, create the notes directory if it doesn't exist:

mkdir -p /home/node/.openclaw/workspace/notes/ideas
mkdir -p /home/node/.openclaw/workspace/notes/projects
mkdir -p /home/node/.openclaw/workspace/notes/daily
mkdir -p /home/node/.openclaw/workspace/notes/misc

Note format

---
tags: [idea, article]
created: 2026-03-06
---

# Title

Content here.

Frontmatter is optional. If absent, treat the file as plain markdown.

Paths

All paths below use the variable NOTES for brevity:

NOTES=/home/node/.openclaw/workspace/notes

Commands

List notes

find $NOTES -name '*.md' -type f | sed "s|$NOTES/||" | sort

Search by content

grep -rn --include='*.md' -i 'SEARCH_TERM' $NOTES/

Search by tag

grep -rl --include='*.md' 'tags:.*TAGNAME' $NOTES/

Read a note

cat $NOTES/PATH_TO_NOTE.md

Create a new note

Generate a slug from the title (lowercase, hyphens, no special chars).
Add YAML frontmatter with tags and created (today's date).
Write to the appropriate subdirectory.

cat > $NOTES/SUBDIR/SLUG.md << 'EOF'
---
tags: [tag1, tag2]
created: YYYY-MM-DD
---

# Title

Content
EOF

Append to an existing note

echo -e "\n## New section\n\nContent to add" >> $NOTES/PATH_TO_NOTE.md

Daily quick note

For quick thoughts without a full note, append to today's daily file:

mkdir -p $NOTES/daily
FILE=$NOTES/daily/$(date +%Y-%m-%d).md
[ -f "$FILE" ] || echo "# $(date +%Y-%m-%d)" > "$FILE"
echo "- $(date +%H:%M) — Quick thought here" >> "$FILE"

Behavior guidelines

When creating notes, confirm the title and tags with the user unless the request is unambiguous.
When searching, show matching filenames and a brief context snippet.
Keep file names short and descriptive: gpu-price-tracking.md, not note-about-tracking-gpu-prices-over-time.md.
Never delete notes without explicit confirmation.
When listing, show relative paths from the notes root for readability.

---name: notesdescription: Manage personal markdown notes — search, read, create, and append to notes. Use when the user asks to jot down an idea, find a note, list notes, or add something to an existing note.---# Notes SkillPersonal notes manager. Notes live in `/home/node/.openclaw/workspace/notes/` as markdown files with optional YAML frontmatter.**On the host (VPS)** this maps to `/root/.openclaw/workspace/notes/` — data persists across container restarts.## SetupOn first use, create the notes directory if it doesn't exist:```bashmkdir -p /home/node/.openclaw/workspace/notes/ideasmkdir -p /home/node/.openclaw/workspace/notes/projectsmkdir -p /home/node/.openclaw/workspace/notes/dailymkdir -p /home/node/.openclaw/workspace/notes/misc```## Note format```markdown---tags: [idea, article]created: 2026-03-06---# TitleContent here.```Frontmatter is optional. If absent, treat the file as plain markdown.## PathsAll paths below use the variable `NOTES` for brevity:```bashNOTES=/home/node/.openclaw/workspace/notes```## Commands### List notes```bashfind $NOTES -name '*.md' -type f | sed "s|$NOTES/||" | sort```### Search by content```bashgrep -rn --include='*.md' -i 'SEARCH_TERM' $NOTES/```### Search by tag```bashgrep -rl --include='*.md' 'tags:.*TAGNAME' $NOTES/```### Read a note```bashcat $NOTES/PATH_TO_NOTE.md```### Create a new note1. Generate a slug from the title (lowercase, hyphens, no special chars).2. Add YAML frontmatter with `tags` and `created` (today's date).3. Write to the appropriate subdirectory.```bashcat > $NOTES/SUBDIR/SLUG.md << 'EOF'---tags: [tag1, tag2]created: YYYY-MM-DD---# TitleContentEOF```### Append to an existing note```bashecho -e "\n## New section\n\nContent to add" >> $NOTES/PATH_TO_NOTE.md```### Daily quick noteFor quick thoughts without a full note, append to today's daily file:```bashmkdir -p $NOTES/dailyFILE=$NOTES/daily/$(date +%Y-%m-%d).md[ -f "$FILE" ] || echo "# $(date +%Y-%m-%d)" > "$FILE"echo "- $(date +%H:%M) — Quick thought here" >> "$FILE"```## Behavior guidelines- When creating notes, confirm the title and tags with the user unless the request is unambiguous.- When searching, show matching filenames and a brief context snippet.- Keep file names short and descriptive: `gpu-price-tracking.md`, not `note-about-tracking-gpu-prices-over-time.md`.- Never delete notes without explicit confirmation.- When listing, show relative paths from the notes root for readability.

Frequently asked questions

Notes