skillshop 2.2.0 → 4.1.0

package/templates/skillshop-library/README.md

@@ -0,0 +1,40 @@
+# Skillshop personal library template
+
+This is a forkable, plain-folder library for user-authored skills. No `package.json`, build step, or npm metadata is required. Create a GitHub repository named `skillshop-library` under your account to share skills with `skillshop download @owner/skill`.
+
+The repository uses `skillshop-library.json` to name its source directory. The default is `skills/`:
+
+```json
+{
+  "schemaVersion": 1,
+  "skillsDirectory": "skills"
+}
+```
+
+Add one directory under `skills/` per skill. Each needs a `SKILL.md` with front matter containing `name` and `description`. Author/version metadata is optional. References, scripts, hidden files, binary assets, nested files, and executable modes stay beside the manifest and are copied as part of the complete directory.
+
+## Use the library
+
+```bash
+skillshop library init [directory]     # select or adopt a local source folder (no migration)
+skillshop library list
+skillshop download @alice/review       # add source only
+skillshop install @alice/review        # download if absent, then install locally
+skillshop install @alice/review --global
+skillshop install review               # install an existing selected source
+skillshop sync                         # update recorded local and global copies
+```
+
+`library init` defaults to the visible `~/skillshop-library` directory. It can also create or select an existing folder with this layout. Existing skill sources and valid config are retained. Add skills by copying their directories into the configured source folder.
+
+`download @owner/skill` reads `https://github.com/owner/skillshop-library.git` and adds the selected skill to the personal library without installing it. The `@` is CLI syntax and is stripped from the GitHub owner. Unprefixed `owner/skill` inputs are rejected. A same-name authored or different-origin source fails safely. Use `download @owner/skill --force` only when you intend to replace that library source.
+
+`install @owner/skill` downloads when the source is absent and then installs from the personal library. If a same-origin source already exists, local edits are reused without fetching. `install name` uses the selected local source. `--global` selects configured user skill directories.
+
+`sync` propagates full-tree changes from the library roots recorded with installed copies. It includes file additions, edits, deletions, binary/reference assets, and mode changes. It replaces content inside those Skillshop-owned directories, repairs divergent installed edits, and removes stale extras. An unchanged copy is left in place. It does not fetch GitHub. Switching the active library does not redirect older installs.
+
+`sync` is also the explicit migration step for tracked copies made by older bundled Skillshop installs; `library init` never migrates. A source already in the selected library wins and updates the tracked copies. If the source is missing, Skillshop imports it only when every surviving tracked project and global copy agrees in paths, file bytes, and modes. Conflicts, unknown source kinds, malformed ownership state, unmanaged directories, and package-import snapshots are preserved and reported. Missing recorded destinations are pruned, never recreated.
+
+The `skillsDirectory` field can name another safe relative directory inside this library. Set it to `.` to use skill folders directly in the library root.
+
+Installation ownership is recorded in `.skillshop-lock` inside each destination skills directory, not at the library or project root. Project dependency declarations (`skillshop.json`) and their reproducibility lock (`skillshop-lock.json`) are a separate opt-in workflow.

package/templates/skillshop-library/skills/example/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: example
+description: A starting point for a personal Skillshop library skill.
+---
+
+# Example skill
+
+Describe what the skill does and how to use it.

package/templates/skillshop-library/skills/example/references/example.md

@@ -0,0 +1,3 @@
+# Example reference
+
+Keep source material and other assets inside the skill directory.

package/templates/skillshop-library/skills/example/scripts/run.sh

@@ -0,0 +1,2 @@
+#!/bin/sh
+printf '%s\n' 'Example skill script'

package/templates/skillshop-library/skillshop-library.json

@@ -0,0 +1,4 @@
+{
+  "schemaVersion": 1,
+  "skillsDirectory": "skills"
+}