From 7d4e6cad42e4897bb226de93d630a101933557a7 Mon Sep 17 00:00:00 2001 From: Willie Date: Tue, 7 Apr 2026 16:10:30 +0800 Subject: [PATCH] docs: add v0.18.9 changelog and document relative symlinks in project mode --- CHANGELOG.md | 10 ++++++++++ website/docs/understand/project-skills.md | 2 ++ website/docs/understand/sync-modes.md | 4 ++++ website/src/pages/changelog.md | 10 ++++++++++ 4 files changed, 26 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 518058888..c3b0b8e19 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,15 @@ # Changelog +## [0.18.9] - 2026-04-07 + +### New Features + +- **Relative symlinks in project mode** — `skillshare sync -p` now creates relative symlinks (e.g., `../../.skillshare/skills/my-skill`) instead of absolute paths. This makes the project directory portable — rename it, move it, or clone it on another machine and all skill symlinks continue to work. Global mode continues to use absolute paths. Existing absolute symlinks are automatically upgraded to relative on the next sync + +### Bug Fixes + +- **Status version detection** — `skillshare status` no longer reports `! Skill: not found or missing version` when the version is stored under `metadata.version` in the SKILL.md frontmatter. Previously, the `status` command used its own local parser that only checked for a top-level `version:` key, while `doctor` (fixed in v0.18.7) and `upgrade` already used the correct shared parser + ## [0.18.8] - 2026-04-06 ### Bug Fixes diff --git a/website/docs/understand/project-skills.md b/website/docs/understand/project-skills.md index 995bfb2aa..00978f35d 100644 --- a/website/docs/understand/project-skills.md +++ b/website/docs/understand/project-skills.md @@ -117,6 +117,8 @@ skillshare sync -g # Force global mode └── (same symlink structure as .claude/skills/) ``` +Symlinks in project mode use **relative paths** (e.g., `../../.skillshare/skills/...`). This makes the project directory portable — rename it, move it, or clone it on another machine and all symlinks continue to work. Global mode uses absolute paths since source and targets are in separate filesystem locations. + --- ## Config Format diff --git a/website/docs/understand/sync-modes.md b/website/docs/understand/sync-modes.md index 65f40a06a..d45a5a1bd 100644 --- a/website/docs/understand/sync-modes.md +++ b/website/docs/understand/sync-modes.md @@ -56,6 +56,10 @@ skills/ ~/.claude/skills/ - Per-target include/exclude filtering - Manifest-based orphan cleanup (safely removes non-symlink residue after uninstall) +:::info Relative symlinks in project mode +In project mode (`-p`), symlinks are created as **relative paths** (e.g., `../../.skillshare/skills/my-skill`) instead of absolute paths. This makes the project portable — move or rename the directory and symlinks continue to work. In global mode, absolute paths are used since source and targets are in different locations. +::: + **When to use:** - You want some skills only in specific AI CLIs - You want to try local skills before syncing diff --git a/website/src/pages/changelog.md b/website/src/pages/changelog.md index 57be2f290..f0ec88f7d 100644 --- a/website/src/pages/changelog.md +++ b/website/src/pages/changelog.md @@ -9,6 +9,16 @@ All notable changes to skillshare are documented here. For the full commit histo --- +## [0.18.9] - 2026-04-07 + +### New Features + +- **Relative symlinks in project mode** — `skillshare sync -p` now creates relative symlinks (e.g., `../../.skillshare/skills/my-skill`) instead of absolute paths. This makes the project directory portable — rename it, move it, or clone it on another machine and all skill symlinks continue to work. Global mode continues to use absolute paths. Existing absolute symlinks are automatically upgraded to relative on the next sync + +### Bug Fixes + +- **Status version detection** — `skillshare status` no longer reports `! Skill: not found or missing version` when the version is stored under `metadata.version` in the SKILL.md frontmatter. Previously, the `status` command used its own local parser that only checked for a top-level `version:` key, while `doctor` (fixed in v0.18.7) and `upgrade` already used the correct shared parser + ## [0.18.8] - 2026-04-06 ### Bug Fixes