docs: add README and changelog

Author: jdrhyne

CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## v0.1.0
+- Initial scaffold
+- CLI commands (setup, preflight, convert, benchmark, report, skills)
+- Design skill pack registry
+- Claude Code plugin manifest

README.md

@@ -1,8 +1,85 @@
 # dws-cli
 
-CLI name: `dws`
+DWS CLI for the Nutrient Document Web Services (Processor API). This tool provides a local workflow for preflight checks, HTML‑to‑PDF conversion, benchmarking, reporting, and design skill packs.
 
-Basic usage:
+> **Status:** This is an early scaffold. Several commands return **stub** outputs until API integration is wired in.
+
+## Features
+- `dws setup` — store API key locally
+- `dws preflight` — validate HTML inputs (stub output)
+- `dws convert` — convert HTML → PDF (stub output)
+- `dws benchmark` — generate placeholder benchmark results
+- `dws report` — generate a markdown report from results
+- `dws skills` — manage design skill packs
+
+## Install
+
+```sh
+npm install
+npm run build
 ```
+
+## Usage
+
+```sh
 dws --help
 ```
+
+```sh
+dws setup --api-key <key>
+```
+
+```sh
+dws preflight <htmlPath>
+```
+
+```sh
+dws convert <htmlPath> --output output.pdf --deterministic
+```
+
+```sh
+dws benchmark --suite W1-W6 --out results.json
+```
+
+```sh
+dws report --in results.json --out report.md
+```
+
+```sh
+dws skills list
+```
+
+```sh
+dws skills add /path/to/skill
+```
+
+## Configuration
+- API key can be supplied via `DWS_API_KEY` or stored in `~/.dws/config.json` using `dws setup`.
+- Config file is written with `0600` permissions.
+
+## Design Skill Packs
+A design skill pack is a folder containing a `design-skill.json` manifest, an entry HTML file, and assets (CSS/fonts/images).
+
+Example manifest:
+```json
+{
+  "name": "invoice-modern",
+  "version": "0.1.0",
+  "description": "Modern invoice template",
+  "entry": "index.html",
+  "assets": ["styles.css", "fonts/*"],
+  "defaults": {"locale": "en-US", "paper": "A4"}
+}
+```
+
+## Development
+- Node 18+ recommended
+- `npm run build` compiles to `dist/`
+
+## Release (manual)
+1. Update README/CHANGELOG and version in `package.json`
+2. `npm run build`
+3. `git tag vX.Y.Z` and `git push origin vX.Y.Z`
+
+## License
+Internal (PSPDFKit‑labs)