mcpField
W
wiki-sync

wiki-sync

github.com/richard-kim-79Productivity50227 installsUpdated 23w ago
Repository

About wiki-sync

wiki-sync is a skill for turning research notes into a structured wiki knowledge base. It suits people organizing scattered notes, with conventions for page links, sources, and an automatically maintained index, plus configurable output settings.

Key features

  1. 01Extract concepts from existing notes
  2. 02Create or update one page per concept
  3. 03Generate and maintain a wiki index
  4. 04Add cross-links between pages
  5. 05Configure output directory and language

Use cases

  1. 01Organize scattered research notes as a wiki
  2. 02Update existing concept pages incrementally
  3. 03Add source references and related-page links

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/richard-kim-79/archora-skills --skill wiki-sync

After installing, type/wiki-syncin Claude Code to confirm it loaded.

Details

From the project README

Wiki Sync

Organize research notes into a structured wiki knowledge base.

Wiki Conventions

  • Slugs: lowercase kebab-case (protein-folding, hypothesis-1)
  • Wikilinks: [[slug]] for internal links, [[slug|Display Text]] for custom labels
  • Index: always maintain a index.md with a table of all pages
  • One concept per page: each page should focus on a single entity, concept, or topic
  • Sources section: every page ends with a ## Sources section listing where the info came from

Workflow

  1. Audit existing notes — list all files, identify what already has wiki structure
  2. Identify concepts — extract key entities, topics, and relationships from unstructured notes
  3. Create/update pages — one page per concept, with cross-links
  4. Build index — generate or update index.md
  5. Report — list new pages created, pages updated, links added

Page Template

# [Page Title]

[1–2 sentence summary of this concept]

## Overview
[Detailed content about this concept]

## Related Concepts
- [[related-slug-1]] — [brief description of relationship]
- [[related-slug-2]] — [brief description of relationship]

## Sources
- [Source name/file]
- [Source URL if applicable]

*Last updated: [date]*

Index Template

# Wiki Index

> Auto-maintained index of all wiki pages.

| Page | Summary | Updated |
|------|---------|---------|
| [[slug-1]] Page Title | One-line summary | YYYY-MM-DD |
| [[slug-2]] Page Title | One-line summary | YYYY-MM-DD |

Configuration

Override defaults by adding a wiki-sync.config.md file in your notes directory:

# Wiki Sync Config

maxPages: 20
outputDir: wiki/
indexFile: index.md
language: en
OptionDefaultDescription
maxPages8Max pages created per sync run. Increase for large note collections.
outputDir. (same dir as notes)Subdirectory to write wiki pages into
indexFileindex.mdFilename for the auto-generated index
languageenOutput language for generated text (en, ko, ja, etc.)

If no config file is present, all defaults apply.

Rules

  • Default max 8 pages per sync run — override with maxPages in config (avoid overwhelming the user)
  • Prefer updating existing pages over creating new ones for incremental syncs
  • Never delete existing content — append or update sections
  • Always rebuild the index after adding pages
  • Respect outputDir if set in config — write all new pages there

Comments

Markdown supported