Skip to main content
skill CX Codex

knowledge · thoreinstein — Claude Code skill: what it does, how to install

This skill finds ideas repeated across project notes and drafts a shared note in Engineering/. Use it to turn recurring project knowledge into a linked concept.

ISC ★ 102 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add thoreinstein/gemini-obsidian --skill knowledge -a claude-code
Open on GitHub

What knowledge does

The skill scans working/*/knowledge/*.md, then uses obsidian_rag_query to find semantically related notes. A note becomes a candidate when matching results come from at least two projects. The agent reads the candidates and drafts Engineering/<ConceptName>.md with a concept type, creation date, rewritten content, and links to the source notes.

You see the draft and its path before anything is created. After your approval, the skill calls obsidian_create_note, then lists project notes that should link back to the new concept. When search returns no results, it suggests running /obsidian:index; if no idea recurs across projects, it recommends manual promotion. The workflow depends on Obsidian tools being available to the agent.

What it helps with

  • spot ideas that recur in notes from different projects
  • turn shared definitions into a single concept note
  • retain links to the original notes with [[wikilinks]]
  • identify project notes that should link to a shared concept

Example prompts for the agent

  • Find ideas repeated across project knowledge notes and draft a shared concept.
  • Synthesize the authentication patterns in my project notes into a draft for Engineering/.
  • Review the source notes and show me which ones should link to the new concept.

How to install knowledge

1Skills CLI (Vercel)

npx skills add thoreinstein/gemini-obsidian --skill knowledge -a claude-code

2Manually: put the files in place

~/.claude/skills/knowledge/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/knowledge/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about knowledge

How do I install knowledge in Claude Code?

Run npx skills add thoreinstein/gemini-obsidian --skill knowledge -a claude-code. The skill file is at ~/.claude/skills/knowledge/SKILL.md.

What does knowledge do?

It finds ideas recurring in knowledge notes from multiple projects and drafts a shared note under Engineering/. The draft needs your approval before the skill creates it.

What happens when the search finds no notes?

The skill suggests running /obsidian:index. If no knowledge appears across multiple projects, it recommends promoting it manually.

Source text

SKILL.md · ISC
---
name: knowledge
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 `/obsidian:index` first
- If no notes appear in 2+ projects, report that and suggest manual promotion

© thoreinstein · ISC · thoreinstein/gemini-obsidian

Similar skills

All skills for Notes, tasks and projects →

knowledge by other authors comes first.

knowledge hoangnb24 The knowledge skill turns Amp discussions into checked documentation updates. Use it after a major piece of work or when project docs need to catch up with recent changes. CX Codex +1 1installs knowledge-ops claude-code-skills knowledge-ops is a Claude Code skill that drafts and checks SOPs and internal runbooks. It audits knowledge bases and ranks pages for cleanup. CX Codex +1 297installs li gasserane Catalogs, retrieves and reorganizes documents in a personal knowledge library and MEL Wiki. It does not answer domain questions. CX Codex +1 676installs obsidian-second-brain eugeniughelbur obsidian-second-brain — a skill for Claude Code that maintains an Obsidian vault as an evolving knowledge base. It activates for note searches and edits, vault upkeep, and new vault setup. CX Codex +1 543installs obsidian-kb-artifacts Galaxy-Dawn obsidian-kb-artifacts — a skill for Obsidian formatting and derived artifacts: wikilinks, registry tables, canvas files, Bases, and link repair. Works in Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. CX Codex +1 328installs content-curator davila7 The content-curator subagent audits Obsidian notes, spots duplicates and stale material, and suggests cleanup work. Use it when a vault needs regular content review. CX Codex 846installs llm-wiki Alireza Rezvani llm-wiki turns Claude into a disciplined wiki maintainer: reads each source once, files it into linked Obsidian pages, and lets knowledge build up instead of being re-derived. ★ 30,251repo stars

From the same set15

The whole set →
vault Configures or initializes an Obsidian vault for the active agent session via the /vault command. CX Codex +1 ★ 102repo stars research research is a Claude Code skill that searches an Obsidian vault, reads relevant notes, and follows links to answer questions about stored knowledge. CX Codex +1 ★ 102repo stars 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”. CX Codex +1 ★ 102repo stars link-audit link-audit audits Obsidian vaults for broken wikilinks and orphaned notes. Helps repair target paths or generate new links via semantic search. CX Codex +1 ★ 102repo stars journal journal — a skill for your Obsidian daily note: it reads today's entry, appends quick logs and builds weekly or end-of-day reviews from CLI sessions. CX Codex +1 ★ 102repo stars obsidian-companion obsidian-companion connects your assistant to an Obsidian vault to edit files, inspect broken wikilinks, and run queries using local RAG. CX Codex +1 ★ 102repo stars cross-linker cross-linker finds mentions of other Obsidian notes that lack wikilinks, then sorts possible links by confidence. Use it to connect notes across a chosen folder or a wider vault scope. CX Codex +1 ★ 102repo stars vault-lint vault-lint audits an Obsidian vault across five checks and returns a prioritised report with fixes you accept one at a time. CX Codex +1 ★ 102repo stars

Project sponsors

Companies that keep this analytics open