@lythos/skill-deck 0.9.19 → 0.9.20
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +19 -17
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
This package exposes a **CLI**. Invoke via:
|
|
10
10
|
|
|
11
11
|
```bash
|
|
12
|
-
bunx @lythos/skill-deck@0.9.
|
|
12
|
+
bunx @lythos/skill-deck@0.9.20 <command> [options]
|
|
13
13
|
```
|
|
14
14
|
|
|
15
15
|
No installation required. `bunx` auto-downloads the package.
|
|
@@ -41,26 +41,28 @@ path = "github.com/mattpocock/skills/skills/engineering/tdd"
|
|
|
41
41
|
[tool.skills.gstack]
|
|
42
42
|
path = "github.com/garrytan/gstack"
|
|
43
43
|
|
|
44
|
-
[
|
|
45
|
-
path = "
|
|
44
|
+
[transient.trial-skill] # Trial skills with auto-expiry
|
|
45
|
+
path = "./skills/experimental"
|
|
46
|
+
expires = "2026-06-01" # ISO date; warns at ≤14 days
|
|
46
47
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
48
|
+
# combo is a meta-declaration, not a skill type (doesn't count against max_cards):
|
|
49
|
+
[combo.report-generation]
|
|
50
|
+
skills = ["web-search", "docx", "mermaid"]
|
|
51
|
+
prompt = "Search for latest info, then generate professional document with diagrams"
|
|
50
52
|
```
|
|
51
53
|
|
|
52
54
|
### When to invoke
|
|
53
55
|
|
|
54
56
|
| Situation | Command |
|
|
55
57
|
|-----------|---------|
|
|
56
|
-
| Sync working set with `skill-deck.toml` | `bunx @lythos/skill-deck@0.9.
|
|
57
|
-
| Validate `skill-deck.toml` before committing | `bunx @lythos/skill-deck@0.9.
|
|
58
|
-
| Download a skill to cold pool and add to deck | `bunx @lythos/skill-deck@0.9.
|
|
59
|
-
| Pull latest versions of declared skills | `bunx @lythos/skill-deck@0.9.
|
|
60
|
-
| Refresh a single skill by alias | `bunx @lythos/skill-deck@0.9.
|
|
61
|
-
| Remove a skill from deck and working set | `bunx @lythos/skill-deck@0.9.
|
|
62
|
-
| GC unreferenced repos from cold pool | `bunx @lythos/skill-deck@0.9.
|
|
63
|
-
| Use a custom deck file or working dir | `bunx @lythos/skill-deck@0.9.
|
|
58
|
+
| Sync working set with `skill-deck.toml` | `bunx @lythos/skill-deck@0.9.20 link` |
|
|
59
|
+
| Validate `skill-deck.toml` before committing | `bunx @lythos/skill-deck@0.9.20 validate` |
|
|
60
|
+
| Download a skill to cold pool and add to deck | `bunx @lythos/skill-deck@0.9.20 add owner/repo` |
|
|
61
|
+
| Pull latest versions of declared skills | `bunx @lythos/skill-deck@0.9.20 refresh` |
|
|
62
|
+
| Refresh a single skill by alias | `bunx @lythos/skill-deck@0.9.20 refresh tdd` |
|
|
63
|
+
| Remove a skill from deck and working set | `bunx @lythos/skill-deck@0.9.20 remove tdd` |
|
|
64
|
+
| GC unreferenced repos from cold pool | `bunx @lythos/skill-deck@0.9.20 prune` |
|
|
65
|
+
| Use a custom deck file or working dir | `bunx @lythos/skill-deck@0.9.20 link --deck ./my-deck.toml --workdir /path/to/project` |
|
|
64
66
|
|
|
65
67
|
### Commands
|
|
66
68
|
|
|
@@ -81,7 +83,7 @@ expires = "2026-05-01" # ISO date; warns at ≤14 days
|
|
|
81
83
|
| `--workdir <dir>` | Working directory | cwd |
|
|
82
84
|
|
|
83
85
|
| `--alias <alias>` | Explicit alias for the skill (default: basename of path) | — |
|
|
84
|
-
| `--type <type>` | Target section for `add`: `innate`, `tool`, or `
|
|
86
|
+
| `--type <type>` | Target section for `add`: `innate`, `tool`, or `transient` | `tool` |
|
|
85
87
|
|
|
86
88
|
### Safety guards
|
|
87
89
|
|
|
@@ -117,7 +119,7 @@ path = "github.com/lythos-labs/lythoskill/skills/lythoskill-deck"
|
|
|
117
119
|
EOF
|
|
118
120
|
|
|
119
121
|
# 2. Link — creates symlinks in .claude/skills/
|
|
120
|
-
bunx @lythos/skill-deck@0.9.
|
|
122
|
+
bunx @lythos/skill-deck@0.9.20 link
|
|
121
123
|
```
|
|
122
124
|
|
|
123
125
|
### Key Concepts
|
|
@@ -146,7 +148,7 @@ Different agents look for skills in different directories. `skill-deck.toml` con
|
|
|
146
148
|
|
|
147
149
|
| Symptom | Cause | Fix |
|
|
148
150
|
|---------|-------|-----|
|
|
149
|
-
| `❌ Skill not found: <name>` | Skill declared in deck but not in cold pool | `bunx @lythos/skill-deck@0.9.
|
|
151
|
+
| `❌ Skill not found: <name>` | Skill declared in deck but not in cold pool | `bunx @lythos/skill-deck@0.9.20 add github.com/owner/repo/skill` or clone manually into cold pool |
|
|
150
152
|
| `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 |
|
|
151
153
|
| `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 |
|
|
152
154
|
| `deck update` prints deprecation warning | `update` was renamed to `refresh` in v0.8+ | Use `deck refresh` instead |
|