diff --git a/CHANGELOG.md b/CHANGELOG.md index 0f6b0b8af..2f9204ea9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,40 @@ # Changelog +## [0.20.0] - 2026-05-29 + +### New Features + +#### Git scope control (`git_root`) + +- **`git_root` scope** — choose which directory `skillshare commit`, `push`, and `pull` version. The default stays your skills source, but you can point git at `agents`, `extras`, or `root` (skills + agents + extras together in a single repo). Set it during init, or switch later on an existing setup: + ```bash + skillshare init --git-root root # version skills, agents, and extras in one repo + skillshare init --git-root agents # switch scope headlessly later + ``` + A `root`-scope repo automatically keeps `config.yaml` out of version control (it holds machine-specific paths), and nested git repositories are detected and blocked before they would upload as empty submodules. If `git_root` points to a scope whose directory has no repo, `commit`/`push`/`pull` print a "Git root mismatch" error with the exact commands to fix it. +- **Switch scope from the dashboard** — the Git Sync page can change the `git_root` scope, set the git remote during the switch, and offers a one-click action when the scoped directory isn't a repository yet. + +#### Extras extension transforms + +- **`extension` field on extras targets** — convert Markdown into a tool's native format during sync, for tools that don't read Markdown. Reference extensions ship for Gemini CLI (TOML commands) and Codex CLI (TOML agents): + ```yaml + extras: + - name: commands + targets: + - path: .gemini/commands + extension: gemini-commands # transforms .md → .toml during sync + ``` + Transforms run source → target only (`extras collect` skips them), use `copy` semantics, and never overwrite a local file or directory without `--force`. The Codex agents extension maps `name`, `description`, and `model` from frontmatter. +- **Manage extensions from the dashboard** — the Config page lists installed extensions with descriptions and guards against removing one that is still in use; the Extras page and Add Extra modal include a per-target extension picker. + +#### List filtering + +- **Filter skills by enabled/disabled status** — press `s` in the `list` TUI to cycle All → Enabled → Disabled, or use the `s:enabled` / `s:disabled` tag to combine status with other filters. The dashboard Resources page gains the same status filter. + +### Bug Fixes + +- **Hardened git remote handling** — remote URLs beginning with `-` (which git could misinterpret as a flag) are now rejected when setting or adding a remote, including via `skillshare init --remote`. + ## [0.19.24] - 2026-05-27 ### New Features diff --git a/README.md b/README.md index 8a3fb5aea..0551f3af5 100644 --- a/README.md +++ b/README.md @@ -40,7 +40,7 @@
> [!NOTE] -> **Latest**: [v0.19.24](https://github.com/runkids/skillshare/releases/tag/v0.19.24) — `skillshare commit` creates local git checkpoints without pushing; the Git Sync page now supports **Commit locally**. [All releases →](https://github.com/runkids/skillshare/releases) +> **Latest**: [v0.20.0](https://github.com/runkids/skillshare/releases/tag/v0.20.0) — choose what `commit`/`push`/`pull` version with **git_root scope** (skills, agents, extras, or all together in one repo); extras **extension transforms** convert Markdown to native formats (Gemini TOML commands, Codex TOML agents) during sync. [All releases →](https://github.com/runkids/skillshare/releases) ## Why skillshare @@ -277,6 +277,9 @@ Thanks to everyone who helped shape skillshare.
+
+
+
---
diff --git a/skills/skillshare/SKILL.md b/skills/skillshare/SKILL.md
index 086f4f126..5c4297095 100644
--- a/skills/skillshare/SKILL.md
+++ b/skills/skillshare/SKILL.md
@@ -15,7 +15,7 @@ description: |
`.agentignore` and `enable`/`disable` for per-agent toggles.
argument-hint: "[command] [target] [--json] [--dry-run] [-p|-g]"
metadata:
- version: v0.19.24
+ version: v0.20.0
---
# Skillshare CLI
diff --git a/website/docs/troubleshooting/common-errors.md b/website/docs/troubleshooting/common-errors.md
index e10d3d1b8..c6e7a89fe 100644
--- a/website/docs/troubleshooting/common-errors.md
+++ b/website/docs/troubleshooting/common-errors.md
@@ -205,6 +205,39 @@ git config --global user.name "Your Name"
git config --global user.email "you@example.com"
```
+### `Git root mismatch`
+
+**Cause:** `git_root` in `config.yaml` points to a scope directory that has no git repo, but another scope directory does. This happens when you change `git_root` without relocating the repository — switching scope means "start versioning a different directory", not "move the existing history". See [`git_root`](/docs/reference/targets/configuration#git-root).
+
+**Solution:** Pick one of the three options the error prints:
+```bash
+# Start a fresh repo at the configured scope (no history)
+skillshare init --git-root