[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M780ZC1MRTA09PWHNVBD3TWT":3,"skill-same:01M780ZC1MRTA09PWHNVBD3TWT":65},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":16,"sourceHtmlUrl":17,"categories":18,"keywords":19,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":23,"frontMatter":24,"refName":34,"commitSha":35,"skillDirectory":36,"forksCount":37,"repositoryHtmlUrl":38,"repositoryHomepageUrl":6,"ownerHtmlUrl":39,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":40,"install":41,"resources":54},"01M780ZC1MRTA09PWHNVBD3TWT","printing-press-score",null,"Score a generated CLI against the Steinberger bar, compare two CLIs side-by-side","filippolmt\u002Fskills","filippolmt","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F61194571?v=4","01M7808VK1A8QF8ZXGT2DWTKHS","Filippo Merante Caparrotta","01M7808VKN74HC3EZMK8EV35KS",1,"MIT","https:\u002F\u002Fgithub.com\u002Ffilippolmt\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fplugins\u002Fpackages\u002Fprinting-press-bundle\u002Fskills\u002Fprinting-press-score\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Ffilippolmt\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fplugins\u002Fpackages\u002Fprinting-press-bundle\u002Fskills\u002Fprinting-press-score\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: printing-press-score\ndescription: Score a generated CLI against the Steinberger bar, compare two CLIs side-by-side\nversion: 0.1.0\nmin-binary-version: \"4.0.0\"\nallowed-tools:\n  - Bash\n  - Read\n  - Glob\n  - Grep\n  - AskUserQuestion\ncreated_by: user\n---\n\n# \u002Fprinting-press-score\n\nScore generated CLIs against the Steinberger bar. Supports rescoring, scoring by name\u002Fpath, and comparing two CLIs.\n\n## Quick Start\n\n```\n\u002Fprinting-press-score                              # rescore current CLI\n\u002Fprinting-press-score notion-pp-cli-4              # score by name\n\u002Fprinting-press-score ~\u002Fmy-cli                     # score by path\n\u002Fprinting-press-score notion-pp-cli-4 vs notion-pp-cli-2  # compare two\n```\n\n## Prerequisites\n\n- Go 1.26.11 or newer installed\n- `cli-printing-press` binary on PATH (install with `go install github.com\u002Fmvanhorn\u002Fcli-printing-press\u002Fv4\u002Fcmd\u002Fcli-printing-press@latest`)\n\n## Step 0: Setup\n\nBefore any other commands, run the setup contract to verify the cli-printing-press binary is on PATH and initialize scope variables:\n\n\u003C!-- PRESS_SETUP_CONTRACT_START -->\n```bash\n# min-binary-version: 4.0.0\n\n# Derive scope first — needed for local build detection\n_scope_dir=\"$(git rev-parse --show-toplevel 2>\u002Fdev\u002Fnull || echo \"$PWD\")\"\n_scope_dir=\"$(cd \"$_scope_dir\" && pwd -P)\"\n\n# Prefer local build when running from inside the printing-press repo.\n_press_repo=false\nif [ -x \"$_scope_dir\u002Fcli-printing-press\" ] && [ -d \"$_scope_dir\u002Fcmd\u002Fcli-printing-press\" ]; then\n  _press_repo=true\n  export PATH=\"$_scope_dir:$PATH\"\n  echo \"Using local build: $_scope_dir\u002Fcli-printing-press\"\nelif ! command -v cli-printing-press >\u002Fdev\u002Fnull 2>&1; then\n  if [ -x \"$HOME\u002Fgo\u002Fbin\u002Fcli-printing-press\" ]; then\n    echo \"cli-printing-press found at ~\u002Fgo\u002Fbin\u002Fcli-printing-press but not on PATH.\"\n    echo \"Add GOPATH\u002Fbin to your PATH:  export PATH=\\\"\\$HOME\u002Fgo\u002Fbin:\\$PATH\\\"\"\n  else\n    echo \"cli-printing-press binary not found.\"\n    echo \"Install with:  go install github.com\u002Fmvanhorn\u002Fcli-printing-press\u002Fv4\u002Fcmd\u002Fcli-printing-press@latest\"\n  fi\n  return 1 2>\u002Fdev\u002Fnull || exit 1\nfi\n\n# Resolve and emit the absolute path the agent must use for every later\n# `cli-printing-press` invocation. `export PATH` above only affects this one\n# Bash tool call; subsequent calls open a fresh shell and resolve bare\n# `cli-printing-press` against the user's default PATH, where a stale global\n# can silently shadow the local build. The agent captures this marker and\n# substitutes the absolute path into every later invocation.\nif [ \"$_press_repo\" = \"true\" ]; then\n  PRINTING_PRESS_BIN=\"$_scope_dir\u002Fcli-printing-press\"\nelse\n  PRINTING_PRESS_BIN=\"$(command -v cli-printing-press 2>\u002Fdev\u002Fnull || true)\"\nfi\necho \"PRINTING_PRESS_BIN=$PRINTING_PRESS_BIN\"\n\nPRESS_BASE=\"$(basename \"$_scope_dir\" | tr '[:upper:]' '[:lower:]' | sed -E 's\u002F[^a-z0-9_-]\u002F-\u002Fg; s\u002F^-+\u002F\u002F; s\u002F-+$\u002F\u002F')\"\nif [ -z \"$PRESS_BASE\" ]; then\n  PRESS_BASE=\"workspace\"\nfi\n\nPRESS_SCOPE=\"$PRESS_BASE-$(printf '%s' \"$_scope_dir\" | shasum -a 256 | cut -c1-8)\"\nPRESS_HOME=\"${PRINTING_PRESS_HOME:-$HOME\u002Fprinting-press}\"\nPRESS_RUNSTATE=\"$PRESS_HOME\u002F.runstate\u002F$PRESS_SCOPE\"\nPRESS_LIBRARY=\"$PRESS_HOME\u002Flibrary\"\nPRESS_MANUSCRIPTS=\"$PRESS_HOME\u002Fmanuscripts\"\nPRESS_CURRENT=\"$PRESS_RUNSTATE\u002Fcurrent\"\n\nmkdir -p \"$PRESS_RUNSTATE\" \"$PRESS_LIBRARY\" \"$PRESS_MANUSCRIPTS\" \"$PRESS_CURRENT\"\n```\n\u003C!-- PRESS_SETUP_CONTRACT_END -->\n\nAfter running the setup contract, capture the `PRINTING_PRESS_BIN=\u003Cabs-path>` line from stdout. **Every subsequent `cli-printing-press ...` invocation in this skill must use that absolute path** (substitute the value, not the literal `$PRINTING_PRESS_BIN` token) — `export PATH` above only affects the single Bash tool call it runs in, so later calls open a fresh shell where bare `cli-printing-press` resolves against the user's default `PATH` and a stale global can shadow the local build.\n\nAfter capturing the binary path, check binary version compatibility. Read the `min-binary-version` field from this skill's YAML frontmatter. Run `\u003CPRINTING_PRESS_BIN> version --json` and parse the version from the output. Compare it to `min-binary-version` using semver rules. If the installed binary is older than the minimum, stop immediately and tell the user: \"cli-printing-press binary vX.Y.Z is older than the minimum required vA.B.C. Run `go install github.com\u002Fmvanhorn\u002Fcli-printing-press\u002Fv4\u002Fcmd\u002Fcli-printing-press@latest` to update.\"\n\nCurrent-run state is resolved from `$PRESS_RUNSTATE`. Published CLIs are resolved from `$PRESS_LIBRARY`. Archived manuscripts are resolved from `$PRESS_MANUSCRIPTS`.\n\n## Step 1: Parse Arguments\n\nRead the user's input after `\u002Fprinting-press-score`. The input is **free-form** — interpret intent, don't enforce syntax.\n\n**Noise words to strip:** `compare`, `vs`, `versus`, `and`, `against`, `with`, `to`\n\nAfter stripping noise words, count the remaining tokens:\n\n- **0 tokens** → Rescore Current mode\n- **1 token** → Score Single mode\n- **2 tokens** → Compare mode\n\n## Step 2: Resolve CLI Directories\n\nFor each CLI identifier, resolve it to a directory path:\n\n### If the token contains `\u002F` or `.`\nTreat it as a path (absolute or relative). Verify the directory exists.\n\n### If the token is a plain name\nTry these locations in order:\n1. `$PRESS_LIBRARY\u002F\u003Cname>\u002F` — exact match\n2. `$PRESS_LIBRARY\u002F\u003Cname>-pp-cli\u002F` — with -pp-cli suffix\n3. If neither exists, Glob `$PRESS_LIBRARY\u002F\u003Cname>-pp-cli*`\n4. If exactly one glob match exists and is a directory, use it\n5. If multiple glob matches exist, present a numbered menu using AskUserQuestion\n\nIf neither exists, scan current-run and archived state:\n6. Use Glob to find `$PRESS_RUNSTATE\u002Fruns\u002F*\u002Fstate.json` files\n7. Read each, look for an `output_dir` or `working_dir` value whose basename contains the name\n8. If found and the directory exists, use it\n\nIf nothing resolves, report the error: \"Could not find CLI '\u003Cname>'. Provide a path or check the name.\"\n\n### Rescore Current (0 tokens)\n1. Use Glob to find all `$PRESS_CURRENT\u002F*.json` files\n2. Read each to get `api_name`, `state_path`, and `working_dir`\n3. Filter to those whose `working_dir` actually exists on disk\n4. If none are found, Glob `$PRESS_LIBRARY\u002F*-pp-cli*` and use those directories instead\n5. If exactly one → use it automatically\n6. If multiple → present a numbered menu using AskUserQuestion:\n   ```\n   Multiple CLIs found. Which one to score?\n   1. stripe-pp-cli ($PRESS_LIBRARY\u002Fstripe-pp-cli)\n   2. notion-pp-cli ($PRESS_LIBRARY\u002Fnotion-pp-cli)\n   3. linear-pp-cli ($PRESS_LIBRARY\u002Flinear-pp-cli)\n   ```\n7. If none found → report: \"No generated CLIs found. Provide a name or path.\"\n\n## Step 3: Find Spec for Tier 2 Scoring\n\nFor each resolved CLI directory, find the OpenAPI spec:\n\n1. Check `\u003Ccli-dir>\u002Fspec.json` — the pipeline converts YAML specs to JSON during generation\n2. If not found, scan `$PRESS_RUNSTATE\u002Fruns\u002F*\u002Fstate.json` files for one matching this CLI's directory. Read its `spec_path` field. If that file exists on disk, use it.\n3. If no spec found, **proceed without `--spec`**. Note to the user: \"No spec found — spec-derived dimensions will be marked N\u002FA and omitted from the denominator. Provide a spec path for full scoring.\"\n\n## Step 4: Run Scorecard\n\n### Single Score Mode\n\nRun the scorecard command:\n\n```bash\ncli-printing-press scorecard --dir \u003Cresolved-path> --json\n```\n\nIf a spec was found, add `--spec \u003Cspec-path>`.\n\nParse the JSON output. The structure is:\n\n```json\n{\n  \"api_name\": \"...\",\n  \"steinberger\": {\n    \"output_modes\": 8,\n    \"auth\": 7,\n    \"error_handling\": 6,\n    \"terminal_ux\": 9,\n    \"readme\": 5,\n    \"doctor\": 10,\n    \"agent_native\": 7,\n    \"local_cache\": 4,\n    \"breadth\": 7,\n    \"vision\": 6,\n    \"workflows\": 3,\n    \"insight\": 5,\n    \"path_validity\": 0,\n    \"auth_protocol\": 0,\n    \"data_pipeline_integrity\": 7,\n    \"sync_correctness\": 6,\n    \"type_fidelity\": 4,\n    \"dead_code\": 3,\n    \"total\": 72,\n    \"percentage\": 72\n  },\n  \"overall_grade\": \"B\",\n  \"gap_report\": [\"...\"],\n  \"unscored_dimensions\": [\"path_validity\", \"auth_protocol\"]\n}\n```\n\nIf `unscored_dimensions` is present, those dimensions should be rendered as `N\u002FA`, not `0\u002Fx`, and should be described as omitted from the denominator rather than as fixable CLI defects. For backward compatibility, JSON still encodes the numeric fields as `0`; consumers must use `unscored_dimensions` to distinguish `N\u002FA` from a real zero.\n\n`--write-manifest` does not change the score. A `verify` object already stored in `\u003Ccli-dir>\u002F.printing-press.json` is scoring evidence for every invocation, including a bare `scorecard --dir`. Human output prints `Denominator: infrastructure N, domain M` beside the total. JSON reports the same exclusion through `unscored_dimensions`, and any verify floor through `steinberger.calibration_note`. `path_validity` and `auth_protocol` stay unverified, and the domain denominator changes, only when neither an embedded `\u003Ccli-dir>\u002Fspec.json` nor `--spec` supplies the evidence. When `spec.json` is present, scorecard uses that file before `--spec`.\n\nLearn-loop credit is static-behavioral, never presence-based: the scorecard credits `teach`\u002F`recall`\u002F`learnings` registration on the root command and non-empty entity lookup seeds (or the spec's recorded no-entities escape). The learn loop is default-on, so `internal\u002Flearn\u002F` existing earns nothing; when explaining a learn gap, point at missing seeds or unregistered commands, not missing files. Execution proof (verify matrix, `learnings stats`) belongs to verify and dogfood; the scorecard runs no binaries.\n\n### Compare Mode\n\nRun **both** scorecard commands in **parallel** using two simultaneous Bash tool calls:\n\n```bash\n# Call 1:\ncli-printing-press scorecard --dir \u003Cpath1> --spec \u003Cspec1> --json\n\n# Call 2:\ncli-printing-press scorecard --dir \u003Cpath2> --spec \u003Cspec2> --json\n```\n\nParse both JSON outputs.\n\n## Step 5: Render Output\n\n### Single Score Table\n\nRender a rich markdown table. Note: Tier 1 dimensions are all \u002F10. Tier 2 dimensions are \u002F10 except TypeFidelity and DeadCode which are \u002F5.\n\n```\nScorecard: \u003Capi_name>\n\nInfrastructure (Tier 1)\n| Dimension      | Score |\n|----------------|-------|\n| Output Modes   | 8\u002F10  |\n| Auth           | 7\u002F10  |\n| Error Handling | 6\u002F10  |\n| Terminal UX    | 9\u002F10  |\n| README         | 5\u002F10  |\n| Doctor         | 10\u002F10 |\n| Agent Native   | 7\u002F10  |\n| Local Cache    | 4\u002F10  |\n| Breadth        | 7\u002F10  |\n| Vision         | 6\u002F10  |\n| Workflows      | 3\u002F10  |\n| Insight        | 5\u002F10  |\n\nDomain Correctness (Tier 2)\n| Dimension               | Score |\n|--------------------------|-------|\n| Path Validity            | 9\u002F10  |\n| Auth Protocol            | 8\u002F10  |\n| Data Pipeline Integrity  | 7\u002F10  |\n| Sync Correctness         | 6\u002F10  |\n| Type Fidelity            | 4\u002F5   |\n| Dead Code                | 3\u002F5   |\n\n**Total: 72\u002F100 — Grade B**\n```\n\nIf `gap_report` is non-empty, list the gaps:\n\n```\nGaps:\n- \u003Cgap 1>\n- \u003Cgap 2>\n```\n\nIf `unscored_dimensions` is non-empty, add a note after the table:\n\n```\nNote: path_validity, auth_protocol were unscored and omitted from the denominator. Provide a spec path for full scoring.\n```\n\n### Compare Table\n\nRender a side-by-side table with a delta column. Show the first CLI name and second CLI name as column headers. Calculate delta as (CLI 1 score - CLI 2 score). Show `+N` for positive, `-N` for negative, `—` for zero.\n\n```\nScorecard Comparison: \u003Cname1> vs \u003Cname2>\n\nInfrastructure (Tier 1)\n| Dimension      | \u003Cname1> | \u003Cname2> | Delta |\n|----------------|---------|---------|-------|\n| Output Modes   | 8\u002F10    | 5\u002F10    | +3    |\n| Auth           | 7\u002F10    | 7\u002F10    | —     |\n| ...            |         |         |       |\n\nDomain Correctness (Tier 2)\n| Dimension               | \u003Cname1> | \u003Cname2> | Delta |\n|--------------------------|---------|---------|-------|\n| Path Validity            | 9\u002F10    | 6\u002F10    | +3    |\n| ...                      |         |         |       |\n\n| **Total**  | **72\u002F100 (B)** | **56\u002F100 (C)** | **+16** |\n```\n\n## Error Handling\n\n- If the cli-printing-press binary is not on PATH → show install instructions: `go install github.com\u002Fmvanhorn\u002Fcli-printing-press\u002Fv4\u002Fcmd\u002Fcli-printing-press@latest`\n- If the scorecard command fails → report the error with the full stderr output\n- If a CLI directory doesn't exist → report which name couldn't be resolved\n- If JSON parsing fails → show the raw output and report the parsing error\n","# \u002Fprinting-press-score\n\nScore generated CLIs against the Steinberger bar. Supports rescoring, scoring by name\u002Fpath, and comparing two CLIs.\n\n## Quick Start\n\n```\n\u002Fprinting-press-score                              # rescore current CLI\n\u002Fprinting-press-score notion-pp-cli-4              # score by name\n\u002Fprinting-press-score ~\u002Fmy-cli                     # score by path\n\u002Fprinting-press-score notion-pp-cli-4 vs notion-pp-cli-2  # compare two\n```\n\n## Prerequisites\n\n- Go 1.26.11 or newer installed\n- `cli-printing-press` binary on PATH (install with `go install github.com\u002Fmvanhorn\u002Fcli-printing-press\u002Fv4\u002Fcmd\u002Fcli-printing-press@latest`)\n\n## Step 0: Setup\n\nBefore any other commands, run the setup contract to verify the cli-printing-press binary is on PATH and initialize scope variables:\n\n\u003C!-- PRESS_SETUP_CONTRACT_START -->\n```bash\n# min-binary-version: 4.0.0\n\n# Derive scope first — needed for local build detection\n_scope_dir=\"$(git rev-parse --show-toplevel 2>\u002Fdev\u002Fnull || echo \"$PWD\")\"\n_scope_dir=\"$(cd \"$_scope_dir\" && pwd -P)\"\n\n# Prefer local build when running from inside the printing-press repo.\n_press_repo=false\nif [ -x \"$_scope_dir\u002Fcli-printing-press\" ] && [ -d \"$_scope_dir\u002Fcmd\u002Fcli-printing-press\" ]; then\n  _press_repo=true\n  export PATH=\"$_scope_dir:$PATH\"\n  echo \"Using local build: $_scope_dir\u002Fcli-printing-press\"\nelif ! command -v cli-printing-press >\u002Fdev\u002Fnull 2>&1; then\n  if [ -x \"$HOME\u002Fgo\u002Fbin\u002Fcli-printing-press\" ]; then\n    echo \"cli-printing-press found at ~\u002Fgo\u002Fbin\u002Fcli-printing-press but not on PATH.\"\n    echo \"Add GOPATH\u002Fbin to your PATH:  export PATH=\\\"\\$HOME\u002Fgo\u002Fbin:\\$PATH\\\"\"\n  else\n    echo \"cli-printing-press binary not found.\"\n    echo \"Install with:  go install github.com\u002Fmvanhorn\u002Fcli-printing-press\u002Fv4\u002Fcmd\u002Fcli-printing-press@latest\"\n  fi\n  return 1 2>\u002Fdev\u002Fnull || exit 1\nfi\n\n# Resolve and emit the absolute path the agent must use for every later\n# `cli-printing-press` invocation. `export PATH` above only affects this one\n# Bash tool call; subsequent calls open a fresh shell and resolve bare\n# `cli-printing-press` against the user's default PATH, where a stale global\n# can silently shadow the local build. The agent captures this marker and\n# substitutes the absolute path into every later invocation.\nif [ \"$_press_repo\" = \"true\" ]; then\n  PRINTING_PRESS_BIN=\"$_scope_dir\u002Fcli-printing-press\"\nelse\n  PRINTING_PRESS_BIN=\"$(command -v cli-printing-press 2>\u002Fdev\u002Fnull || true)\"\nfi\necho \"PRINTING_PRESS_BIN=$PRINTING_PRESS_BIN\"\n\nPRESS_BASE=\"$(basename \"$_scope_dir\" | tr '[:upper:]' '[:lower:]' | sed -E 's\u002F[^a-z0-9_-]\u002F-\u002Fg; s\u002F^-+\u002F\u002F; s\u002F-+$\u002F\u002F')\"\nif [ -z \"$PRESS_BASE\" ]; then\n  PRESS_BASE=\"workspace\"\nfi\n\nPRESS_SCOPE=\"$PRESS_BASE-$(printf '%s' \"$_scope_dir\" | shasum -a 256 | cut -c1-8)\"\nPRESS_HOME=\"${PRINTING_PRESS_HOME:-$HOME\u002Fprinting-press}\"\nPRESS_RUNSTATE=\"$PRESS_HOME\u002F.runstate\u002F$PRESS_SCOPE\"\nPRESS_LIBRARY=\"$PRESS_HOME\u002Flibrary\"\nPRESS_MANUSCRIPTS=\"$PRESS_HOME\u002Fmanuscripts\"\nPRESS_CURRENT=\"$PRESS_RUNSTATE\u002Fcurrent\"\n\nmkdir -p \"$PRESS_RUNSTATE\" \"$PRESS_LIBRARY\" \"$PRESS_MANUSCRIPTS\" \"$PRESS_CURRENT\"\n```\n\u003C!-- PRESS_SETUP_CONTRACT_END -->\n\nAfter running the setup contract, capture the `PRINTING_PRESS_BIN=\u003Cabs-path>` line from stdout. **Every subsequent `cli-printing-press ...` invocation in this skill must use that absolute path** (substitute the value, not the literal `$PRINTING_PRESS_BIN` token) — `export PATH` above only affects the single Bash tool call it runs in, so later calls open a fresh shell where bare `cli-printing-press` resolves against the user's default `PATH` and a stale global can shadow the local build.\n\nAfter capturing the binary path, check binary version compatibility. Read the `min-binary-version` field from this skill's YAML frontmatter. Run `\u003CPRINTING_PRESS_BIN> version --json` and parse the version from the output. Compare it to `min-binary-version` using semver rules. If the installed binary is older than the minimum, stop immediately and tell the user: \"cli-printing-press binary vX.Y.Z is older than the minimum required vA.B.C. Run `go install github.com\u002Fmvanhorn\u002Fcli-printing-press\u002Fv4\u002Fcmd\u002Fcli-printing-press@latest` to update.\"\n\nCurrent-run state is resolved from `$PRESS_RUNSTATE`. Published CLIs are resolved from `$PRESS_LIBRARY`. Archived manuscripts are resolved from `$PRESS_MANUSCRIPTS`.\n\n## Step 1: Parse Arguments\n\nRead the user's input after `\u002Fprinting-press-score`. The input is **free-form** — interpret intent, don't enforce syntax.\n\n**Noise words to strip:** `compare`, `vs`, `versus`, `and`, `against`, `with`, `to`\n\nAfter stripping noise words, count the remaining tokens:\n\n- **0 tokens** → Rescore Current mode\n- **1 token** → Score Single mode\n- **2 tokens** → Compare mode\n\n## Step 2: Resolve CLI Directories\n\nFor each CLI identifier, resolve it to a directory path:\n\n### If the token contains `\u002F` or `.`\nTreat it as a path (absolute or relative). Verify the directory exists.\n\n### If the token is a plain name\nTry these locations in order:\n1. `$PRESS_LIBRARY\u002F\u003Cname>\u002F` — exact match\n2. `$PRESS_LIBRARY\u002F\u003Cname>-pp-cli\u002F` — with -pp-cli suffix\n3. If neither exists, Glob `$PRESS_LIBRARY\u002F\u003Cname>-pp-cli*`\n4. If exactly one glob match exists and is a directory, use it\n5. If multiple glob matches exist, present a numbered menu using AskUserQuestion\n\nIf neither exists, scan current-run and archived state:\n6. Use Glob to find `$PRESS_RUNSTATE\u002Fruns\u002F*\u002Fstate.json` files\n7. Read each, look for an `output_dir` or `working_dir` value whose basename contains the name\n8. If found and the directory exists, use it\n\nIf nothing resolves, report the error: \"Could not find CLI '\u003Cname>'. Provide a path or check the name.\"\n\n### Rescore Current (0 tokens)\n1. Use Glob to find all `$PRESS_CURRENT\u002F*.json` files\n2. Read each to get `api_name`, `state_path`, and `working_dir`\n3. Filter to those whose `working_dir` actually exists on disk\n4. If none are found, Glob `$PRESS_LIBRARY\u002F*-pp-cli*` and use those directories instead\n5. If exactly one → use it automatically\n6. If multiple → present a numbered menu using AskUserQuestion:\n   ```\n   Multiple CLIs found. Which one to score?\n   1. stripe-pp-cli ($PRESS_LIBRARY\u002Fstripe-pp-cli)\n   2. notion-pp-cli ($PRESS_LIBRARY\u002Fnotion-pp-cli)\n   3. linear-pp-cli ($PRESS_LIBRARY\u002Flinear-pp-cli)\n   ```\n7. If none found → report: \"No generated CLIs found. Provide a name or path.\"\n\n## Step 3: Find Spec for Tier 2 Scoring\n\nFor each resolved CLI directory, find the OpenAPI spec:\n\n1. Check `\u003Ccli-dir>\u002Fspec.json` — the pipeline converts YAML specs to JSON during generation\n2. If not found, scan `$PRESS_RUNSTATE\u002Fruns\u002F*\u002Fstate.json` files for one matching this CLI's directory. Read its `spec_path` field. If that file exists on disk, use it.\n3. If no spec found, **proceed without `--spec`**. Note to the user: \"No spec found — spec-derived dimensions will be marked N\u002FA and omitted from the denominator. Provide a spec path for full scoring.\"\n\n## Step 4: Run Scorecard\n\n### Single Score Mode\n\nRun the scorecard command:\n\n```bash\ncli-printing-press scorecard --dir \u003Cresolved-path> --json\n```\n\nIf a spec was found, add `--spec \u003Cspec-path>`.\n\nParse the JSON output. The structure is:\n\n```json\n{\n  \"api_name\": \"...\",\n  \"steinberger\": {\n    \"output_modes\": 8,\n    \"auth\": 7,\n    \"error_handling\": 6,\n    \"terminal_ux\": 9,\n    \"readme\": 5,\n    \"doctor\": 10,\n    \"agent_native\": 7,\n    \"local_cache\": 4,\n    \"breadth\": 7,\n    \"vision\": 6,\n    \"workflows\": 3,\n    \"insight\": 5,\n    \"path_validity\": 0,\n    \"auth_protocol\": 0,\n    \"data_pipeline_integrity\": 7,\n    \"sync_correctness\": 6,\n    \"type_fidelity\": 4,\n    \"dead_code\": 3,\n    \"total\": 72,\n    \"percentage\": 72\n  },\n  \"overall_grade\": \"B\",\n  \"gap_report\": [\"...\"],\n  \"unscored_dimensions\": [\"path_validity\", \"auth_protocol\"]\n}\n```\n\nIf `unscored_dimensions` is present, those dimensions should be rendered as `N\u002FA`, not `0\u002Fx`, and should be described as omitted from the denominator rather than as fixable CLI defects. For backward compatibility, JSON still encodes the numeric fields as `0`; consumers must use `unscored_dimensions` to distinguish `N\u002FA` from a real zero.\n\n`--write-manifest` does not change the score. A `verify` object already stored in `\u003Ccli-dir>\u002F.printing-press.json` is scoring evidence for every invocation, including a bare `scorecard --dir`. Human output prints `Denominator: infrastructure N, domain M` beside the total. JSON reports the same exclusion through `unscored_dimensions`, and any verify floor through `steinberger.calibration_note`. `path_validity` and `auth_protocol` stay unverified, and the domain denominator changes, only when neither an embedded `\u003Ccli-dir>\u002Fspec.json` nor `--spec` supplies the evidence. When `spec.json` is present, scorecard uses that file before `--spec`.\n\nLearn-loop credit is static-behavioral, never presence-based: the scorecard credits `teach`\u002F`recall`\u002F`learnings` registration on the root command and non-empty entity lookup seeds (or the spec's recorded no-entities escape). The learn loop is default-on, so `internal\u002Flearn\u002F` existing earns nothing; when explaining a learn gap, point at missing seeds or unregistered commands, not missing files. Execution proof (verify matrix, `learnings stats`) belongs to verify and dogfood; the scorecard runs no binaries.\n\n### Compare Mode\n\nRun **both** scorecard commands in **parallel** using two simultaneous Bash tool calls:\n\n```bash\n# Call 1:\ncli-printing-press scorecard --dir \u003Cpath1> --spec \u003Cspec1> --json\n\n# Call 2:\ncli-printing-press scorecard --dir \u003Cpath2> --spec \u003Cspec2> --json\n```\n\nParse both JSON outputs.\n\n## Step 5: Render Output\n\n### Single Score Table\n\nRender a rich markdown table. Note: Tier 1 dimensions are all \u002F10. Tier 2 dimensions are \u002F10 except TypeFidelity and DeadCode which are \u002F5.\n\n```\nScorecard: \u003Capi_name>\n\nInfrastructure (Tier 1)\n| Dimension      | Score |\n|----------------|-------|\n| Output Modes   | 8\u002F10  |\n| Auth           | 7\u002F10  |\n| Error Handling | 6\u002F10  |\n| Terminal UX    | 9\u002F10  |\n| README         | 5\u002F10  |\n| Doctor         | 10\u002F10 |\n| Agent Native   | 7\u002F10  |\n| Local Cache    | 4\u002F10  |\n| Breadth        | 7\u002F10  |\n| Vision         | 6\u002F10  |\n| Workflows      | 3\u002F10  |\n| Insight        | 5\u002F10  |\n\nDomain Correctness (Tier 2)\n| Dimension               | Score |\n|--------------------------|-------|\n| Path Validity            | 9\u002F10  |\n| Auth Protocol            | 8\u002F10  |\n| Data Pipeline Integrity  | 7\u002F10  |\n| Sync Correctness         | 6\u002F10  |\n| Type Fidelity            | 4\u002F5   |\n| Dead Code                | 3\u002F5   |\n\n**Total: 72\u002F100 — Grade B**\n```\n\nIf `gap_report` is non-empty, list the gaps:\n\n```\nGaps:\n- \u003Cgap 1>\n- \u003Cgap 2>\n```\n\nIf `unscored_dimensions` is non-empty, add a note after the table:\n\n```\nNote: path_validity, auth_protocol were unscored and omitted from the denominator. Provide a spec path for full scoring.\n```\n\n### Compare Table\n\nRender a side-by-side table with a delta column. Show the first CLI name and second CLI name as column headers. Calculate delta as (CLI 1 score - CLI 2 score). Show `+N` for positive, `-N` for negative, `—` for zero.\n\n```\nScorecard Comparison: \u003Cname1> vs \u003Cname2>\n\nInfrastructure (Tier 1)\n| Dimension      | \u003Cname1> | \u003Cname2> | Delta |\n|----------------|---------|---------|-------|\n| Output Modes   | 8\u002F10    | 5\u002F10    | +3    |\n| Auth           | 7\u002F10    | 7\u002F10    | —     |\n| ...            |         |         |       |\n\nDomain Correctness (Tier 2)\n| Dimension               | \u003Cname1> | \u003Cname2> | Delta |\n|--------------------------|---------|---------|-------|\n| Path Validity            | 9\u002F10    | 6\u002F10    | +3    |\n| ...                      |         |         |       |\n\n| **Total**  | **72\u002F100 (B)** | **56\u002F100 (C)** | **+16** |\n```\n\n## Error Handling\n\n- If the cli-printing-press binary is not on PATH → show install instructions: `go install github.com\u002Fmvanhorn\u002Fcli-printing-press\u002Fv4\u002Fcmd\u002Fcli-printing-press@latest`\n- If the scorecard command fails → report the error with the full stderr output\n- If a CLI directory doesn't exist → report which name couldn't be resolved\n- If JSON parsing fails → show the raw output and report the parsing error\n",{"name":5,"version":25,"created_by":26,"description":7,"allowed-tools":27,"min-binary-version":33},"0.1.0","user",[28,29,30,31,32],"Bash","Read","Glob","Grep","AskUserQuestion","4.0.0","main","063c0fc3ecc69b02c1ff355a130a3cb53a4bd8e6",".agents\u002Fplugins\u002Fpackages\u002Fprinting-press-bundle\u002Fskills\u002Fprinting-press-score",0,"https:\u002F\u002Fgithub.com\u002Ffilippolmt\u002Fskills","https:\u002F\u002Fgithub.com\u002Ffilippolmt","2026-11-14 22:46:00",{"source":8,"skillName":5,"commands":42,"prompt":52,"zipAvailable":53},[43,46,49],{"tool":44,"command":45},"npx","npx skills add filippolmt\u002Fskills --skill printing-press-score",{"tool":47,"command":48},"bunx","bunx skills add filippolmt\u002Fskills --skill printing-press-score",{"tool":50,"command":51},"pnpm","pnpm dlx skills add filippolmt\u002Fskills --skill printing-press-score","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Ffilippolmt\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fplugins\u002Fpackages\u002Fprinting-press-bundle\u002Fskills\u002Fprinting-press-score\u002FSKILL.md",true,[55,59],{"path":56,"resourceType":56,"resourceTypeDesc":57,"sizeBytes":58,"sourceHtmlUrl":16},"LICENSE","许可证",1086,{"path":60,"resourceType":61,"resourceTypeDesc":62,"sizeBytes":63,"sourceHtmlUrl":64},"SOURCE.md","REFERENCE","参考文档",422,"https:\u002F\u002Fgithub.com\u002Ffilippolmt\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fplugins\u002Fpackages\u002Fprinting-press-bundle\u002Fskills\u002Fprinting-press-score\u002FSOURCE.md",[66,74,83,91,99,107],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":70,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":20},"01M781ZJN9KDK0YY8EAQ8WXPRQ","writing-for-agents","Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.","https:\u002F\u002Fgithub.com\u002Ffilippolmt\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-for-agents\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Ffilippolmt\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":78,"licenseFileUrl":79,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":20},"01M781ZDZ8CQ30GRY5XNT1RF91","wrangler","Run or troubleshoot Wrangler CLI commands in projects that have a wrangler.jsonc, wrangler.json, or wrangler.toml file, including local development, Previews, deployment, and resource management. For new projects and projects without a Wrangler configuration file, use the cf CLI instead.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Ffilippolmt\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwrangler\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Ffilippolmt\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwrangler\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":78,"licenseFileUrl":87,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":20},"01M781ZA1MB7E7T1R1TE0BTTJS","workers-profiling","Profile or debug CPU usage and memory allocation in deployed Cloudflare Workers and Durable Objects. Then use this information to optimize your code.","https:\u002F\u002Fgithub.com\u002Ffilippolmt\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fworkers-profiling\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Ffilippolmt\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fworkers-profiling\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":78,"licenseFileUrl":95,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":20},"01M781Z52Q7PBMDA2YBC3SCTYM","workers-development","Run, inspect, and debug Cloudflare Workers during local development with cf dev, wrangler dev, or the Cloudflare Vite plugin, using Local Explorer to read and seed binding data and query local traces and logs. Also routes production debugging to Workers observability. Use for debugging requests whether or not the project uses Wrangler.","https:\u002F\u002Fgithub.com\u002Ffilippolmt\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fworkers-development\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Ffilippolmt\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fworkers-development\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":78,"licenseFileUrl":103,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":20},"01M781Z193MG7SHF4DSD1WK583","workers-best-practices","Cloudflare Workers best practices for production applications. Use when writing, reviewing, or configuring Workers.","https:\u002F\u002Fgithub.com\u002Ffilippolmt\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fworkers-best-practices\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Ffilippolmt\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fworkers-best-practices\u002FSKILL.md",[],[],{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":111,"sourceHtmlUrl":112,"categories":113,"keywords":114,"publishedAt":20},"01M781YT0JB3GVA1HTFZ9QJHM7","wordpress-pro","Develops custom WordPress themes and plugins, creates and registers Gutenberg blocks and block patterns, configures WooCommerce stores, implements WordPress REST API endpoints, applies security hardening (nonces, sanitization, escaping, capability checks), and optimizes performance through caching and query tuning. Use when building WordPress themes, writing plugins, customizing Gutenberg blocks, extending WooCommerce, working with ACF, using the WordPress REST API, applying hooks and filters, or improving WordPress performance and security.","https:\u002F\u002Fgithub.com\u002Ffilippolmt\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwordpress-pro\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Ffilippolmt\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwordpress-pro\u002FSKILL.md",[],[]]