@localskills/cli 0.11.0 → 0.11.2

package/README.md

@@ -8,6 +8,14 @@ CLI for [localskills.sh](https://localskills.sh) — install, manage, and publis
 npm install -g @localskills/cli
 ```
 
+Or with your package manager of choice:
+
+```bash
+pnpm add -g @localskills/cli
+yarn global add @localskills/cli
+bun add -g @localskills/cli
+```
+
 ## Supported platforms
 
 | Platform | ID | Global | Project | Method |
@@ -100,9 +108,14 @@ localskills list
 localskills list --public
 ```
 
-### `localskills publish [file]`
+### `localskills publish [path]`
+
+Publish a local skill to localskills.sh. `path` may be a single skill **file** or a skill **folder**:
 
-Publish a local skill file to localskills.sh. Without a file argument, scans your project for unpublished skill files across all supported platform directories.
+- **File** → published as a single-file (text) skill; frontmatter is stripped.
+- **Folder** → zipped and published as a multi-file **package** (e.g. a Claude skill directory: `SKILL.md` plus `scripts/`, `references/`, assets). Files are uploaded **verbatim** (frontmatter preserved). A skill folder must contain a `SKILL.md` at its root; a `--type rule` folder need not. Limits: **1 MB** compressed, **1 MB** uncompressed, **500 files**.
+
+Without a `path`, scans your project for unpublished skills across all supported platform directories. Detected Claude skill folders (`.claude/skills/<name>/`) are published as packages, bundling every file in the folder.
 
 ```bash
 # Scan and publish interactively
@@ -110,6 +123,9 @@ localskills publish
 
 # Publish a specific file
 localskills publish .cursor/rules/my-skill.mdc -n "My Skill" --visibility public
+
+# Publish a whole skill folder as a package
+localskills publish .claude/skills/my-skill -n "My Skill" --visibility public
 ```
 
 **Options:**
@@ -127,20 +143,33 @@ localskills publish .cursor/rules/my-skill.mdc -n "My Skill" --visibility public
 - **Copy** — writes a standalone copy. Independent of cache but requires re-install to update.
 - **Section** — for single-file platforms (Copilot, Codex, Windsurf global), injects the skill into a shared file between `<!-- localskills:start:slug -->` / `<!-- localskills:end:slug -->` markers.
 
+### Folder (package) skills
+
+Multi-file skills are cached **unpacked** as a real folder (never a `.zip`) under
+`cache/<slug>/pkg/`, so the cache mirrors the actual skill directory. Installing one
+symlinks (default) or copies that folder into the platform's per-skill directory —
+e.g. `~/.claude/skills/<slug>/`. Because folder skills are a directory format, they
+install to **Claude Code only**; other platforms are skipped with a notice.
+
 ## Configuration
 
 Config and cache are stored at `~/.localskills/`:
 
 ```
 ~/.localskills/
-  config.json       # Auth token, installed skills, preferences
+  config.json         # Auth token, installed skills, preferences
   cache/
     my-skill/
-      raw.md        # Original content
-      meta.json     # Hash, version, metadata
-      cursor.mdc    # Platform-specific transformed files
+      raw.md          # Original content (text skills)
+      meta.json       # Hash, version, metadata
+      cursor.mdc      # Platform-specific transformed files
       claude/
         SKILL.md
+    my-folder-skill/
+      meta.json
+      manifest.json   # File list for a package skill
+      pkg/            # Unpacked folder skill (SKILL.md + scripts/, references/, …)
+        SKILL.md
 ```
 
 ## License