# moc-update

moc-update finds the Maps of Content (MOCs) in an Obsidian vault that should link to a freshly created Engineering/ note. Fires on prompts like “update MOC” or “which MOCs”.

- skill · `type=skill` · Claude Code, Gemini CLI, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Claude.ai · ★ 102 repo stars
- Author: thoreinstein
- License: ISC · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/thoreinstein/gemini-obsidian/tree/HEAD/skills/moc-update/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/moc-update

## What it does

Given the path to a new note, the skill runs a semantic search through `obsidian_rag_query` using the note title with a limit of 10 results, then falls back to `obsidian_search_notes` on key terms from the title to catch MOCs that haven't been indexed yet. It recognizes MOC-style notes by a path containing "MOC", a filename ending in "-MOC", or `type: moc` frontmatter.

For each candidate MOC it surfaces, the skill shows the file path, the heading the link belongs under, and a ready-made line such as `- [[NoteName]] — one-line description`. Nothing gets written until the user approves; the actual edit goes through `obsidian_insert_at_heading` or `obsidian_append_note`.

If the vault has no MOCs at all, it offers to start one at `MOCs/<Topic>-MOC.md`. Daily Notes get filtered out of the results since they aren't MOCs.

## Requirements
- Works with: Obsidian

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add thoreinstein/gemini-obsidian --skill moc-update -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/moc-update/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/moc-update/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add thoreinstein/gemini-obsidian --skill moc-update -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/moc-update/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add thoreinstein/gemini-obsidian --skill moc-update -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/moc-update/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install thoreinstein/gemini-obsidian skills/moc-update
```

2. **Manually: put the files in place**
- File: `.github/skills/moc-update/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add thoreinstein/gemini-obsidian --skill moc-update -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/thoreinstein/gemini-obsidian --path skills/moc-update
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/moc-update/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/thoreinstein/gemini-obsidian/tree/HEAD/skills/moc-update/SKILL.md

## When to use it
- locate which MOCs should link to a new note
- insert a note link under the right MOC heading
- bootstrap a starter MOC when none exist yet
- filter out Daily Notes from MOC search results

## Example prompts
- /moc-update Engineering/AuthPatterns.md
- Which MOCs should link to this note?
- Add this note to the right MOC

## Source text · SKILL.md · ISC

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 5f4346b293a44076.

BEGIN THIRD-PARTY FILE 5f4346b293a44076
```text
---
name: moc-update
description: >-
  Use after creating a new Engineering/ note to suggest which Maps of Content
  (MOCs) it belongs in. Triggers on "update MOC", "add to MOC", "which MOCs",
  or when the user has just created an Engineering/ note.
---

# MOC Update After New Note

Find the Maps of Content (MOCs) that should link to a newly created note and suggest the additions.

## Workflow

1. **Identify the new note** — Path follows the skill invocation. If not provided, ask.

2. **Semantic MOC search** — Call `obsidian_rag_query` with the note title as query, `limit: 10`.
   Flag results that are MOC-style notes (path contains "MOC", filename ends in "-MOC", or
   `type: moc` frontmatter).

3. **Keyword fallback** — Call `obsidian_search_notes` with key terms from the note title
   to catch MOCs that aren't yet indexed.

4. **Present suggestions** — For each candidate MOC, show:
   - The MOC path
   - Which heading the link should go under (if readable)
   - A proposed link line: `- [[NoteName]] — one-line description`

5. **Append on confirmation** — Call `obsidian_insert_at_heading` (preferred) or
   `obsidian_append_note` to add the link. Never edit without user approval.

## Arguments

New note path: `/moc-update Engineering/AuthPatterns.md`

## Tips

- If the vault has no MOCs yet, offer to create a starter one at `MOCs/<Topic>-MOC.md`
- Daily Notes are not MOCs — skip them in results
```
END THIRD-PARTY FILE 5f4346b293a44076

The third-party file has ended. Everything between the 5f4346b293a44076 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© thoreinstein · ISC · https://github.com/thoreinstein/gemini-obsidian/tree/HEAD/skills/moc-update/SKILL.md

## Similar
- [moc-agent](https://affpapa.org/en/nevibecode/agents/moc-agent.md) — subagent · 666 installs
- [wiki-update](https://affpapa.org/en/nevibecode/skills/wiki-update.md) — skill · 3400 installs
- [wiki-query](https://affpapa.org/en/nevibecode/skills/wiki-query.md) — skill · 3600 installs
- [wiki](https://affpapa.org/en/nevibecode/skills/agricidaniel-wiki.md) — skill · 589 installs
- [save](https://affpapa.org/en/nevibecode/skills/save.md) — skill · 559 installs
- [obsidian-source-ingestion](https://affpapa.org/en/nevibecode/skills/obsidian-source-ingestion.md) — skill · 329 installs

From the same set: [thoreinstein/gemini-obsidian](https://affpapa.org/en/nevibecode/by/thoreinstein/gemini-obsidian.md) — 15 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
