docs: update v0.17.0 changelog with UI redesign and additional bug fixes

Add Web UI redesign section (clean design, table view, keyboard shortcuts,
onboarding tour) and two missing bug fixes (dotdir skipping during install
discovery, sync collision message). Sync website changelog from v0.16.15
to v0.17.0 entry. Update release notes with matching content.
This commit is contained in:
Willie
2026-03-12 16:45:02 +08:00
parent 91d22fbaf5
commit 9501b59874
3 changed files with 81 additions and 3 deletions
+14
View File
@@ -33,6 +33,18 @@ Extras (non-skill resources like rules, prompts, commands) are now a first-class
- **`sync extras --json`** — structured JSON output for programmatic consumption
- **`sync --all -p`** — project-mode `--all` now includes extras sync
#### Web UI Redesign
The web dashboard (`skillshare ui`) received a complete visual overhaul — replacing the hand-drawn aesthetic with a clean, minimal design:
- **Redesigned design system** — new DM Sans typography, clean border-radius, streamlined color palette with proper dark mode support
- **Table view with pagination** — skills and search results now offer a table view alongside the existing card/grouped views, with client-side pagination for large collections
- **Sticky search and filters** — SkillsPage toolbar stays pinned at the top while scrolling, with grouped view sticky headers
- **Keyboard modifier shortcuts** — press `?` to see available shortcuts, with an on-screen HUD overlay showing active modifiers
- **Sync progress animation** — visual feedback during sync operations
- **Onboarding tour** — step-by-step spotlight tour for first-time users, highlighting key features
- **Shared UI components** — new DialogShell, IconButton, Pagination, and SegmentedControl components for consistent interactions across pages
#### Web UI Extras Page
- New **Extras page** in the web dashboard with list, sync, remove, and add-extra modal
@@ -77,6 +89,8 @@ Extras (non-skill resources like rules, prompts, commands) are now a first-class
```
Non-GitLab hosts (GHE, Gitea, etc.) retain the original `owner/repo` + subdir behavior. GitLab web URLs with `/-/tree/` and Bitbucket `/src/` markers continue to work as before. `--track` mode generates correct names for subgroup paths (e.g., `group-subgroup-project`)
- **HTTPS fallback on non-GitLab hosts** — fixed platform-aware HTTPS URL parsing that could misroute GitHub Enterprise and Gitea URLs with subdirectory paths
- **Skill discovery in projects** — `skillshare install` now skips known AI tool config directories (`.claude/`, `.cursor/`, etc.) when scanning a project directory for skills, preventing circular discovery and false duplicates
- **Sync collision message** — `skillshare sync` now shows both duplicate skill names in collision warning messages for easier troubleshooting
## [0.16.14] - 2026-03-09
+17 -2
View File
@@ -10,8 +10,9 @@ v0.17.0 promotes **extras** from a sync sub-feature to a **first-class citizen**
2. **Interactive TUI wizard** — `extras init` with step-by-step name → target → mode flow
3. **Project mode** — all extras commands support `-p` for `.skillshare/`-scoped extras
4. **Deep integration** — `status`, `doctor`, `diff`, `sync` all gain extras awareness
5. **Web UI** — new Extras management page + Dashboard card + REST API endpoints
6. **Auto-migration** — legacy flat directories (`configDir/rules/`) automatically move to `configDir/extras/rules/`
5. **Web UI redesign** — complete visual overhaul with clean design, table view, keyboard shortcuts, onboarding tour
6. **Web UI Extras page** — new Extras management page + Dashboard card + REST API endpoints
7. **Auto-migration** — legacy flat directories (`configDir/rules/`) automatically move to `configDir/extras/rules/`
### Breaking Change
@@ -111,6 +112,18 @@ Project-mode `--all` now includes extras sync alongside skills.
## Web UI
### Visual Redesign
The web dashboard received a complete visual overhaul — replacing the hand-drawn aesthetic with a clean, minimal design:
- **New design system** — DM Sans typography, clean border-radius, streamlined color palette with proper dark mode support
- **Table view with pagination** — skills and search results offer a table view alongside card/grouped views, with client-side pagination
- **Sticky search and filters** — SkillsPage toolbar stays pinned at the top, with grouped view sticky headers
- **Keyboard modifier shortcuts** — press `?` to see available shortcuts, with on-screen HUD overlay
- **Sync progress animation** — visual feedback during sync operations
- **Onboarding tour** — step-by-step spotlight tour for first-time users
- **Shared UI components** — DialogShell, IconButton, Pagination, SegmentedControl for consistent interactions
### Extras Page
New page at `/extras` in the web dashboard:
@@ -197,6 +210,8 @@ Also included from v0.16.15:
- **`SKILLSHARE_GITLAB_HOSTS` env var** — comma-separated list for CI/CD pipelines without a config file; merged with config values
- **GitLab nested subgroup URL fix** — URLs like `gitlab.com/group/subgroup/project` are now treated as the full repo path
- **HTTPS fallback fix** — platform-aware HTTPS URL parsing no longer misroutes GitHub Enterprise and Gitea URLs
- **Skill discovery in projects** — `install` now skips known AI tool config directories (`.claude/`, `.cursor/`, etc.) during project scanning, preventing circular discovery
- **Sync collision message** — `sync` now shows both duplicate skill names in collision warnings
---
+50 -1
View File
@@ -9,10 +9,57 @@ All notable changes to skillshare are documented here. For the full commit histo
---
## [0.16.15] - 2026-03-11
## [0.17.0] - 2026-03-11
### Breaking Changes
- **Extras directory structure** — extras source files are now stored under `extras/<name>/` instead of directly under the config root. Existing directories are **auto-migrated** on first `sync extras` run. No manual action required
### New Features
#### First-Class Extras Command Group
Extras (non-skill resources like rules, prompts, commands) are now a first-class feature with their own command group:
- **`extras init`** — create a new extra with interactive TUI wizard or CLI flags:
```bash
skillshare extras init rules --target ~/.claude/rules --target ~/.cursor/rules
skillshare extras init prompts --target .claude/prompts --mode copy -p
```
- **`extras list`** — view all configured extras with sync status (`synced`, `drift`, `not synced`, `no source`). Supports `--json` output
- **`extras remove`** — remove an extra from config (source files and synced targets are preserved)
- **`extras collect`** — reverse-sync local files from a target back into the extras source directory:
```bash
skillshare extras collect rules --from ~/.claude/rules --dry-run
```
- **Project mode** — all extras commands support `--project`/`-p` for `.skillshare/` scoped extras
#### Extras Integration with Existing Commands
- **`status`** — shows extras file count and target count per extra
- **`doctor`** — checks that extras source directories exist and target parent directories are reachable
- **`diff --extras`** — per-file diff for extras targets; `diff --all` shows combined skills + extras diff
- **`sync extras --json`** — structured JSON output for programmatic consumption
- **`sync --all -p`** — project-mode `--all` now includes extras sync
#### Web UI Redesign
The web dashboard (`skillshare ui`) received a complete visual overhaul — replacing the hand-drawn aesthetic with a clean, minimal design:
- **Redesigned design system** — new DM Sans typography, clean border-radius, streamlined color palette with proper dark mode support
- **Table view with pagination** — skills and search results now offer a table view alongside the existing card/grouped views, with client-side pagination for large collections
- **Sticky search and filters** — SkillsPage toolbar stays pinned at the top while scrolling, with grouped view sticky headers
- **Keyboard modifier shortcuts** — press `?` to see available shortcuts, with an on-screen HUD overlay showing active modifiers
- **Sync progress animation** — visual feedback during sync operations
- **Onboarding tour** — step-by-step spotlight tour for first-time users, highlighting key features
- **Shared UI components** — new DialogShell, IconButton, Pagination, and SegmentedControl components for consistent interactions across pages
#### Web UI Extras Page
- New **Extras page** in the web dashboard with list, sync, remove, and add-extra modal
- **Dashboard card** showing extras count, total files, and total targets
- REST API: `GET /api/extras`, `GET /api/extras/diff`, `POST /api/extras`, `POST /api/extras/sync`, `DELETE /api/extras/{name}`
#### Custom GitLab Domain Support
- **JihuLab auto-detection** — hosts containing `jihulab` in the name (e.g., `jihulab.com`) are now automatically detected alongside `gitlab`, so nested subgroup URLs work without any config
@@ -51,6 +98,8 @@ All notable changes to skillshare are documented here. For the full commit histo
```
Non-GitLab hosts (GHE, Gitea, etc.) retain the original `owner/repo` + subdir behavior. GitLab web URLs with `/-/tree/` and Bitbucket `/src/` markers continue to work as before. `--track` mode generates correct names for subgroup paths (e.g., `group-subgroup-project`)
- **HTTPS fallback on non-GitLab hosts** — fixed platform-aware HTTPS URL parsing that could misroute GitHub Enterprise and Gitea URLs with subdirectory paths
- **Skill discovery in projects** — `skillshare install` now skips known AI tool config directories (`.claude/`, `.cursor/`, etc.) when scanning a project directory for skills, preventing circular discovery and false duplicates
- **Sync collision message** — `skillshare sync` now shows both duplicate skill names in collision warning messages for easier troubleshooting
## [0.16.14] - 2026-03-09