diff --git a/tools/skill_generator/README.md b/tools/skill_generator/README.md
index 7648704..a3b56b4 100644
--- a/tools/skill_generator/README.md
+++ b/tools/skill_generator/README.md
@@ -21,6 +21,8 @@ Python 3.10+ (standard library only — no third-party dependencies). Modules us
 | `link-ingest` | Stage 4 — apply links to each SKILL.md's frontmatter + body. |
 | `update-emit` | Phase 2 — write update prompts for features affected by `git diff`. |
 | `update-ingest` | Phase 2 — apply per-feature responses; bump version; optionally commit. |
+| `validate` | Ad-hoc — validate one or more SKILL.md files against the artifact-3 contract. |
+| `doctor` | Pre-flight — 30-second look at a Java repo before running the pipeline; no AI turns, nothing written to disk. |
 
 ## End-to-end run (with paste steps in between)
 
@@ -82,7 +84,7 @@ It also infers `framework` (Spring Boot, Spring MVC, Struts, Quarkus, Raw Servle
 
 ### What Stage 1 skips
 
-Silently skipped: `target/`, `build/`, `.git/`, `generated/`, `.mvn/`, `node_modules/`, `.idea/`, `.vscode/`, `.gradle/`, `out/`, `bin/`, `dist/`, `.settings/`. Binary extensions are not opened: `.class`, `.jar`, `.war`, `.ear`, `.zip`, `.tar`, `.gz`, `.so`, `.dylib`, `.dll`, image and font extensions. Files with `// DO NOT EDIT`, `@Generated`, or `// generated by` markers in the first 2KB are skipped. Files shorter than 10 characters are skipped.
+Silently skipped: `target/`, `build/`, `.git/`, `generated/`, `.mvn/`, `node_modules/`, `.idea/`, `.vscode/`, `.gradle/`, `out/`, `dist/`, `.settings/`. Note: `bin/` is intentionally **not** excluded — legacy apps store shell scripts there; Eclipse-compiled `.class` output inside `bin/` is still filtered by binary extensions. Binary extensions are not opened: `.class`, `.jar`, `.war`, `.ear`, `.zip`, `.tar`, `.gz`, `.so`, `.dylib`, `.dll`, image and font extensions. Files with `// DO NOT EDIT`, `@Generated`, or `// generated by` markers in the first 2KB are skipped. Files shorter than 10 characters are skipped.
 
 ## Output schema (top-level)