Agent skill

Moc Update

by thoreinstein in thoreinstein/gemini-obsidian

Use after creating a new Engineering/ note to suggest which Maps of Content (MOCs) it belongs in.

ISCAuto-check passed

Install Moc Update

skills CLI
$ npx skills add thoreinstein/gemini-obsidian --skill moc-update -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install thoreinstein/gemini-obsidian moc-update --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/thoreinstein/gemini-obsidian.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/moc-update .claude/skills/moc-update && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
moc-update
GitHub stars
102
Token cost
~355 tokens
SKILL.md length
164 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
ISC

At a glance

Use after creating a new Engineering/ note to suggest which Maps of Content (MOCs) it belongs in.

  • Works in 5 steps: Identify the new note — Path follows the… → Semantic MOC search — Call… → Keyword fallback — Call… → …
  • The user has just created an Engineering/ note
  • SKILL.md covers Workflow, Arguments and Tips
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Moc Update is an agent skill from thoreinstein/gemini-obsidian. 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.

Its SKILL.md is about 360 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Obsidian. The repository describes itself as: A Gemini CLI extension for interfacing with an Obsidian vault with local first RAG capabilities. The licence is ISC.

When your agent uses it

  • The user has just created an Engineering/ note

Example prompts

  • “update MOC”
  • “add to MOC”
  • “which MOCs”
  • “/moc-update”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  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.
  3. Keyword fallback — Call obsidian_search_notes with key terms from the note title
  4. Present suggestions — For each candidate MOC, show
  5. Append on confirmation — Call obsidian_insert_at_heading (preferred) or

What it can do on your machine

Read from SKILL.md and the folder at commit 9156cba. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Moc Update loads about 355 tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 164 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~55
When it runs · the whole SKILL.md, loaded when a task matches
~355

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from thoreinstein/gemini-obsidian at commit 9156cba, republished under its ISC licence (© thoreinstein). 164 words, ~355 tokens.

Download SKILL.mdSave it as .claude/skills/moc-update/SKILL.md (or your agent's skills folder).
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

© thoreinstein, ISC. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/moc-update of thoreinstein/gemini-obsidian.

Open the folder on GitHubat commit 9156cba

Compare with similar skills

Moc Update next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Moc Update compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Moc Update this skillthoreinstein/gemini-obsidian102—~355Automated safety check: PassISC
Obsidian BasesAtmosphere/atmosphere3.8k22 repos~3.2kAutomated safety check: PassApache-2.0
Knap Markdown Templateskepano/obsidian-skills49k2 repos~986Automated safety check: PassMIT
JSON Canvasheyitsnoah/claudesidian2.6k18 repos~3.5kAutomated safety check: PassMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
Bounded AutoresearchAgriciDaniel/claude-obsidian15k1 repos~1.6kAutomated safety check: PassMIT

Similar skills

  • Obsidian Bases

    Atmosphere/atmosphere

    Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries.

    3.8k GitHub starsUsed in 22 repos~3.2k tokens
    Backend & APIsAuto-check passed
  • Knap Markdown Templates

    kepano/obsidian-skills

    Renders Markdown notes from Knap templates and JSON data on the command line, including notes built from Defuddle web page output.

    49k GitHub starsUsed in 2 repos~986 tokens
    Documents & OfficeAuto-check passed
  • JSON Canvas

    heyitsnoah/claudesidian

    Create and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections.

    2.6k GitHub starsUsed in 18 repos~3.5k tokens
    DevelopmentAuto-check passed
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • Bounded Autoresearch

    AgriciDaniel/claude-obsidian

    Runs a bounded, source-grounded research loop that drafts a cited dossier and can propose a separately reviewed merge into an Obsidian vault.

    15k GitHub starsUsed in 1 repo~1.6k tokens
    Knowledge ManagementAuto-check passed
  • Obsidian CLI

    Atmosphere/atmosphere

    Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more.

    3.8k GitHub starsUsed in 13 repos~795 tokens
    Knowledge ManagementAuto-check passed

More from thoreinstein/gemini-obsidian

All 12 skills in this repo
  • Cross Linker

    thoreinstein/gemini-obsidian

    A skill your agent uses when the user wants to find and insert missing wikilinks across vault notes.

    102 GitHub stars~878 tokensUpdated 2 mo ago
    Auto-check passed
  • Vault Lint

    thoreinstein/gemini-obsidian

    A skill your agent uses when the user wants a health audit of the vault — stale content, provenance drift, frontmatter compliance, or MOC coverage gaps.

    102 GitHub stars~920 tokensUpdated 2 mo ago
    Auto-check passed
  • Wiki Ingest

    thoreinstein/gemini-obsidian

    A skill your agent uses when the user wants to ingest external sources into the vault — PDFs, markdown files, transcripts, Readwise exports, or any document.

    102 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Compound

    thoreinstein/gemini-obsidian

    A skill your agent uses when the user wants to promote cross-project knowledge to the global Engineering/ folder, or says "promote knowledge", "compound notes", "knowledge synthesis", or "find…

    102 GitHub stars~454 tokensUpdated 2 mo ago
    Auto-check passed
  • Journal

    thoreinstein/gemini-obsidian

    A skill your agent uses when the user wants to work with their daily note — view today's entry, add a log, do a daily review, or capture quick thoughts.

    102 GitHub stars~283 tokensUpdated 2 mo ago
    Auto-check passed
  • Link Audit

    thoreinstein/gemini-obsidian

    A skill your agent uses when the user wants to audit vault link health, find broken wikilinks, orphaned notes, or semantic clusters.

    102 GitHub stars~408 tokensUpdated 2 mo ago
    Auto-check passed

Works with

Questions about Moc Update

What does Moc Update do?

Use after creating a new Engineering/ note to suggest which Maps of Content (MOCs) it belongs in. Moc Update is an agent skill from thoreinstein/gemini-obsidian. Use after creating a new Engineering/ note to suggest which Maps of Content (MOCs) it belongs in.

When should I use Moc Update?

Moc Update fits situations like: the user has just created an Engineering/ note.

How do I install Moc Update in Claude Code?

Run `npx skills add thoreinstein/gemini-obsidian --skill moc-update -a claude-code`. Or copy the skill folder (skills/moc-update in thoreinstein/gemini-obsidian) into .claude/skills/moc-update in your project. Claude Code loads it when a task matches its description.

How do I install Moc Update in Codex?

Run `npx skills add thoreinstein/gemini-obsidian --skill moc-update -a codex`. Or copy the skill folder (skills/moc-update in thoreinstein/gemini-obsidian) into .agents/skills/moc-update in your project. Codex loads it when a task matches its description.

Can I use Moc Update in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add thoreinstein/gemini-obsidian --skill moc-update -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/moc-update, .gemini/skills/moc-update, .github/skills/moc-update and .opencode/skills/moc-update in your project.

What does Moc Update need to run?

SKILL.md names no scripts, command-line tools or credentials: Moc Update is instructions for the agent only.

Does Moc Update access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Moc Update safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Moc Update use?

Moc Update is published under the ISC licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Moc Update use?

About 355 tokens (SKILL.md is roughly 1.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Moc Update?

Skills that share tags, products or a category with Moc Update: Obsidian Bases (Atmosphere/atmosphere, 3.8k stars), Knap Markdown Templates (kepano/obsidian-skills, 49k stars), JSON Canvas (heyitsnoah/claudesidian, 2.6k stars) and Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Moc Update?

thoreinstein (a GitHub user) maintains it in thoreinstein/gemini-obsidian, which has 102 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on July 31, 2026.

Source: thoreinstein/gemini-obsidian on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.