From c9ec165bb49c31cbb02ada2445da0630bda0d7eb Mon Sep 17 00:00:00 2001 From: Rick Hightower Date: Thu, 29 Jan 2026 14:06:24 -0600 Subject: [PATCH] docs: add wiki-mapping.yml and fix documentation inconsistencies MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add wiki-mapping.yml for GitHub wiki synchronization - Fix version references in COMPREHENSIVE_USER_GUIDE.md (v1.2.0 → v1.10.0) - Fix path table inconsistencies (updated for native agent support) - Update GEMINI_MIGRATION.md version reference - Add version header to SUPPORTED_AGENTS.md - Add version header to UNIVERSAL_AGENT_GUIDE.md GitHub Wiki populated with 11 documentation pages: - Home (from README with wiki navigation) - User-Manual, Comprehensive-User-Guide, Supported-Agents - Gemini-Migration-Guide, Universal-Agent-Guide, Deploy-PyPI - Changelog, Architectural-Decisions, Key-Facts, Known-Issues Co-Authored-By: Claude Opus 4.5 --- docs/COMPREHENSIVE_USER_GUIDE.md | 22 +++++++++++----------- docs/GEMINI_MIGRATION.md | 4 ++-- docs/SUPPORTED_AGENTS.md | 2 ++ docs/UNIVERSAL_AGENT_GUIDE.md | 2 ++ docs/wiki-mapping.yml | 25 +++++++++++++++++++++++++ 5 files changed, 42 insertions(+), 13 deletions(-) create mode 100644 docs/wiki-mapping.yml diff --git a/docs/COMPREHENSIVE_USER_GUIDE.md b/docs/COMPREHENSIVE_USER_GUIDE.md index 6cc29eb..297f731 100644 --- a/docs/COMPREHENSIVE_USER_GUIDE.md +++ b/docs/COMPREHENSIVE_USER_GUIDE.md @@ -263,17 +263,17 @@ skilz install spillwave/plantuml --agent gemini # Always project-level | `claude` | `~/.claude/skills/` | `.claude/skills/` | | `codex` | `~/.codex/skills/` | `.codex/skills/` | | `opencode` | `~/.config/opencode/skill/` | `.opencode/skill/` | +| `gemini` | `~/.gemini/skills/` | `.gemini/skills/` | +| `copilot` | `~/.copilot/skills/` | `.github/skills/` | +| `cursor` | `~/.cursor/skills/` | `.cursor/skills/` | +| `qwen` | `~/.qwen/skills/` | `.qwen/skills/` | +| `windsurf` | `~/.codeium/windsurf/skills/` | `.windsurf/skills/` | | `universal` | `~/.skilz/skills/` | `.skilz/skills/` | -| `gemini` | _(not supported)_ | `.skilz/skills/` | -| `copilot` | _(not supported)_ | `.github/skills/` | -| `cursor` | _(not supported)_ | `.skills/skills/` | -| `aider` | _(not supported)_ | `.skills/skills/` | -| `qwen` | _(not supported)_ | `.skills/skills/` | -| `windsurf` | _(not supported)_ | `.skills/skills/` | -| `kimi` | _(not supported)_ | `.skills/skills/` | -| `crush` | _(not supported)_ | `.skills/skills/` | -| `plandex` | _(not supported)_ | `.skills/skills/` | -| `zed` | _(not supported)_ | `.skills/skills/` | +| `aider` | _(not supported)_ | `.skilz/skills/` | +| `kimi` | _(not supported)_ | `.skilz/skills/` | +| `crush` | _(not supported)_ | `.skilz/skills/` | +| `plandex` | _(not supported)_ | `.skilz/skills/` | +| `zed` | _(not supported)_ | `.skilz/skills/` | --- @@ -822,4 +822,4 @@ skilz install --agent gemini --- -_This guide covers Skilz CLI v1.2.0+. For the latest updates, see the [GitHub repository](https://github.com/SpillwaveSolutions/skilz-cli)._ +_This guide covers Skilz CLI v1.10.0. For the latest updates, see the [GitHub repository](https://github.com/SpillwaveSolutions/skilz-cli)._ diff --git a/docs/GEMINI_MIGRATION.md b/docs/GEMINI_MIGRATION.md index 8b5e086..0040202 100644 --- a/docs/GEMINI_MIGRATION.md +++ b/docs/GEMINI_MIGRATION.md @@ -1,7 +1,7 @@ # Gemini CLI Migration Guide -**Version:** Skilz 1.7.0 -**Date:** January 8, 2026 +**Version:** Skilz 1.10.0 (Guide covers features introduced in 1.7.0) +**Date:** January 2026 --- diff --git a/docs/SUPPORTED_AGENTS.md b/docs/SUPPORTED_AGENTS.md index a524e67..ccbaa50 100644 --- a/docs/SUPPORTED_AGENTS.md +++ b/docs/SUPPORTED_AGENTS.md @@ -1,5 +1,7 @@ # Supported AI Coding Agents +**Version:** Skilz 1.10.0 + Skilz supports **30+ AI coding agents** from the [AGENTS.md](https://agents.md/) ecosystem, following the [agentskills.io](https://agentskills.io/) standard for skill format and installation. ## Agent Categories diff --git a/docs/UNIVERSAL_AGENT_GUIDE.md b/docs/UNIVERSAL_AGENT_GUIDE.md index 44f5b1d..b040e69 100644 --- a/docs/UNIVERSAL_AGENT_GUIDE.md +++ b/docs/UNIVERSAL_AGENT_GUIDE.md @@ -1,5 +1,7 @@ # Universal Agent Guide +**Version:** Skilz 1.10.0 + ## Overview The **Universal Agent** is a special agent type in Skilz that provides maximum flexibility for skill management. Unlike native agents (Claude, Gemini, Codex) that have specific directory structures and behaviors, the universal agent lets you: diff --git a/docs/wiki-mapping.yml b/docs/wiki-mapping.yml new file mode 100644 index 0000000..81efc3f --- /dev/null +++ b/docs/wiki-mapping.yml @@ -0,0 +1,25 @@ +# Wiki Mapping for skilz-cli +# Maps source files to GitHub Wiki page names (without .md extension) +# Sync with: git clone https://github.com/SpillwaveSolutions/skilz-cli.wiki.git +# +# Usage: Copy source files to wiki directory with renamed filenames +# Example: README.md → Home.md + +core: + README.md: "Home" + +docs: + docs/USER_MANUAL.md: "User-Manual" + docs/COMPREHENSIVE_USER_GUIDE.md: "Comprehensive-User-Guide" + docs/SUPPORTED_AGENTS.md: "Supported-Agents" + docs/GEMINI_MIGRATION.md: "Gemini-Migration-Guide" + docs/UNIVERSAL_AGENT_GUIDE.md: "Universal-Agent-Guide" + docs/DEPLOY_PYPI.md: "Deploy-PyPI" + +project: + CHANGELOG.md: "Changelog" + +notes: + docs/project_notes/key_facts.md: "Key-Facts" + docs/project_notes/decisions.md: "Architectural-Decisions" + docs/project_notes/bugs.md: "Known-Issues"