How do I install the Memo skill?

Run npx skillmds@latest add shawyeok/memo 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.

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Memo?

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.

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

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

Memo by shawyeok — Agent Skill

Name: Memo
Author: Shawyeok

File contents

Write Memo

Saves a memo to ~/memo in the correct subdirectory with the YY-MM-DD-slug.md filename format defined in ~/memo/STRUCTURE.md.

Directory Decision (from STRUCTURE.md)

Content type	Directory
Production incident post-mortem or investigation	`incidents/`
OS / infra how-to, server config, middleware, network, storage	`infra/`
JVM internals, Java performance, Java tooling	`java/`
Cross-cutting engineering standard, code review, team process	`engineering/`
Scoped to one product or codebase	`projects/<project-name>/`
Saved external article or reference verbatim	`Clippings/`
AI agent design doc	`agent-proposals/`
Personal / non-work	`personal/`

Filename Format

YY-MM-DD-descriptive-slug.md

Date: today's date in YY-MM-DD format (e.g. 26-05-23)
Slug: lowercase kebab-case, no redundant date words
Example: 26-05-23-motionpro-vpn-container.md

Steps

1. Determine inputs

If the user hasn't specified the memo content, ask. If the user hasn't specified a title/slug or directory, infer from the content using the decision table above.

Input	How to get it
Content	User provides or you draft it
Directory	Apply decision table to the content
Slug	Derive from the topic (kebab-case, descriptive)
Date	Today's date (`date +%y-%m-%d`)

2. Construct the target path

DATE=$(date +%y-%m-%d)
DIR=~/memo/<chosen-dir>          # e.g. ~/memo/infra
SLUG="<descriptive-slug>"        # e.g. motionpro-vpn-container
FILE="$DIR/$DATE-$SLUG.md"

For projects/, create the subdirectory if it doesn't exist:

mkdir -p ~/memo/projects/<project-name>

3. Write the file

Use the Write tool to create $FILE with the memo content.

4. Add an entry to RECENT_UPDATE.md

Append a checkbox line to ~/memo/RECENT_UPDATE.md that links to the new file using an Obsidian wiki-link:

- [ ] YY-MM-DD [[<dir>/<YY-MM-DD-slug>|<Human-readable title>]]

Path inside the link: relative to the vault root, without the .md extension (e.g. infra/26-06-25-motionpro-vpn-container)
Display title: the H1 heading from the memo, or a clean title-case version of the slug if there is no H1
For projects/ memos the path is projects/<project-name>/<YY-MM-DD-slug>

Example:

- [ ] 26-06-25 [[infra/26-06-25-motionpro-vpn-container|MotionPro VPN Container Setup]]

Use the Edit tool to append the line (do not rewrite the whole file).

Confirm with the user: Saved to ~/memo/<dir>/<filename>.md

Gotchas

Check if the file already exists before writing — if it does, confirm with the user whether to overwrite or use a different slug.
Clippings/ entries should preserve the source URL in a footer line: > Source: <url>
projects/ subdirectory name should match the product/codebase name exactly (e.g. projects/pulsar-a/, projects/goven/).
Do not add a date prefix to the slug itself — the prefix is always the leading YY-MM-DD- portion only.

---name: memodescription: Save a memo to ~/memo with the correct directory and filename following the vault's STRUCTURE.md rules. Use when the user says "write a memo", "save this to memo", or "add a note to ~/memo".---# Write MemoSaves a memo to `~/memo` in the correct subdirectory with the `YY-MM-DD-slug.md` filename format defined in `~/memo/STRUCTURE.md`.## Directory Decision (from STRUCTURE.md)| Content type | Directory ||---|---|| Production incident post-mortem or investigation | `incidents/` || OS / infra how-to, server config, middleware, network, storage | `infra/` || JVM internals, Java performance, Java tooling | `java/` || Cross-cutting engineering standard, code review, team process | `engineering/` || Scoped to one product or codebase | `projects/<project-name>/` || Saved external article or reference verbatim | `Clippings/` || AI agent design doc | `agent-proposals/` || Personal / non-work | `personal/` |## Filename Format```YY-MM-DD-descriptive-slug.md```- Date: today's date in `YY-MM-DD` format (e.g. `26-05-23`)- Slug: lowercase kebab-case, no redundant date words- Example: `26-05-23-motionpro-vpn-container.md`## Steps### 1. Determine inputsIf the user hasn't specified the memo content, ask. If the user hasn't specified a title/slug or directory, infer from the content using the decision table above.| Input | How to get it ||---|---|| Content | User provides or you draft it || Directory | Apply decision table to the content || Slug | Derive from the topic (kebab-case, descriptive) || Date | Today's date (`date +%y-%m-%d`) |### 2. Construct the target path```bashDATE=$(date +%y-%m-%d)DIR=~/memo/<chosen-dir> # e.g. ~/memo/infraSLUG="<descriptive-slug>" # e.g. motionpro-vpn-containerFILE="$DIR/$DATE-$SLUG.md"```For `projects/`, create the subdirectory if it doesn't exist:```bashmkdir -p ~/memo/projects/<project-name>```### 3. Write the fileUse the Write tool to create `$FILE` with the memo content.### 4. Add an entry to RECENT_UPDATE.mdAppend a checkbox line to `~/memo/RECENT_UPDATE.md` that links to the new file using an Obsidian wiki-link:```- [ ] YY-MM-DD [[<dir>/<YY-MM-DD-slug>|<Human-readable title>]]```- **Path inside the link**: relative to the vault root, without the `.md` extension (e.g. `infra/26-06-25-motionpro-vpn-container`)- **Display title**: the H1 heading from the memo, or a clean title-case version of the slug if there is no H1- For `projects/` memos the path is `projects/<project-name>/<YY-MM-DD-slug>`Example:```- [ ] 26-06-25 [[infra/26-06-25-motionpro-vpn-container|MotionPro VPN Container Setup]]```Use the Edit tool to append the line (do not rewrite the whole file).Confirm with the user: `Saved to ~/memo/<dir>/<filename>.md`## Gotchas- Check if the file already exists before writing — if it does, confirm with the user whether to overwrite or use a different slug.- `Clippings/` entries should preserve the source URL in a footer line: `> Source: <url>`- `projects/` subdirectory name should match the product/codebase name exactly (e.g. `projects/pulsar-a/`, `projects/goven/`).- Do not add a date prefix to the slug itself — the prefix is always the leading `YY-MM-DD-` portion only.

Frequently asked questions

Memo