mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 20:34:19 +00:00
docs: add install duplicate detection docs and v0.16.4 changelog
- Add Duplicate Detection section to install.md (same-repo skip, cross-path detection, conflict with different repo) - Update --force flag description to mention dedup override - Add v0.16.4 changelog entry to CHANGELOG.md and website
This commit is contained in:
@@ -1,5 +1,29 @@
|
||||
# Changelog
|
||||
|
||||
## [0.16.4] - 2026-02-27
|
||||
|
||||
### New Features
|
||||
|
||||
- **Cross-path duplicate detection** — `install` now detects when a repo is already installed at a different location and blocks the operation with a clear hint:
|
||||
```bash
|
||||
skillshare install runkids/feature-radar --into feature-radar
|
||||
# later...
|
||||
skillshare install runkids/feature-radar
|
||||
# ✗ this repo is already installed at skills/feature-radar/scan (and 2 more)
|
||||
# Use 'skillshare update' to refresh, or reinstall with --force to allow duplicates
|
||||
```
|
||||
- **Same-repo skip** — reinstalling a skill from the same repo now shows a friendly `⊘ skipped` indicator instead of an error; skipped skills are grouped by directory with repo label in the summary
|
||||
- **Web UI install dedup** — the Web UI install endpoints enforce the same cross-path duplicate check as the CLI, returning HTTP 409 when duplicates are found
|
||||
|
||||
### Fixed
|
||||
|
||||
- **`--force` hint accuracy** — the force hint now uses the actual repo URL (not per-skill subpath) and includes `--into` when applicable
|
||||
- **`update` root-level skills** — root-level skill repos (SKILL.md at repo root) no longer appear as stale/deleted during batch update; fixed `Subdir` normalization mismatch between metadata (`""`) and discovery (`"."`)
|
||||
|
||||
### Improvements
|
||||
|
||||
- **`update` batch summary** — batch update summary now uses the same single-line stats format as `sync` with color-coded counts
|
||||
|
||||
## [0.16.3] - 2026-02-27
|
||||
|
||||
### Improvements
|
||||
|
||||
@@ -241,7 +241,7 @@ See [Project Setup](/docs/how-to/sharing/project-setup) for the full guide.
|
||||
|------|-------|-------------|
|
||||
| `--name <name>` | | Override installed name when exactly one skill is installed |
|
||||
| `--into <dir>` | | Install into subdirectory (e.g. `--into frontend` or `--into frontend/react`) |
|
||||
| `--force` | `-f` | Overwrite existing skill; also override audit blocking |
|
||||
| `--force` | `-f` | Overwrite existing skill; override audit blocking and cross-path duplicate check |
|
||||
| `--update` | `-u` | Update if exists (git pull or reinstall) |
|
||||
| `--track` | `-t` | Keep `.git` for tracked repos |
|
||||
| `--skill` | `-s` | Select specific skills from multi-skill repo (comma-separated) |
|
||||
@@ -255,6 +255,52 @@ See [Project Setup](/docs/how-to/sharing/project-setup) for the full guide.
|
||||
| `--global` | `-g` | Install into global `~/.config/skillshare/skills/` |
|
||||
| `--dry-run` | `-n` | Preview only |
|
||||
|
||||
## Duplicate Detection
|
||||
|
||||
skillshare automatically detects when you're about to install something that already exists:
|
||||
|
||||
### Same-repo reinstall
|
||||
|
||||
If a skill already exists and was installed from the **same repo**, skillshare skips it with a warning instead of failing:
|
||||
|
||||
```bash
|
||||
skillshare install anthropics/skills/skills/pdf
|
||||
# ✓ Installed pdf
|
||||
|
||||
skillshare install anthropics/skills/skills/pdf
|
||||
# ⊘ pdf — already installed from same repo
|
||||
```
|
||||
|
||||
Use `--update` to refresh, or `--force` to overwrite.
|
||||
|
||||
### Cross-path duplicate
|
||||
|
||||
If a repo is already installed at one location and you try to install it at a **different** location, skillshare blocks the operation:
|
||||
|
||||
```bash
|
||||
# First install (into a subdirectory)
|
||||
skillshare install runkids/feature-radar --into feature-radar
|
||||
|
||||
# Later, forget about the first install
|
||||
skillshare install runkids/feature-radar
|
||||
# ✗ this repo is already installed at skills/feature-radar/scan (and 2 more)
|
||||
# Use 'skillshare update' to refresh, or reinstall with --force to allow duplicates
|
||||
```
|
||||
|
||||
This prevents accidental duplicates across different paths. Use `--force` to allow it intentionally.
|
||||
|
||||
### Conflict with different repo
|
||||
|
||||
If the destination directory exists but was installed from a **different** repo, the error message includes the original source:
|
||||
|
||||
```bash
|
||||
skillshare install owner/repo-b --name my-skill
|
||||
# ✗ my-skill already exists (installed from https://github.com/owner/repo-a.git).
|
||||
# To overwrite: skillshare install owner/repo-b --name my-skill --force
|
||||
```
|
||||
|
||||
The `--force` hint always includes the correct flags (including `--into` if applicable).
|
||||
|
||||
## Common Scenarios
|
||||
|
||||
**Install with custom name:**
|
||||
|
||||
@@ -9,6 +9,30 @@ All notable changes to skillshare are documented here. For the full commit histo
|
||||
|
||||
---
|
||||
|
||||
## [0.16.4] - 2026-02-27
|
||||
|
||||
### New Features
|
||||
|
||||
- **Cross-path duplicate detection** — `install` now detects when a repo is already installed at a different location and blocks the operation with a clear hint:
|
||||
```bash
|
||||
skillshare install runkids/feature-radar --into feature-radar
|
||||
# later...
|
||||
skillshare install runkids/feature-radar
|
||||
# ✗ this repo is already installed at skills/feature-radar/scan (and 2 more)
|
||||
# Use 'skillshare update' to refresh, or reinstall with --force to allow duplicates
|
||||
```
|
||||
- **Same-repo skip** — reinstalling a skill from the same repo now shows a friendly `⊘ skipped` indicator instead of an error; skipped skills are grouped by directory with repo label in the summary
|
||||
- **Web UI install dedup** — the Web UI install endpoints enforce the same cross-path duplicate check as the CLI, returning HTTP 409 when duplicates are found
|
||||
|
||||
### Fixed
|
||||
|
||||
- **`--force` hint accuracy** — the force hint now uses the actual repo URL (not per-skill subpath) and includes `--into` when applicable
|
||||
- **`update` root-level skills** — root-level skill repos (SKILL.md at repo root) no longer appear as stale/deleted during batch update; fixed `Subdir` normalization mismatch between metadata (`""`) and discovery (`"."`)
|
||||
|
||||
### Improvements
|
||||
|
||||
- **`update` batch summary** — batch update summary now uses the same single-line stats format as `sync` with color-coded counts
|
||||
|
||||
## [0.16.3] - 2026-02-27
|
||||
|
||||
### Improvements
|
||||
|
||||
Reference in New Issue
Block a user