agentleFS
kriscardkriscard/Skills/skills/obsidian/atomic-note-to-moc/SKILL.md

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.

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
  1. Very specific:

    Read the vault's AGENTS.md and ../vault/SKILL.md.

    line 15
  2. Distinctive:

    Treat agent-owned notes as writable through the vault safe-write flow.

    line 19
  3. Distinctive:

    Check whether the note already appears in the relevant Base.

    line 27
  4. Distinctive:

    After approved edits, reread every changed file and report exactly what changed.

    line 51
  5. Distinctive:

    Before proposing a cross-link, ask:

    line 64
  6. Distinctive:

    When a link would change the subject, present it as a related-note suggestion instead of an edit.

    line 70
  7. Distinctive:

    After an approved change, query or render the affected Base and confirm that the target note appears.

    line 74

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

DoAvoid
Add a brief link that adds nuanceAdd an explanation that expands the note's scope
Suggest connections before editingTurn a note into a discussion hub
Keep the title and first paragraph sufficientMake 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.