atomic-note-to-moc
Skill15 starsChanged 16 days agoMITView on GitHub
Integrate an atomic note with the vault's MOC system and related notes. Use after creating or saving an atomic note that needs folder or tag classification, anchor consideration, or cross-links.
In this repository53 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- analyze-repoSkill
- architectSkill
- codebase-designSkill
- code-reviewSkill
- commitSkill
- create-prSkill
- create-verification-skillSkill
- debugSkill
- frontendSkill
- implementSkill
- mswSkill
- playwrightSkill
- react-hook-form-auditSkill
- react-hook-formSkill
- reactSkill
- refactorSkill
- researchSkill
- resolving-merge-conflictsSkill
- specSkill
- tailwindSkill
- tanstack-querySkill
- testSkill
- typescriptSkill
- zodSkill
- auditSkill
- neovimSkill
- shell-envSkill
- teachSkill
- tilSkill
- close-daySkill
- create-noteSkill
- goalsSkill
- import-goodreadsSkill
- import-meetingsSkill
- ingestSkill
- memory-recallSkill
- process-inboxSkill
- projectSkill
- save-sessionSkill
- todays-focusSkill
- vault-auditSkill
- vaultSkill
- weekly-reviewSkill
- careerSkill
- check-communicationSkill
- deslopifySkill
- standupSkill
- blogSkill
- broSkill
- docsSkill
- talkSkill
- tweet-todaySkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 6 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 15
Read the vault's AGENTS.md and ../vault/SKILL.md.
- Distinctive: line 19
Treat agent-owned notes as writable through the vault safe-write flow.
- Distinctive: line 27
Check whether the note already appears in the relevant Base.
- Distinctive: line 51
After approved edits, reread every changed file and report exactly what changed.
- Distinctive: line 64
Before proposing a cross-link, ask:
- Distinctive: line 70
When a link would change the subject, present it as a related-note suggestion instead of an edit.
- Distinctive: line 74
After an approved change, query or render the affected Base and confirm that the target note appears.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Atomic Note to MOC
Integrate one existing atomic note into the vault's Base-backed MOCs without turning every note into a curated anchor.
1. Establish the contract
Read the vault's AGENTS.md and ../vault/SKILL.md. Resolve the target note, its owner, and its current
folder and metadata. Resolve the MOC and Base directories from the schema. Read candidate MOCs and
their actual embedded Base definitions, including any compatibility lists, to learn their filters.
Treat agent-owned notes as writable through the vault safe-write flow. For human-owned notes, present recommendations without modifying them.
Completion: the target note, its write boundary, candidate MOCs, and the exact Base filters that could include it are known.
2. Classify the note
Check whether the note already appears in the relevant Base. If it does, leave its classification alone. If it does not, distinguish a genuinely missing topic tag from a stale folder filter or compatibility list. Keep reusable knowledge in its schema-defined location rather than moving it to satisfy an old query. Read the live tag guide before proposing tag changes.
Preserve ownership and unrelated metadata. Propose an index entry when the schema requires one; register it only within an approved write set.
A MOC's hard-linked anchors are curated entry points. Propose a direct MOC link only when the note is important enough to serve as an anchor; ordinary notes belong in the Base only. If no current MOC or Base fits, ask whether to extend an existing Base, create a new MOC, or leave the note unclassified.
Preview every proposed note, index, Base, or MOC mutation and obtain approval through the vault safe-write flow before applying it.
Completion: the approved classification makes the note discoverable through the relevant Base, any required index entry exists, and no MOC anchor was added without explicit approval.
3. Propose connections
Explore notes surfaced by the relevant MOCs and Bases. Suggest only connections that clarify or qualify the target note's single insight. Show the exact proposed links and obtain approval before modifying the target or any related note.
After approved edits, reread every changed file and report exactly what changed.
Completion: meaningful cross-links were proposed, declined or approved explicitly, and every approved change was verified without broadening either note's subject.
Preserve atomicity
| Do | Avoid |
| Add a brief link that adds nuance | Add an explanation that expands the note's scope |
| Suggest connections before editing | Turn a note into a discussion hub |
| Keep the title and first paragraph sufficient | Make another note required to understand the insight |
Before proposing a cross-link, ask:
- Does the title still capture the complete insight?
- Can the first paragraph stand on its own?
- Would this link change what the note is fundamentally about?
When a link would change the subject, present it as a related-note suggestion instead of an edit.
Verify discovery
After an approved change, query or render the affected Base and confirm that the target note appears. A valid filter file alone does not prove membership. Preserve the MOC's existing Base embed and unrelated anchors. If the query cannot be verified, report that limitation instead of claiming the note is integrated.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

