@dzhechkov/harness-cli 0.3.16 → 0.3.18
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 +104 -6
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# @dzhechkov/harness-cli
|
|
2
2
|
|
|
3
|
-
The **`dz`** CLI — the main entry point to the DZ Harness Hub. Install AI skills for **Claude Code, Codex, OpenCode, Hermes** from a single command.
|
|
3
|
+
The **`dz`** CLI — the main entry point to the DZ Harness Hub. Install AI skills for **Claude Code, Codex, OpenCode, Hermes, OpenClaude** from a single command.
|
|
4
4
|
|
|
5
5
|
## Install
|
|
6
6
|
|
|
@@ -8,15 +8,113 @@ The **`dz`** CLI — the main entry point to the DZ Harness Hub. Install AI skil
|
|
|
8
8
|
npm install -g @dzhechkov/harness-cli
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## User Journey — from install to mastery
|
|
12
|
+
|
|
13
|
+
All 23 commands mapped to a real workflow:
|
|
14
|
+
|
|
15
|
+
```
|
|
16
|
+
DISCOVER → INSTALL → USE → CREATE → IMPROVE → SHARE
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
### Phase 1: Discover (what's available?)
|
|
12
20
|
|
|
13
21
|
```bash
|
|
14
|
-
|
|
15
|
-
|
|
22
|
+
npm install -g @dzhechkov/harness-cli # install the CLI
|
|
23
|
+
|
|
24
|
+
dz help # see all commands
|
|
25
|
+
dz stats # 28 packages, 59 skills, 5 targets, 10 presets
|
|
26
|
+
dz dashboard # visual panel — packages, adapters, skill packs
|
|
27
|
+
dz registry # browse all 59 skills by category
|
|
28
|
+
dz registry search kubernetes # find specific skills
|
|
29
|
+
dz registry --category devops # filter by domain
|
|
30
|
+
dz downloads # npm weekly download stats
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
### Phase 2: Install (set up your workspace)
|
|
16
34
|
|
|
17
|
-
|
|
35
|
+
```bash
|
|
36
|
+
# Pick a target platform + preset:
|
|
37
|
+
dz init --target claude-code --preset devops # 20 DevOps skills
|
|
38
|
+
dz init --target openclaude --preset web3 # 12 DeFi skills for OpenClaude
|
|
39
|
+
dz init --target codex --preset mcp # 10 MCP skills for Codex
|
|
40
|
+
|
|
41
|
+
# Or pick individual skills:
|
|
42
|
+
dz init --target claude-code --select terraform,kubernetes,docker-compose
|
|
43
|
+
|
|
44
|
+
# Or install from any npm package:
|
|
45
|
+
dz install @dzhechkov/skills-devops # npm install + copy skills
|
|
46
|
+
|
|
47
|
+
# Verify everything is correct:
|
|
48
|
+
dz verify # structural validation
|
|
49
|
+
dz doctor # 7 health checks
|
|
50
|
+
dz list # show installed skills
|
|
51
|
+
dz info --id terraform # detailed info about a skill
|
|
18
52
|
```
|
|
19
53
|
|
|
54
|
+
### Phase 3: Use (work with your agent)
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
# Now use Claude Code / Codex / OpenCode / Hermes normally.
|
|
58
|
+
# Skills are auto-discovered from the platform's skills directory.
|
|
59
|
+
# Example in Claude Code:
|
|
60
|
+
# "Review this PR" → pr-review skill activates
|
|
61
|
+
# "Design an API" → api-design skill activates
|
|
62
|
+
# "Fix this CI" → ci-fix skill activates
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### Phase 4: Create (build your own skills)
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
# Scaffold a new skill:
|
|
69
|
+
dz create-skill --name my-skill --description "What it does" --tier 2
|
|
70
|
+
|
|
71
|
+
# With BTO-compatible eval templates:
|
|
72
|
+
dz create-skill --name my-skill --bto
|
|
73
|
+
|
|
74
|
+
# Benchmark your skill (aim for Grade A):
|
|
75
|
+
dz benchmark .claude/skills/my-skill # single skill — 19 L0 checks
|
|
76
|
+
dz benchmark packages/@dzhechkov/skills-devops --all # batch all
|
|
77
|
+
dz benchmark skill-a --compare skill-b # A/B compare
|
|
78
|
+
|
|
79
|
+
# Find skills to canonicalize from the ecosystem:
|
|
80
|
+
dz scout # scan 9 sources (GitHub, npm, HN, ...)
|
|
81
|
+
dz scout --deep # deep analysis with SKILL.md parsing
|
|
82
|
+
dz auto-canonicalize --source github.com/user/repo --pack packages/@dzhechkov/skills-devops
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
### Phase 5: Maintain (keep skills fresh)
|
|
86
|
+
|
|
87
|
+
```bash
|
|
88
|
+
# Check for upstream changes (canonicalized skills):
|
|
89
|
+
dz sync-upstream --package packages/@dzhechkov/skills-devops
|
|
90
|
+
|
|
91
|
+
# Check installed skills vs canonical:
|
|
92
|
+
dz upgrade # shows which skills need update
|
|
93
|
+
dz upgrade --target openclaude # check specific platform
|
|
94
|
+
|
|
95
|
+
# Sync canonical to legacy layout:
|
|
96
|
+
dz sync # canonical → project skills
|
|
97
|
+
dz migrate # detect legacy installations
|
|
98
|
+
|
|
99
|
+
# Orchestrate dynamic workflows:
|
|
100
|
+
dz workflow --task coverage-lift # parallel coverage improvement
|
|
101
|
+
dz workflow --task security-audit # adversarial security scan
|
|
102
|
+
|
|
103
|
+
# Cross-host state sync:
|
|
104
|
+
dz roam --apply # sync agent state across machines
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
### Phase 6: Share (publish to the world)
|
|
108
|
+
|
|
109
|
+
```bash
|
|
110
|
+
# Publish updated packages to npm:
|
|
111
|
+
dz publish --dry-run # preview
|
|
112
|
+
dz publish --filter skills-devops # publish specific package
|
|
113
|
+
dz publish # publish all changed packages
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
20
118
|
## Presets vs Individual Skills
|
|
21
119
|
|
|
22
120
|
| Approach | When to use | Example |
|
|
@@ -426,4 +524,4 @@ npx @dzhechkov/p-replicator init
|
|
|
426
524
|
|
|
427
525
|
## Status
|
|
428
526
|
|
|
429
|
-
`v0.3.
|
|
527
|
+
`v0.3.17` — published on npm. Part of [DZ Harness Hub](https://github.com/djd1m/dz-harness-hub).
|
package/package.json
CHANGED