@dzhechkov/harness-cli 0.3.15 → 0.3.17

package/README.md

@@ -8,15 +8,113 @@ The **`dz`** CLI — the main entry point to the DZ Harness Hub. Install AI skil
 npm install -g @dzhechkov/harness-cli
 ```
 
-## Quick Start
+## User Journey — from install to mastery
+
+All 23 commands mapped to a real workflow:
+
+```
+DISCOVER → INSTALL → USE → CREATE → IMPROVE → SHARE
+```
+
+### Phase 1: Discover (what's available?)
 
 ```bash
-# Install a preset (curated skill set) for your platform:
-dz init --target claude-code --preset meta
+npm install -g @dzhechkov/harness-cli    # install the CLI
+
+dz help                                   # see all commands
+dz stats                                  # 28 packages, 59 skills, 5 targets, 10 presets
+dz dashboard                              # visual panel — packages, adapters, skill packs
+dz registry                               # browse all 59 skills by category
+dz registry search kubernetes             # find specific skills
+dz registry --category devops             # filter by domain
+dz downloads                              # npm weekly download stats
+```
+
+### Phase 2: Install (set up your workspace)
+
+```bash
+# Pick a target platform + preset:
+dz init --target claude-code --preset devops   # 20 DevOps skills
+dz init --target openclaude --preset web3      # 12 DeFi skills for OpenClaude
+dz init --target codex --preset mcp            # 10 MCP skills for Codex
+
+# Or pick individual skills:
+dz init --target claude-code --select terraform,kubernetes,docker-compose
+
+# Or install from any npm package:
+dz install @dzhechkov/skills-devops            # npm install + copy skills
+
+# Verify everything is correct:
+dz verify                                       # structural validation
+dz doctor                                       # 7 health checks
+dz list                                         # show installed skills
+dz info --id terraform                          # detailed info about a skill
+```
+
+### Phase 3: Use (work with your agent)
+
+```bash
+# Now use Claude Code / Codex / OpenCode / Hermes normally.
+# Skills are auto-discovered from the platform's skills directory.
+# Example in Claude Code:
+#   "Review this PR" → pr-review skill activates
+#   "Design an API" → api-design skill activates
+#   "Fix this CI" → ci-fix skill activates
+```
+
+### Phase 4: Create (build your own skills)
 
-# That's it — Claude Code will auto-discover the installed skills.
+```bash
+# Scaffold a new skill:
+dz create-skill --name my-skill --description "What it does" --tier 2
+
+# With BTO-compatible eval templates:
+dz create-skill --name my-skill --bto
+
+# Benchmark your skill (aim for Grade A):
+dz benchmark .claude/skills/my-skill           # single skill — 19 L0 checks
+dz benchmark packages/@dzhechkov/skills-devops --all   # batch all
+dz benchmark skill-a --compare skill-b          # A/B compare
+
+# Find skills to canonicalize from the ecosystem:
+dz scout                                        # scan 9 sources (GitHub, npm, HN, ...)
+dz scout --deep                                 # deep analysis with SKILL.md parsing
+dz auto-canonicalize --source github.com/user/repo --pack packages/@dzhechkov/skills-devops
+```
+
+### Phase 5: Maintain (keep skills fresh)
+
+```bash
+# Check for upstream changes (canonicalized skills):
+dz sync-upstream --package packages/@dzhechkov/skills-devops
+
+# Check installed skills vs canonical:
+dz upgrade                                      # shows which skills need update
+dz upgrade --target openclaude                  # check specific platform
+
+# Sync canonical to legacy layout:
+dz sync                                         # canonical → project skills
+dz migrate                                      # detect legacy installations
+
+# Orchestrate dynamic workflows:
+dz workflow --task coverage-lift                 # parallel coverage improvement
+dz workflow --task security-audit               # adversarial security scan
+
+# Cross-host state sync:
+dz roam --apply                                 # sync agent state across machines
 ```
 
+### Phase 6: Share (publish to the world)
+
+```bash
+# Publish updated packages to npm:
+dz publish --dry-run                            # preview
+dz publish --filter skills-devops               # publish specific package
+dz publish                                      # publish all changed packages
+```
+
+---
+
 ## Presets vs Individual Skills
 
 | Approach | When to use | Example |
@@ -55,11 +153,12 @@ npx @dzhechkov/skills-analyst-manual init  # 3-phase analyst composite
 
 **Difference:** `dz init --preset` installs individual skills from `.claude/skills/` source into a target platform tree. Standalone `npx` packages have their own CLI and install a complete toolkit with commands, rules, shards, and agents — a richer but self-contained experience.
 
-## All Commands (21)
+## All Commands (23)
 
 ```
 dz init              --target <name> [--preset <name>] [--select id,id,...] [--force]
 dz install           <npm-pkg> [--target <name>] [--project <dir>]
