Skip to content

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

docs(validate_skill): make the documented lens list match the real one (#298)

Wasif65b2f64314bf
diff --git a/README.md b/README.md
index 0d51fa1..f4beb1e 100644
--- a/README.md
+++ b/README.md
@@ -218,7 +218,7 @@ book-to-skill/
│ └── parsers/ # Format-specific parsers (pdf, epub, docx, html, rtf, calibre, text)
├── tools/
│ ├── discovery_tax.py # measures token cost vs context-dump / discovery loop
-│ └── validate_skill.py # checks a generated SKILL.md against host rules (--lens claude|copilot|amp|hermes|opencode)
+│ └── validate_skill.py # checks a generated SKILL.md against host rules (--lens claude|copilot|amp|hermes|openclaw|opencode)
├── tests/ # pytest suite (extraction, detection, discovery tax)
├── docs/
│ ├── performance.md # measured benchmarks, discovery tax, cost
diff --git a/docs/architecture.md b/docs/architecture.md
index 477bbb3..82efd9b 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -85,8 +85,7 @@ converter does not infer arbitrary `skills.load.extraDirs`.
| `book_to_skill/dependencies.py` | optional-dependency probing + `--check` |
| `book_to_skill/sanitize.py` | strips zero-width / Unicode-tag-block characters from extracted text, and folds Kangxi radicals to their ideographs (see Security) |
| `tools/discovery_tax.py` | measures token cost vs context-dump / discovery loop |
-| `tools/validate_skill.py` | checks a generated SKILL.md against host rules (`--lens claude\|copilot\|amp\|hermes\|openclaw`) |
-| `tools/validate_skill.py` | checks a generated SKILL.md against host rules (`--lens claude\|copilot\|amp\|hermes\|opencode`) |
+| `tools/validate_skill.py` | checks a generated SKILL.md against host rules (`--lens claude\|copilot\|amp\|hermes\|openclaw\|opencode`) |
| `tools/scan_generated_skill.py` | advisory prompt-injection scan of a generated skill (see Security) |
| `SKILL.md` | the generator spec (Steps 0–10 + fold-in workflow) |
diff --git a/tools/validate_skill.py b/tools/validate_skill.py
index 1db04dd..916be2e 100644
--- a/tools/validate_skill.py
+++ b/tools/validate_skill.py
@@ -24,16 +24,12 @@ Refs:
https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices
Copilot https://docs.github.com/en/copilot/concepts/agents/about-agent-skills
https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-skills
- Amp https://ampcode.com/manual#skills
- Hermes https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
- OpenClaw https://docs.openclaw.ai/tools/skills
-
-Usage: python3 tools/validate_skill.py [--lens claude|copilot|amp|hermes|openclaw] [path/to/SKILL.md]
Amp https://ampcode.com/manual#skills
- Hermes https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
- OpenCode https://opencode.ai/docs/skills
+ Hermes https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
+ OpenClaw https://docs.openclaw.ai/tools/skills
+ OpenCode https://opencode.ai/docs/skills
-Usage: python3 tools/validate_skill.py [--lens claude|copilot|amp|hermes|opencode] [path/to/SKILL.md]
+Usage: python3 tools/validate_skill.py [--lens claude|copilot|amp|hermes|openclaw|opencode] [path/to/SKILL.md]
"""
import argparse
import re