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…

ISCAuto-check passed

Install Compound

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

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

GitHub CLI
$ gh skill install thoreinstein/gemini-obsidian compound --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/compound .claude/skills/compound && 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
compound
GitHub stars
102
Token cost
~454 tokens
SKILL.md length
192 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
ISC

At a glance

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…

  • Works in 7 steps: Scan project knowledge dirs — Call… → Semantic clustering — For each knowledge… → Read candidates — Call… → …
  • The user wants to promote cross-project knowledge to the global Engineering/ folder
  • SKILL.md covers Workflow, Arguments and Tips
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Compound is an agent skill from thoreinstein/gemini-obsidian. Use when the user wants to promote cross-project knowledge to the global Engineering/ folder, or says "promote knowledge", "compound notes", "knowledge synthesis", or "find repeated ideas across projects".

Its SKILL.md is about 450 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 wants to promote cross-project knowledge to the global Engineering/ folder
  • Says promote knowledge
  • Knowledge synthesis
  • Find repeated ideas across projects

Example prompts

  • “promote knowledge”
  • “compound notes”
  • “knowledge synthesis”
  • “/compound”

Workflow steps

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

  1. Scan project knowledge dirs — Call obsidian_list_notes with subfolder: "working".
  2. Semantic clustering — For each knowledge note path, call obsidian_rag_query
  3. Read candidates — Call obsidian_read_note on shortlisted files.
  4. Draft global note — Compose a new Engineering/.md with
  5. Show draft to user — Present the proposed note content and path before creating.
  6. Create on approval — Call obsidian_create_note with the approved content.
  7. Report cross-links — List which project knowledge notes should now add [[ConceptName]]

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

Compound loads about 454 tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 192 words of instructions outside code blocks.

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

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). 192 words, ~454 tokens.

Download SKILL.mdSave it as .claude/skills/compound/SKILL.md (or your agent's skills folder).
name
compound
description
Use when the user wants to promote cross-project knowledge to the global Engineering/ folder, or says "promote knowledge", "compound notes", "knowledge synthesis", or "find repeated ideas across projects".

Compound Knowledge Promotion

Identify knowledge that has crystallized across multiple projects and promote it to a global Engineering/ note.

Workflow

  1. Scan project knowledge dirs — Call obsidian_list_notes with subfolder: "working". Filter results to paths matching working/*/knowledge/*.md.

  2. Semantic clustering — For each knowledge note path, call obsidian_rag_query with the note filename (without extension) as query, limit: 8. Track which notes appear in results from 2+ different projects — these are candidates.

  3. Read candidates — Call obsidian_read_note on shortlisted files. Look for shared definitions, patterns, or insights worth generalizing.

  4. Draft global note — Compose a new Engineering/<ConceptName>.md with:

    • Frontmatter: type: concept, created: <today>
    • Synthesized body (not copy-paste — rewrite for clarity)
    • ## Source Notes section with [[wikilinks]] back to originating notes
  5. Show draft to user — Present the proposed note content and path before creating. Ask for confirmation.

  6. Create on approval — Call obsidian_create_note with the approved content.

  7. Report cross-links — List which project knowledge notes should now add [[ConceptName]] to avoid re-discovering this knowledge next time.

Arguments

Optional topic hint: /compound authentication patterns

Tips

  • If obsidian_rag_query returns no results, suggest running /index first
  • If no notes appear in 2+ projects, report that and suggest manual promotion

© 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/compound of thoreinstein/gemini-obsidian.

Open the folder on GitHubat commit 9156cba

Compare with similar skills

Compound 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.

Compound compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Compound this skillthoreinstein/gemini-obsidian102—~454Automated 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
Obsidian CLIAtmosphere/atmosphere3.8k13 repos~795Automated safety check: PassApache-2.0

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
  • 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
  • Llmwiki

    atomicstrata/llm-wiki-compiler

    Build and use a persistent, citation-traceable knowledge wiki from documents, research papers, notes, or project documentation.

    2.2k GitHub starsUsed in 1 repo~814 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
  • 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
  • Links

    thoreinstein/gemini-obsidian

    A skill your agent uses when the user wants to explore connections between notes, see what links to or from a note, or says "links", "backlinks", "connections", or "graph".

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

Works with

Questions about Compound

What does Compound do?

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…. Compound is an agent skill from thoreinstein/gemini-obsidian. Use when the user wants to promote cross-project knowledge to the global Engineering/ folder, or says "promote knowledge", "compound notes", "knowledge synthesis", or "find repeated ideas across projects".

When should I use Compound?

Compound fits situations like: the user wants to promote cross-project knowledge to the global Engineering/ folder; says promote knowledge; knowledge synthesis; find repeated ideas across projects.

How do I install Compound in Claude Code?

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

How do I install Compound in Codex?

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

Can I use Compound 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 compound -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/compound, .gemini/skills/compound, .github/skills/compound and .opencode/skills/compound in your project.

What does Compound need to run?

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

Does Compound 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 Compound 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 Compound use?

Compound 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 Compound use?

About 454 tokens (SKILL.md is roughly 1.8k 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 Compound?

Skills that share tags, products or a category with Compound: 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 Compound?

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.