@lythos/skill-deck 0.9.47 → 0.9.48

package/README.md

@@ -9,7 +9,7 @@
 This package exposes a **CLI**. Invoke via:
 
 ```bash
-bunx @lythos/skill-deck@0.9.47 <command> [options]
+bunx @lythos/skill-deck@0.9.48 <command> [options]
 ```
 
 No installation required. `bunx` auto-downloads the package.
@@ -55,15 +55,15 @@ prompt = "Search for latest info, then generate professional document with diagr
 
 | Situation | Command |
 |-----------|---------|
-| Sync working set with `skill-deck.toml` | `bunx @lythos/skill-deck@0.9.47 link` |
-| Validate `skill-deck.toml` before committing | `bunx @lythos/skill-deck@0.9.47 validate` |
-| Download a skill to cold pool and add to deck | `bunx @lythos/skill-deck@0.9.47 add owner/repo` |
-| Pull latest versions of declared skills | `bunx @lythos/skill-deck@0.9.47 refresh` |
-| Refresh a single skill by alias | `bunx @lythos/skill-deck@0.9.47 refresh tdd` |
-| Remove a skill from deck and working set | `bunx @lythos/skill-deck@0.9.47 remove tdd` |
-| Switch skill to symlink mode (live) | `bunx @lythos/skill-deck@0.9.47 to-symlink tdd` |
-| Switch skill to snapshot mode (pinned) | `bunx @lythos/skill-deck@0.9.47 to-snapshot tdd` |
-| Use a custom deck file or working dir | `bunx @lythos/skill-deck@0.9.47 link --deck ./my-deck.toml --workdir /path/to/project` |
+| Sync working set with `skill-deck.toml` | `bunx @lythos/skill-deck@0.9.48 link` |
+| Validate `skill-deck.toml` before committing | `bunx @lythos/skill-deck@0.9.48 validate` |
+| Download a skill to cold pool and add to deck | `bunx @lythos/skill-deck@0.9.48 add owner/repo` |
+| Pull latest versions of declared skills | `bunx @lythos/skill-deck@0.9.48 refresh` |
+| Refresh a single skill by alias | `bunx @lythos/skill-deck@0.9.48 refresh tdd` |
+| Remove a skill from deck and working set | `bunx @lythos/skill-deck@0.9.48 remove tdd` |
+| Switch skill to symlink mode (live) | `bunx @lythos/skill-deck@0.9.48 to-symlink tdd` |
+| Switch skill to snapshot mode (pinned) | `bunx @lythos/skill-deck@0.9.48 to-snapshot tdd` |
+| Use a custom deck file or working dir | `bunx @lythos/skill-deck@0.9.48 link --deck ./my-deck.toml --workdir /path/to/project` |
 
 ### Commands
 
@@ -124,7 +124,7 @@ path = "github.com/lythos-labs/lythoskill/skills/lythoskill-deck"
 EOF
 
 # 2. Link — creates symlinks in .claude/skills/
-bunx @lythos/skill-deck@0.9.47 link
+bunx @lythos/skill-deck@0.9.48 link
 ```
 
 ### Key Concepts
@@ -210,7 +210,7 @@ Caution: deck's deny-by-default will remove any skills not declared in your deck
 
 | Symptom | Cause | Fix |
 |---------|-------|-----|
-| `❌ Skill not found: <name>` | Skill declared in deck but not in cold pool | `bunx @lythos/skill-deck@0.9.47 add github.com/owner/repo/skill` or clone manually into cold pool |
+| `❌ Skill not found: <name>` | Skill declared in deck but not in cold pool | `bunx @lythos/skill-deck@0.9.48 add github.com/owner/repo/skill` or clone manually into cold pool |
 | `link` skips entries with warnings | Real files/directories exist in working set (not symlinks) | Delete the real directories in `working_set` and re-run `link`. Never create directories manually there |
 | `refresh` reports "Not a git repository" | Skill was copied (not cloned) into cold pool | Re-clone with `git clone` or use `deck add` which clones by default |
 | `deck update` prints deprecation warning | `update` was renamed to `refresh` in v0.8+ | Use `deck refresh` instead |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lythos/skill-deck",
-  "version": "0.9.47",
+  "version": "0.9.48",
   "description": "Declarative skill deck governance — cold pool, working set, deny-by-default",
   "keywords": [
     "ai-agent",

package/src/cli.ts

@@ -29,7 +29,12 @@ if (cliDeck && isUrl(cliDeck)) {
   try {
     deckPath = await fetchDeckUrl(cliDeck)
   } catch (e: any) {
-    console.error(`❌ ${e.message}`)
+    console.error(`❌ Failed to fetch deck from URL: ${e.message}`)
+    console.error('')
+    console.error('The deck URL may be unreachable or require authentication.')
+    console.error('To fix:')
+    console.error('  - Verify the URL is correct and publicly accessible')
+    console.error('  - Use a local deck file instead: deck <command> --deck ./skill-deck.toml')
     process.exit(1)
   }
 } else if (cliDeck) {