Skip to content

Turn any technical book PDF into a Claude Code skill — ready to study, reference, and use while you work.

docs: show what people did with it, not just where to report it

virgiliojr94dca93028b3b4
diff --git a/README.md b/README.md
index ee2cb39..d0c232e 100644
--- a/README.md
+++ b/README.md
@@ -117,7 +117,7 @@ Two halves: a deterministic Python **extractor** (document → clean text + meta
▶️ **All modes and examples → [docs/usage.md](docs/usage.md)**
-💬 **Using it for something? → [use cases](https://github.com/virgiliojr94/book-to-skill-use-cases)** — what people converted, the numbers they measured, and where it fell short. Your account lives in your own Gist; the index takes a one-line PR.
+💬 **In practice → [use cases](https://github.com/virgiliojr94/book-to-skill-use-cases)** — a DevEx book became a survey of 300+ engineers; a scanned PDF that stalled became [#130](https://github.com/virgiliojr94/book-to-skill/pull/130). Add yours: the account lives in your own Gist, the index takes a one-line PR.
---
diff --git a/docs/usage.md b/docs/usage.md
index bd8a0a4..1d6d236 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -40,6 +40,14 @@ In GitHub Copilot CLI you may need to run `/skills reload` after the file is wri
---
+## 💬 What people do with it
+
+A DevEx book became a survey applied to 300+ engineers. A scanned PDF that stalled a run became [#130](https://github.com/virgiliojr94/book-to-skill/pull/130), the early-abort fix — reported by someone who does not write software.
+
+Both accounts, and how to add yours, are in [book-to-skill-use-cases](https://github.com/virgiliojr94/book-to-skill-use-cases): your write-up as a Gist on your own account, one line in the index, no template and no CI. Bring the numbers from your run or what came of it — and say where it fell short.
+
+---
+
---