fabioc-aloha Wiki Publish Skill
Publish master-wiki/ to the GitHub Wiki repo (AlexMaster.wiki.git). The master-wiki uses folder-based organization; GitHub Wiki requires flat filenames. This skill encodes the transformation rules.
Source and Target
| Property | Value |
|---|---|
| Source | master-wiki/ in AlexMaster repo |
| Target | https://github.com/fabioc-aloha/AlexMaster.wiki.git |
| Sidebar | master-wiki/_Sidebar.md (canonical, synced to wiki) |
| Footer | master-wiki/_Footer.md (canonical, synced to wiki) |
| Assets | All image/SVG files from asset dirs → wiki root (flat) |
Automation
node scripts/publish-master-wiki.cjs # full publish
node scripts/publish-master-wiki.cjs --dry-run # preview mapping
node scripts/publish-master-wiki.cjs --no-push # flatten to .wiki-publish-tmp/
node scripts/publish-master-wiki.cjs --message "docs: v8.0.0"
The script handles folder-to-prefix mapping, link rewriting, and asset flattening.
Folder-to-Prefix Mapping
GitHub Wiki is flat. Files in subfolders get a prefix derived from the folder name.
| Source Folder | Wiki Prefix | README Target |
|---|---|---|
master-wiki/ (root) |
(none) | Home.md |
master-wiki/architecture/ |
(none) | — |
master-wiki/blog/ |
BLOG- |
BLOG-HOME.md |
master-wiki/brand/ |
(none) | — |
master-wiki/cowork/ |
COWORK- |
COWORK-README.md |
master-wiki/critical-thinking/ |
CRITICAL-THINKING- |
CRITICAL-THINKING-README.md |
master-wiki/decisions/ |
(none) | — |
master-wiki/guides/ |
(none) | — |
master-wiki/heirs/ |
(none) | HEIR-SYSTEM.md |
master-wiki/platforms/m365/ |
(none) | — |
master-wiki/portraits/ |
(none) | PORTRAITS.md |
master-wiki/research/ |
(none) | — |
master-wiki/rituals/ |
(none) | RITUALS-OVERVIEW.md |
master-wiki/safety/ |
(none) | — |
master-wiki/ui-ux/ |
(none) | — |
master-wiki/vscode/ |
(none) | — |
master-wiki/assets/ |
(none) | SVGs copied flat to wiki root |
Special File Mappings
| Source | Wiki Name | Reason |
|---|---|---|
master-wiki/README.md |
Home.md |
GitHub Wiki convention |
master-wiki/_Sidebar.md |
_Sidebar.md |
GitHub Wiki special file |
master-wiki/_Footer.md |
_Footer.md |
GitHub Wiki special file |
Link Rewriting Rules
Internal links must be rewritten from relative paths to flat wiki page names (no .md extension).
| Source Link Pattern | Wiki Link |
|---|---|
./MEDITATION.md |
MEDITATION |
../architecture/COGNITIVE-ARCHITECTURE.md |
COGNITIVE-ARCHITECTURE |
../assets/banner-rituals.svg |
banner-rituals.svg |
./README.md (within a folder) |
Mapped per folder prefix table above |
Link rewriting is handled by scripts/publish-master-wiki.cjs.
Publish Checklist
node scripts/publish-master-wiki.cjs --dry-run— verify mappingnode scripts/publish-master-wiki.cjs— publish
The script handles clone, flatten, link-rewrite, commit, push, and cleanup.
What NOT to Publish
| Excluded | Reason |
|---|---|
master-wiki/alex3/ |
Image generation assets, not docs |
master-wiki/skills/ |
Internal skill docs, not user-facing |
*.json files |
Build artifacts |
CNAME, index.html |
Static site files, not wiki |
Common Gotchas
- Relative paths break in wiki: GitHub Wiki renders all pages at root level. Paths like
../assets/image.pngthat work in the repo fail in published wiki. Use./assets/image.pngor absolute URLs. - Sidebar ordering:
_Sidebar.mdcontrols navigation. Update it when adding new pages or reorganizing sections. - Image assets must be flat: Wiki doesn't support subdirectories for assets. All SVGs go to wiki root.
- Duplicate page names: Two source files mapping to the same wiki name will overwrite each other. The prefix table prevents this — follow it strictly.