+dz upgrade           [--target <name>] [--project <dir>]
 dz verify            [--skills-dir <dir>] [--target <name>]
 dz sync              [--canonical <dir>] [--project <dir>] [--dry-run] [--force]
 dz update            (alias for sync)
@@ -73,6 +172,7 @@ dz auto-canonicalize --source <github-url> --pack <skills-pack>
 dz sync-upstream     [--package <dir>]
 dz scout             [--topics <list>] [--since <date>] [--deep]
 dz workflow          --task <name> [--dry-run]
+dz downloads
 dz migrate           [--project <dir>]
 dz stats
 dz dashboard
@@ -190,6 +290,55 @@ dz sync-upstream --package packages/@dzhechkov/skills-devops
 
 Reads `sources.json` in the package, fetches SKILL.md from origin repos, reports which skills have changed. Useful for keeping canonicalized skills in sync with their sources.
 
+### dz upgrade — check installed skills for updates
+
+```bash
+dz upgrade                           # check .claude/skills/ against canonical
+dz upgrade --target openclaude       # check .openclaude/skills/
+```
+
+Compares installed skills with canonical source, reports which need `dz init --force` to update.
+
+### dz downloads — npm weekly download stats
+
+```bash
+dz downloads     # fetch weekly downloads for all 28 packages
+```
+
+### dz benchmark — L0 quality gate
+
+```bash
+dz benchmark packages/@dzhechkov/skills-devops/terraform     # single skill
+dz benchmark packages/@dzhechkov/skills-devops --all          # batch all
+dz benchmark skill-a --compare skill-b                        # A/B compare
+```
+
+19 deterministic checks (U1-U5 universal + S1-S14 skill-specific). Grade A = 95%+. For L1/L2 LLM judges, use `/bto-test` inside Claude Code.
+
+### dz publish — automated npm publish
+
+```bash
+dz publish --dry-run                          # preview what would publish
+dz publish --filter skills-devops             # publish specific package
+dz publish --filter skills-devops --bump-only # bump version only, no publish
+```
+
+### dz auto-canonicalize — discover skills in GitHub repos
+
+```bash
+dz auto-canonicalize --source github.com/user/repo --pack packages/@dzhechkov/skills-devops
+```
+
+Scans a GitHub repo for SKILL.md files, generates `dz create-skill` commands.
+
+### dz registry — searchable skill index
+
+```bash
+dz registry                    # visual panel: 59 skills in 5 categories
+dz registry search security    # fuzzy search
+dz registry --category mcp     # filter by category
+```
+
 ### dz stats + dz dashboard
 
 ```bash
@@ -375,4 +524,4 @@ npx @dzhechkov/p-replicator init
 
 ## Status
 
-`v0.3.14` — published on npm. Part of [DZ Harness Hub](https://github.com/djd1m/dz-harness-hub).
+`v0.3.17` — published on npm. Part of [DZ Harness Hub](https://github.com/djd1m/dz-harness-hub).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/harness-cli",
-  "version": "0.3.15",
+  "version": "0.3.17",
   "description": "The dz CLI — install AI skills for Claude Code, Codex, OpenCode, Hermes. 11 commands, 7 presets, 4 platform adapters.",
   "type": "module",
   "license": "MIT",
@@ -35,8 +35,8 @@
   ],
   "dependencies": {
     "@dzhechkov/harness-core": "0.3.7",
-    "@dzhechkov/scout": "0.7.1",
-    "@dzhechkov/harness-presets": "0.2.6"
+    "@dzhechkov/harness-presets": "0.2.6",
+    "@dzhechkov/scout": "0.7.1"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",