mykg

Files (25)

• marketplace.json · .claude-plugin/
• plugin.json · .claude-plugin/
• LICENSE
• README.md
• SKILL.md
• kg-ingest.md · commands/
• kg-init.md · commands/
• kg-lint.md · commands/
• kg-project.md · commands/
• kg-query.md · commands/
• kg-setup.md · commands/
• concepts.md · docs/
• examples.md · docs/
• AGENTS.md · templates/kg-init/
• Active.md · templates/kg-init/
• index.md · templates/kg-init/
• log.md · templates/kg-init/
• .gitkeep · templates/kg-init/raw/articles/
• .gitkeep · templates/kg-init/raw/notes/
• .gitkeep · templates/kg-init/raw/papers/
• .gitkeep · templates/kg-init/raw/transcripts/
• .gitkeep · templates/kg-init/wiki/comparisons/
• .gitkeep · templates/kg-init/wiki/concepts/
• .gitkeep · templates/kg-init/wiki/entities/
• .gitkeep · templates/kg-init/wiki/synthesis/

SKILL.md (first lines)

# MyKG: Universal Knowledge Graph

An LLM-maintained personal knowledge base. The LLM incrementally builds and maintains a structured wiki of markdown files — reading sources, extracting knowledge, updating pages, and keeping everything connected.

## Setup

### 1. Initialize

```bash
# From kgskills repo
cp -r templates/kg-init/* ~/MyKG
# Or use /kg-init command
```

### 2. Configure Path

```bash
# Option A: Environment variable (add to ~/.bashrc or ~/.zshrc)
export MYKG_PATH="$HOME/MyKG"

# Option B: Config file
mkdir -p ~/.config/mykg
echo "/path/to/your/kg" > ~/.config/mykg/config
```

### 3. (Optional) Use with Obsidian

Point your Obsidian vault at the `MYKG_PATH` for graph view, backlinks, and browsing.

## Optional Skill Integrations

These companion skills from [kepano/obsidian-skills](https://github.com/kepano/obsidian-skills) enhance mykg when installed.

| Skill | When to use |
|-------|-------------|
| `obsidian-markdown` | Use when creating or editing wiki pages — ensures correct wikilink syntax (`[[Page]]`), frontmatter, callouts, and embeds |
| `obsidian-cli` | Use when the KG lives in an Obsidian vault — open pages, search vault content, navigate notes directly |
| `defuddle` | Use instead of WebFetch when ingesting a URL — strips nav/clutter and returns clean markdown, saving tokens |

If these skills are loaded, prefer them over raw file edits or WebFetch for the relevant operations.

## KG Path Resolution

The skill resolves the KG path in this order:
1. `MYKG_PATH` environment variable
2. `~/.config/mykg/config` file
3. `~/.mykgrc` file
4. Common locations: `~/MyKG`, `~/Dev/Obsidian/MyKG`
5. Ask user for location

## Three Layers

```
┌─────────────────────────────────────────────┐
│              Raw Sources (immutable)         │
│  Papers, articles, transcripts, notes, URLs │
└──────────────────────┬──────────────────────┘
                       │ ingest
                       ▼
┌─────────────────────────────────────────────┐
│              Wiki (LLM-maintained)           │
│  Summaries, entity pages, concepts,         │
│  synthesis, cross-references                │
└──────────────────────┬──────────────────────┘
                       │ query
                       ▼
┌─────────────────────────────────────────────┐
│              Schema (configuration)          │
│  AGENTS.md — tells the LLM how to maintain  │
└─────────────────────────────────────────────┘
```

### Raw Sources (`raw/`)
Immutable source documents. The LLM reads from them but never modifies them. This is the source of truth.

### Wiki (`wiki/`)
LLM-generated markdown files. Summaries, entity pages, concept pages, comparisons, synthesis. The LLM owns this layer — it creates pages, updates them, maintains cross-references, and keeps everything consistent. You read it; the LLM writes it.

### Schema (`AGENTS.md`)
Tells the LLM how the wiki is structured, what conventions to follow, and what workflows to use. Co-evolve this over time.

## Structure

```
MyKG/
├── index.md              ← Catalog of all pages. START HERE.
├── log.md                ← Chronological change history.
├── AGENTS.md             ← Schema: structure, conventions, workflows.
├── Active.md             ← Current focus items and priorities.
├── raw/                  ← Source documents (immutable).
│   ├── articles/
│   ├── papers/
│   ├── transcripts/
│   └── notes/
├── wiki/                 ← LLM-generated wiki pages.
│   ├── entities/         ← Pages for specific entities (people, orgs, tools).
│   ├── concepts/         ← Pages for ideas, topics, themes.
│   ├── synthesis/        ← High-level summaries and overviews.
│   └── comparisons/      ← Side-by-side analyses.
└── <Project>/            ← One subdirectory per project.
    ├── SKILL.md          ← Project-specific skill (optional).
    ├── AGENTS.md         ← Project-specific schema (optional).
    ├── raw/              ← Project sources.
    └── wiki/             ← Project wiki pages.
```

## Operations

### Ingest

Read a source, extract knowledge, integrate into the wiki:

1. Read the source document
2. Discuss key takeaways with user
3. Write a summary page in `wiki/`
4. Create/update entity pages in `wiki/entities/`
5. Create/update concept pages in `wiki/concepts/`
6. Note contradictions with existing pages
7. Update `index.md` with new pages

From Ethics03/kgskill, MIT.

More from Ethics03/kgskill