release: DeckProbe 2.4.0 with the agent skill

Author: Garfield-yin

.claude-plugin/marketplace.json

@@ -0,0 +1,19 @@
+{
+  "name": "deckflow",
+  "owner": {
+    "name": "DeckFlow",
+    "url": "https://github.com/deckflow"
+  },
+  "description": "DeckProbe document-inspection tooling",
+  "plugins": [
+    {
+      "name": "deckprobe",
+      "source": "./",
+      "description": "Inspect PDF, Microsoft Office, and Apple iWork documents with bounded, deterministic probes.",
+      "homepage": "https://github.com/deckflow/deckprobe",
+      "repository": "https://github.com/deckflow/deckprobe",
+      "license": "MIT",
+      "keywords": ["pdf", "office", "iwork", "metadata", "document-inspection"]
+    }
+  ]
+}

.claude-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "deckprobe",
+  "displayName": "DeckProbe",
+  "description": "Inspect PDF, Microsoft Office, and Apple iWork documents with bounded, deterministic probes.",
+  "author": {
+    "name": "DeckFlow",
+    "url": "https://github.com/deckflow"
+  },
+  "homepage": "https://github.com/deckflow/deckprobe",
+  "repository": "https://github.com/deckflow/deckprobe",
+  "license": "MIT",
+  "keywords": ["pdf", "office", "iwork", "metadata", "document-inspection"]
+}

.github/workflows/ci.yml

@@ -53,9 +53,13 @@ jobs:
       - name: Install Chromium
         working-directory: packages/deckprobe-js
         run: npx playwright install --with-deps chromium
+      # test:public omits test:node and test:cli, which read tests/fixtures/local.
+      # That tree is private and promote-release.sh removes it from this
+      # repository, so `npm test` can never pass here. Both suites still run
+      # against the development tree, where the fixtures exist.
       - name: Run contract, bundler, and CLI parity tests
         working-directory: packages/deckprobe-js
-        run: npm test
+        run: npm run test:public
       - name: Audit JavaScript dependencies
         working-directory: packages/deckprobe-js
         run: npm audit --audit-level=high

CHANGELOG.md

@@ -4,6 +4,29 @@ All notable changes to DeckProbe are documented here.
 
 ## [Unreleased]
 
+## [2.4.0] - 2026-08-19
+
+### Added
+
+- DeckProbe ships an Agent Skill at `skills/deckprobe/`, teaching coding agents
+  the target vocabulary, the report contract, and exit-status handling, with
+  progressive-disclosure references for targets, recipes, output, and limits.
+- New `deckprobe install` subcommand writes support files into conventional local
+  directories and reports one JSON receipt. `--skills` (the default artifact set)
+  installs the agent skill for `--agent`-selected agents or an explicit `--dir`;
+  `--man` and `--completions` install the generated manual pages and shell
+  completion source. Every artifact shares the same idempotent
+  created/updated/unchanged policy, `--force` gate, and `--dry-run`.
+- `.claude-plugin/` manifests publish the repository as a single-plugin Claude
+  Code marketplace, so `/plugin marketplace add deckflow/deckprobe` works
+  alongside `npx skills add deckflow/deckprobe`. All three install routes deliver
+  identical bytes, verified by a contract test.
+
+### Changed
+
+- The subcommand section of `deckprobe --help` is now headed `Commands` rather
+  than `Discovery commands`, because `install` is not a discovery command.
+
 ## [2.3.1] - 2026-08-11
 
 ### Fixed

Cargo.lock

@@ -15,7 +15,7 @@ members = [
 resolver = "2"
 
 [workspace.package]
-version = "2.3.1"
+version = "2.4.0"
 edition = "2024"
 license = "MIT"
 repository = "https://github.com/deckflow/deckprobe"

Cargo.toml

@@ -10,7 +10,7 @@ Ask for the facts you need. Get structured JSON with confidence, evidence, and m
 [![License: MIT](https://img.shields.io/badge/license-MIT-2f80ed.svg)](LICENSE)
 [![Rust 1.88+](https://img.shields.io/badge/rust-1.88%2B-orange.svg)](https://www.rust-lang.org/)
 
-[Install](docs/INSTALLATION.md) · [Quickstart](#quickstart) · [npm package](#javascript-package) · [Execution modes](#execution-modes) · [Examples](#common-recipes) · [Formats](#supported-formats) · [CLI reference](docs/CLI-REFERENCE.md)
+[Install](docs/INSTALLATION.md) · [Quickstart](#quickstart) · [Agent skill](#use-from-a-coding-agent) · [npm package](#javascript-package) · [Execution modes](#execution-modes) · [Examples](#common-recipes) · [Formats](#supported-formats) · [CLI reference](docs/CLI-REFERENCE.md)
 
 </div>
 
@@ -171,6 +171,41 @@ printf '%s\n' \
   '{"path":"deck.pptx"}' | deckprobe --jsonl -t @summary
 ```
 
+## Use from a coding agent
+
+DeckProbe ships an [Agent Skill](https://agentskills.io) that teaches an agent the
+target vocabulary, the report contract, and the exit-status handling, so it stops
+guessing flags and stops falling back to unzipping documents by hand.
+
+If you already have the CLI, install the skill for whichever agents this project
+uses:
+
+```sh
+deckprobe install --skills                     # every agent present in this project
+deckprobe install --skills --agent claude -g   # ~/.claude/skills/deckprobe/
+deckprobe install --skills --dry-run --pretty  # preview first
+```
+
+If you do not, install it straight from this repository:
+
+```sh
+npx skills add deckflow/deckprobe
+```
+
+Claude Code users can instead take it as a plugin:
+
+```
+/plugin marketplace add deckflow/deckprobe
+/plugin install deckprobe@deckflow
+```
+
+All three deliver the same bytes from [`skills/deckprobe/`](skills/deckprobe/).
+Note that `npx skills add` and the plugin install the instructions only — the
+skill's first step checks for the CLI and falls back to `npx -y @deckflow/deckprobe`
+when it is missing. See
+[Installing agent assets](docs/CLI-REFERENCE.md#installing-agent-assets) for the
+agent/directory table and the overwrite policy.
+
 ## JavaScript package
 
 The independently published `@deckflow/deckprobe` package ships the `deckprobe`