$npx -y skills add richard-kim-79/archora-skills --skill wiki-syncOrganizes research notes into a structured wiki knowledge base with wikilinks ([[slug]] syntax), cross-references, and an auto-generated index. Use when the user asks to build a wiki, organize notes into a knowledge base, create an index, or sync notes into a structured format.
| 1 | # Wiki Sync |
| 2 | |
| 3 | Organize research notes into a structured wiki knowledge base. |
| 4 | |
| 5 | ## Wiki Conventions |
| 6 | |
| 7 | - **Slugs**: lowercase kebab-case (`protein-folding`, `hypothesis-1`) |
| 8 | - **Wikilinks**: `[[slug]]` for internal links, `[[slug|Display Text]]` for custom labels |
| 9 | - **Index**: always maintain a `index.md` with a table of all pages |
| 10 | - **One concept per page**: each page should focus on a single entity, concept, or topic |
| 11 | - **Sources section**: every page ends with a `## Sources` section listing where the info came from |
| 12 | |
| 13 | ## Workflow |
| 14 | |
| 15 | 1. **Audit existing notes** — list all files, identify what already has wiki structure |
| 16 | 2. **Identify concepts** — extract key entities, topics, and relationships from unstructured notes |
| 17 | 3. **Create/update pages** — one page per concept, with cross-links |
| 18 | 4. **Build index** — generate or update `index.md` |
| 19 | 5. **Report** — list new pages created, pages updated, links added |
| 20 | |
| 21 | ## Page Template |
| 22 | |
| 23 | ```markdown |
| 24 | # [Page Title] |
| 25 | |
| 26 | [1–2 sentence summary of this concept] |
| 27 | |
| 28 | ## Overview |
| 29 | [Detailed content about this concept] |
| 30 | |
| 31 | ## Related Concepts |
| 32 | - [[related-slug-1]] — [brief description of relationship] |
| 33 | - [[related-slug-2]] — [brief description of relationship] |
| 34 | |
| 35 | ## Sources |
| 36 | - [Source name/file] |
| 37 | - [Source URL if applicable] |
| 38 | |
| 39 | *Last updated: [date]* |
| 40 | ``` |
| 41 | |
| 42 | ## Index Template |
| 43 | |
| 44 | ```markdown |
| 45 | # Wiki Index |
| 46 | |
| 47 | > Auto-maintained index of all wiki pages. |
| 48 | |
| 49 | | Page | Summary | Updated | |
| 50 | |------|---------|---------| |
| 51 | | [[slug-1]] Page Title | One-line summary | YYYY-MM-DD | |
| 52 | | [[slug-2]] Page Title | One-line summary | YYYY-MM-DD | |
| 53 | ``` |
| 54 | |
| 55 | ## Configuration |
| 56 | |
| 57 | Override defaults by adding a `wiki-sync.config.md` file in your notes directory: |
| 58 | |
| 59 | ```markdown |
| 60 | # Wiki Sync Config |
| 61 | |
| 62 | maxPages: 20 |
| 63 | outputDir: wiki/ |
| 64 | indexFile: index.md |
| 65 | language: en |
| 66 | ``` |
| 67 | |
| 68 | | Option | Default | Description | |
| 69 | |--------|---------|-------------| |
| 70 | | `maxPages` | `8` | Max pages created per sync run. Increase for large note collections. | |
| 71 | | `outputDir` | `.` (same dir as notes) | Subdirectory to write wiki pages into | |
| 72 | | `indexFile` | `index.md` | Filename for the auto-generated index | |
| 73 | | `language` | `en` | Output language for generated text (`en`, `ko`, `ja`, etc.) | |
| 74 | |
| 75 | If no config file is present, all defaults apply. |
| 76 | |
| 77 | ## Rules |
| 78 | |
| 79 | - Default max **8 pages** per sync run — override with `maxPages` in config (avoid overwhelming the user) |
| 80 | - Prefer updating existing pages over creating new ones for incremental syncs |
| 81 | - Never delete existing content — append or update sections |
| 82 | - Always rebuild the index after adding pages |
| 83 | - Respect `outputDir` if set in config — write all new pages there |