Clone the repoClone repo

The public toolkit ships with no character corpus — docs/profiles/, docs/materials/, and assets/ are absent by design. Bring your own subjects by creating docs/profiles/characters.yaml; the tooling resolves them dynamically via paths.py. This is also where you'd clone the private repo if you have access.Toolkit công khai không kèm corpus nhân vật — docs/profiles/, docs/materials/, và assets/ vắng mặt theo thiết kế. Mang nhân vật của bạn bằng cách tạo docs/profiles/characters.yaml; công cụ phân giải động qua paths.py. Đây cũng là nơi bạn clone repo riêng nếu có quyền truy cập.

Provision the project venvDựng venv nội bộ

One command. install.sh creates a project-local virtualenv under .claude/skills/.venv/ and installs three packages — pyyaml, jsonschema, pytest. No global pip is touched. The venv path is canonical: every script in every skill uses .claude/skills/.venv/bin/python3, never the system interpreter. Full install docs: Install.Một lệnh. install.sh tạo virtualenv nội bộ dưới .claude/skills/.venv/ và cài ba gói — pyyaml, jsonschema, pytest. Không đụng pip toàn cục. Đường dẫn venv là chuẩn: mọi script trong mọi skill dùng .claude/skills/.venv/bin/python3, không dùng trình thông dịch hệ thống. Tài liệu cài đầy đủ: Cài đặt.

The rule is absolute: all skill scripts are invoked as .claude/skills/.venv/bin/python3 .claude/skills/{fw}-{skill}/scripts/{script}.py. Never python3 bare — the system interpreter won't have the installed packages.Quy tắc tuyệt đối: mọi script skill được gọi là .claude/skills/.venv/bin/python3 .claude/skills/{fw}-{skill}/scripts/{script}.py. Không bao giờ dùng python3 trần — trình thông dịch hệ thống sẽ thiếu gói cài.

Run the deterministic test suiteChạy bộ kiểm thử tất định

The -m 'not gemini' marker skips the 34 live-LLM tests that need a GEMINI_API_KEY — all deterministic tests run. Without a roster you see ~665 pass, ~170 skip (corpus-dependent); with a roster the skip count drops. No API key, no external calls. real outputTham số -m 'not gemini' bỏ qua 34 test LLM thật cần GEMINI_API_KEY — mọi test tất định vẫn chạy. Không có roster thì ~665 đạt, ~170 bỏ qua (phụ thuộc corpus); có roster thì số bỏ qua giảm. Không cần API key, không gọi mạng. đầu ra thật

$ pytest tests/ -q -m 'not gemini'
1100 passed, 34 deselected, 2 warnings in 55.77s

→ deterministic suite green · 0 network calls · corpus-dependent tests skip cleanly

Additional gates (all deterministic, no key needed):Cổng bổ sung (tất định, không cần key):

Run the full e2e pipeline (19 steps)Chạy pipeline e2e đầy đủ (19 bước)

run-full-pipeline.py exercises the deterministic leg of all 7 frameworks against e2e/synthetic-project/ — a fully synthetic 2-character corpus with no real PII. 19 steps covering PSY · GRO · MAT · CRE · EVL + the platform_lib verdict-cache and preferences CLIs. Every step is a real script run, not a mock. Add --write-log to refresh the run log. real outputrun-full-pipeline.py chạy nhánh tất định của cả 7 framework trên e2e/synthetic-project/ — corpus giả lập 2 nhân vật hoàn toàn, không có PII thật. 19 bước bao phủ PSY · GRO · MAT · CRE · EVL + platform_lib verdict-cache và preferences CLI. Mỗi bước là chạy script thật, không phải mock. Thêm --write-log để cập nhật run log. đầu ra thật

[FINDINGS] PSY · health-check · completeness
[OK      ] PSY · crossref · timeline (dim 1)
[OK      ] PSY · crossref · bidirectional refs
[OK      ] PSY · crossref · extract events
[OK      ] PSY · timeline-sync
[FINDINGS] GRO · validate growth
[OK      ] GRO · competency gather
[OK      ] MAT · indexer · coverage gaps
[OK      ] MAT · indexer · stale materials
[OK      ] MAT · loader · inventory
[OK      ] MAT · loader · dup detection
[FINDINGS] CRE · humanize · scan ai-tells
[OK      ] CRE · privacy-guard · scan assets
[OK      ] CRE · privacy-guard · confidential names
[OK      ] EVL · validate · all rubrics
[OK      ] EVL · validate · scorecard invariants
[OK      ] LIB · verdict_cache · crisis is never-cached
[OK      ] LIB · verdict_cache · store+hit a verdict
[OK      ] LIB · preferences · read knobs

→ 19/19 steps OK · 7 frameworks · synthetic fixture · exit 0

Invoke your first skillGọi skill đầu tiên

All 68 skills are invoked by name as {fw}:{skill} inside Claude Code — the skill orchestrates its own scripts and LLM reasoning. You never call scripts directly when working through Claude Code. A good first skill without a corpus is mat:loader (needs a source file to ingest) or psy:health-check (needs a character slug + profile).Tất cả 68 skill được gọi theo tên {fw}:{skill} trong Claude Code — skill tự điều phối script và suy luận LLM. Bạn không bao giờ gọi script thủ công khi làm qua Claude Code. Skill đầu tốt để thử không cần corpus là mat:loader (cần file nguồn để thu nhận) hoặc psy:health-check (cần slug nhân vật + hồ sơ).

Or invoke a script directly (for testing outside Claude Code):Hoặc gọi script trực tiếp (để kiểm thử ngoài Claude Code):

Verify schemas (optional but recommended)Xác minh schema (tùy chọn nhưng khuyến nghị)

Validates 119 files — rubrics, scorecards, and references — against their JSON schemas. Run it after adding a rubric or scorecard to catch shape errors early.Kiểm tra 119 file — rubric, scorecard, và tài liệu tham khảo — theo schema JSON. Chạy sau khi thêm rubric hoặc scorecard để phát hiện lỗi hình dạng sớm.