diff --git a/AGENTS.md b/AGENTS.md
index 793f3b2..37ec717 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -69,6 +69,7 @@ Clean test-only scratch directories after verification with `find tests -maxdept
 - `scripts/skill_report_model.py`, `scripts/skill_report_metrics.py`, `scripts/skill_report_charts.py`: skill overview data model, scoring, and inline SVG chart generation.
 - `scripts/yao_cli_config.py`: CLI target maps, archetype heuristics, diagnosis copy, and side-effect-free shaping helpers.
 - `scripts/yao_cli_parser.py`: CLI argparse command surface, flags, choices, and command handler binding.
+- `scripts/yao_cli_telemetry.py`: opt-in metadata-only CLI run telemetry. Keep it free of prompt, argument, output, transcript, note, or message capture.
 
 New helper modules that are imported by CLI/report scripts but are not standalone commands must declare:
 
diff --git a/README.md b/README.md
index df8c17a..426cf05 100644
--- a/README.md
+++ b/README.md
@@ -31,7 +31,7 @@ It turns rough workflows, transcripts, prompts, notes, and runbooks into reusabl
 - a systems-thinking model that maps boundaries, feedback loops, drift risks, recurring failure patterns, and highest-leverage quality moves
 - three high-value next iteration directions after the first package is created
 - a lightweight feedback log that does not require a full promotion cycle
-- a local-first metadata-only adoption and drift report that turns real usage signals into next iteration candidates
+- a local-first metadata-only adoption and drift report that turns real usage signals into next iteration candidates, with optional `yao.py` CLI run capture that records command names and outcomes without arguments or raw content
 - a Skill Atlas drift layer that reads aggregate adoption reports and surfaces portfolio-level drift signals without packaging raw telemetry logs
 - a baseline compare report for with-skill vs baseline review
 - a conversation-style, archetype-aware quickstart that steers new packages toward scaffold, production, library, or governed fits
@@ -108,6 +108,7 @@ python3 scripts/yao.py prompt-quality-profile my-skill
 python3 scripts/yao.py system-model my-skill
 python3 scripts/yao.py feedback my-skill --note "Tighten exclusions before adding scripts." --rating 4 --category boundary
 python3 scripts/yao.py adoption-drift my-skill --record-event skill_activation --activation-type explicit --outcome accepted
+YAO_CLI_TELEMETRY=1 python3 scripts/yao.py validate my-skill
 python3 scripts/yao.py review-waivers my-skill --add-waiver --gate-key trust-report --reviewer "Yao Team" --reason "Known warning accepted for this release with bounded follow-up." --expires-at 2026-09-30
 python3 scripts/yao.py review-waivers my-skill --add-waiver --gate-key permission-gates --reviewer "Yao Team" --reason "Permission warning accepted only for this non-governed release window." --expires-at 2026-09-30
 python3 scripts/yao.py review-annotations my-skill --add-annotation --gate-key output-lab --target-path reports/output_quality_scorecard.md --line 1 --body "Clarify recorded fixture vs model-executed evidence before release."
@@ -413,6 +414,7 @@ Utility scripts that make the meta-skill operational:
 - `simulate_install.py`: extracts a generated zip into a temporary skill root and verifies entrypoint, manifest, interface, reports, and adapters can be loaded
 - `upgrade_check.py`: compares current and previous registry package metadata, recommends a version bump, and blocks incompatible upgrade claims
 - `render_adoption_drift_report.py`: records metadata-only local telemetry and renders adoption, missed-trigger, bad-output, script-error, and review-drift signals without packaging raw event logs
+- `yao_cli_telemetry.py`: opt-in metadata-only `yao.py` run capture for command name, source, outcome, and failure class without command arguments or raw content
 - `render_review_waivers.py`: validates human reviewer risk approvals with gate keys, reasons, expiry dates, and blocker-safe waiver policy
 - `init_skill.py`, `lint_skill.py`, `validate_skill.py`, `diff_eval.py`: minimal authoring toolchain
 - `check_update.py`: checks GitHub for a newer `VERSION` or remote manifest version and reports a reinstall hint without modifying local files
diff --git a/references/telemetry-drift-method.md b/references/telemetry-drift-method.md
index 071bbb2..14caaff 100644
--- a/references/telemetry-drift-method.md
+++ b/references/telemetry-drift-method.md
@@ -17,6 +17,8 @@ The local event stream is `reports/telemetry_events.jsonl`. It is intentionally
   "event": "skill_activation",
   "skill": "example-skill",
   "version": "2.0.0",
+  "source": "yao_cli",
+  "command": "quickstart",
   "activation_type": "implicit",
   "outcome": "accepted",
   "failure_type": "none",
@@ -26,10 +28,39 @@ The local event stream is `reports/telemetry_events.jsonl`. It is intentionally
 
 Allowed events: `skill_activation`, `skill_output`, `script_run`, `review_event`.
 
+Allowed sources: `manual`, `yao_cli`, `external`, `unknown`.
+
 Allowed outcomes: `accepted`, `edited`, `rejected`, `missed`, `failed`, `reviewed`, `unknown`.
 
 Allowed failure types: `wrong_trigger`, `under_trigger`, `bad_output`, `missing_resource`, `script_error`, `review_overdue`, `none`.
 
+`source` and `command` are metadata fields. They may identify that `yao.py` ran `quickstart`, `validate`, `output-exec`, or another subcommand, but they must not include arguments, prompt text, file content, model output, transcripts, or reviewer notes.
+
+## CLI Capture
+
+`scripts/yao.py` can record metadata-only `script_run` events automatically. It is opt-in to keep release evidence reproducible and avoid surprising local writes:
+
+```bash
+YAO_CLI_TELEMETRY=1 python3 scripts/yao.py validate .
+```
+
+Optional destination override:
+
+```bash
+YAO_CLI_TELEMETRY=1 \
+YAO_CLI_TELEMETRY_EVENTS=/tmp/yao-telemetry.jsonl \
+python3 scripts/yao.py output-exec
+```
+
+Equivalent global flags are available before the subcommand:
+
+```bash
+python3 scripts/yao.py --record-cli-telemetry validate .
+python3 scripts/yao.py --no-cli-telemetry validate .
+```
+
+Successful CLI runs record `event=script_run`, `source=yao_cli`, `outcome=accepted`, and `failure_type=none`. Failed CLI runs record `outcome=failed` and `failure_type=script_error`. The command name is normalized to the subcommand only; command arguments are never recorded.
+
 ## Privacy Rule
 
 The raw JSONL event log is local evidence and should not be distributed in skill packages. The distributable artifact is the aggregate report:
@@ -48,7 +79,7 @@ Package builders should exclude `reports/telemetry_events.jsonl`. The root repos
 
 ## Iteration Loop
 
-1. Capture metadata-only events locally.
+1. Capture metadata-only events locally, either manually with `adoption-drift --record-event` or automatically with opt-in `yao.py` CLI capture.
 2. Render `reports/adoption_drift_report.md`.
 3. Convert missed triggers into trigger eval cases.
 4. Convert bad outputs into Output Eval assertions and failure taxonomy entries.
diff --git a/registry/index.json b/registry/index.json
index eeeea0c..653004b 100644
--- a/registry/index.json
+++ b/registry/index.json
@@ -16,7 +16,7 @@
         "vscode"
       ],
       "package_metadata": "registry/packages/yao-meta-skill.json",
-      "package_sha256": "44d9cb1aa096fff1b2c8844a609574c05c8ed9ae12005dc74a5662d3d94013fd"
+      "package_sha256": "495c5824cf84b56ef77bebc75e415191425e2f1131f0a4027d17037631b52fa2"
     }
   ]
 }
diff --git a/registry/packages/yao-meta-skill.json b/registry/packages/yao-meta-skill.json
index 31f6411..8537a80 100644
--- a/registry/packages/yao-meta-skill.json
+++ b/registry/packages/yao-meta-skill.json
@@ -16,8 +16,8 @@
   "trust_level": "local",
   "license": "MIT",
   "checksums": {
-    "package_sha256": "44d9cb1aa096fff1b2c8844a609574c05c8ed9ae12005dc74a5662d3d94013fd",
-    "archive_sha256": "cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933"
+    "package_sha256": "495c5824cf84b56ef77bebc75e415191425e2f1131f0a4027d17037631b52fa2",
+    "archive_sha256": "0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474"
   },
   "compatibility": {
     "openai": "pass",
@@ -48,7 +48,7 @@
   },
   "distribution": {
     "archive_verified": true,
-    "archive_sha256": "cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933",
+    "archive_sha256": "0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474",
     "package_verification": "reports/package_verification.json",
     "install_simulated": true,
     "install_simulation": "reports/install_simulation.json"
diff --git a/reports/adoption_drift_report.json b/reports/adoption_drift_report.json
index 50f198d..269794a 100644
--- a/reports/adoption_drift_report.json
+++ b/reports/adoption_drift_report.json
@@ -1,7 +1,7 @@
 {
   "ok": true,
   "schema_version": "2.0",
-  "generated_at": "2026-06-13T13:13:24Z",
+  "generated_at": "2026-06-13T13:30:00Z",
   "skill_dir": ".",
   "privacy_contract": {
     "storage": "local-first",
@@ -25,14 +25,14 @@
   },
   "summary": {
     "event_count": 1,
-    "adoption_sample_count": 1,
-    "activation_count": 1,
-    "accepted_count": 1,
+    "adoption_sample_count": 0,
+    "activation_count": 0,
+    "accepted_count": 0,
     "edited_count": 0,
     "rejected_count": 0,
     "missed_count": 0,
     "failed_count": 0,
-    "adoption_rate": 100.0,
+    "adoption_rate": 0,
     "missed_trigger_count": 0,
     "wrong_trigger_count": 0,
     "bad_output_count": 0,
@@ -41,37 +41,43 @@
     "review_overdue_count": 0,
     "risk_band": "low",
     "event_types": {
-      "skill_activation": 1
+      "review_event": 1
     },
-    "failure_types": {}
+    "failure_types": {},
+    "source_types": {
+      "manual": 1
+    },
+    "command_counts": {}
   },
   "adoption_by_skill": [
     {
       "skill": "yao-meta-skill",
       "events": 1,
-      "adoption_events": 1,
-      "accepted": 1,
+      "adoption_events": 0,
+      "accepted": 0,
       "edited": 0,
       "rejected": 0,
       "missed": 0,
-      "adoption_rate": 100.0
+      "adoption_rate": 0
     }
   ],
   "next_iteration_candidates": [],
   "recent_events": [
     {
-      "event": "skill_activation",
+      "command": "unknown",
+      "event": "review_event",
       "skill": "yao-meta-skill",
+      "source": "manual",
       "version": "1.1.0",
-      "activation_type": "explicit",
-      "outcome": "accepted",
+      "activation_type": "manual",
+      "outcome": "reviewed",
       "failure_type": "none",
-      "timestamp": "2026-06-13T10:00:00Z"
+      "timestamp": "2026-06-13T12:00:00Z"
     }
   ],
   "failures": [],
   "artifacts": {
-    "events_jsonl": "tests/tmp_review_studio/telemetry_events.jsonl",
+    "events_jsonl": "reports/telemetry_events.jsonl",
     "json": "reports/adoption_drift_report.json",
     "markdown": "reports/adoption_drift_report.md"
   }
diff --git a/reports/adoption_drift_report.md b/reports/adoption_drift_report.md
index 6945d35..91b3198 100644
--- a/reports/adoption_drift_report.md
+++ b/reports/adoption_drift_report.md
@@ -5,9 +5,9 @@ Local-first, metadata-only telemetry for skill operations. Raw prompts, outputs,
 ## Summary
 
 - Events: `1`
-- Adoption samples: `1`
-- Activation events: `1`
-- Adoption rate: `100.0`
+- Adoption samples: `0`
+- Activation events: `0`
+- Adoption rate: `0`
 - Missed trigger signals: `0`
 - Bad output signals: `0`
 - Script error signals: `0`
@@ -25,7 +25,7 @@ Local-first, metadata-only telemetry for skill operations. Raw prompts, outputs,
 
 | Skill | Events | Adoption Samples | Accepted | Edited | Rejected | Missed | Adoption Rate |
 | --- | ---: | ---: | ---: | ---: | ---: | ---: | ---: |
-| `yao-meta-skill` | 1 | 1 | 1 | 0 | 0 | 0 | 100.0 |
+| `yao-meta-skill` | 1 | 0 | 0 | 0 | 0 | 0 | 0 |
 
 ## Next Iteration Candidates
 
@@ -33,4 +33,4 @@ Local-first, metadata-only telemetry for skill operations. Raw prompts, outputs,
 
 ## Recent Metadata Events
 
-- `2026-06-13T10:00:00Z` `yao-meta-skill` event=`skill_activation` activation=`explicit` outcome=`accepted` failure=`none`
+- `2026-06-13T12:00:00Z` `yao-meta-skill` event=`review_event` source=`manual` command=`unknown` activation=`manual` outcome=`reviewed` failure=`none`
diff --git a/reports/compiled_targets.json b/reports/compiled_targets.json
index 2108741..e917ddc 100644
--- a/reports/compiled_targets.json
+++ b/reports/compiled_targets.json
@@ -213,7 +213,8 @@
             "scripts/verify_package.py",
             "scripts/yao.py",
             "scripts/yao_cli_config.py",
-            "scripts/yao_cli_parser.py"
+            "scripts/yao_cli_parser.py",
+            "scripts/yao_cli_telemetry.py"
           ],
           "assets": [
             "templates/basic_skill.md.j2",
@@ -264,7 +265,7 @@
           ],
           "counts": {
             "references": 32,
-            "scripts": 69,
+            "scripts": 70,
             "assets": 2,
             "reports": 41
           }
@@ -505,7 +506,7 @@
             "strategy": "Ship the neutral source tree and expose OpenAI-facing interface metadata as a generated companion file.",
             "counts": {
               "references": 32,
-              "scripts": 69,
+              "scripts": 70,
               "assets": 2,
               "reports": 41
             },
@@ -516,7 +517,7 @@
           },
           "scripts": {
             "strategy": "Keep scripts as local package resources; expose help-smoke and permission metadata for reviewer approval before execution.",
-            "script_count": 69,
+            "script_count": 70,
             "help_smoke_failed_count": 0
           },
           "permissions": {
@@ -730,7 +731,7 @@
           "strategy": "Ship the neutral source tree and expose OpenAI-facing interface metadata as a generated companion file.",
           "counts": {
             "references": 32,
-            "scripts": 69,
+            "scripts": 70,
             "assets": 2,
             "reports": 41
           },
@@ -741,7 +742,7 @@
         },
         "scripts": {
           "strategy": "Keep scripts as local package resources; expose help-smoke and permission metadata for reviewer approval before execution.",
-          "script_count": 69,
+          "script_count": 70,
           "help_smoke_failed_count": 0
         },
         "permissions": {
@@ -1011,7 +1012,8 @@
             "scripts/verify_package.py",
             "scripts/yao.py",
             "scripts/yao_cli_config.py",
-            "scripts/yao_cli_parser.py"
+            "scripts/yao_cli_parser.py",
+            "scripts/yao_cli_telemetry.py"
           ],
           "assets": [
             "templates/basic_skill.md.j2",
@@ -1062,7 +1064,7 @@
           ],
           "counts": {
             "references": 32,
-            "scripts": 69,
+            "scripts": 70,
             "assets": 2,
             "reports": 41
           }
@@ -1303,7 +1305,7 @@
             "strategy": "Preserve the source tree directly; write target notes in targets/claude/README.md.",
             "counts": {
               "references": 32,
-              "scripts": 69,
+              "scripts": 70,
               "assets": 2,
               "reports": 41
             },
@@ -1314,7 +1316,7 @@
           },
           "scripts": {
             "strategy": "Scripts remain local package resources and must be reviewed through trust and permission reports before use.",
-            "script_count": 69,
+            "script_count": 70,
             "help_smoke_failed_count": 0
           },
           "permissions": {
@@ -1528,7 +1530,7 @@
           "strategy": "Preserve the source tree directly; write target notes in targets/claude/README.md.",
           "counts": {
             "references": 32,
-            "scripts": 69,
+            "scripts": 70,
             "assets": 2,
             "reports": 41
           },
@@ -1539,7 +1541,7 @@
         },
         "scripts": {
           "strategy": "Scripts remain local package resources and must be reviewed through trust and permission reports before use.",
-          "script_count": 69,
+          "script_count": 70,
           "help_smoke_failed_count": 0
         },
         "permissions": {
@@ -1809,7 +1811,8 @@
             "scripts/verify_package.py",
             "scripts/yao.py",
             "scripts/yao_cli_config.py",
-            "scripts/yao_cli_parser.py"
+            "scripts/yao_cli_parser.py",
+            "scripts/yao_cli_telemetry.py"
           ],
           "assets": [
             "templates/basic_skill.md.j2",
@@ -1860,7 +1863,7 @@
           ],
           "counts": {
             "references": 32,
-            "scripts": 69,
+            "scripts": 70,
             "assets": 2,
             "reports": 41
           }
@@ -2101,7 +2104,7 @@
             "strategy": "Preserve references, scripts, assets, evals, reports, and adapter metadata as relative package resources.",
             "counts": {
               "references": 32,
-              "scripts": 69,
+              "scripts": 70,
               "assets": 2,
               "reports": 41
             },
@@ -2111,7 +2114,7 @@
           },
           "scripts": {
             "strategy": "Expose script and permission metadata for downstream clients or installers to enforce.",
-            "script_count": 69,
+            "script_count": 70,
             "help_smoke_failed_count": 0
           },
           "permissions": {
@@ -2319,7 +2322,7 @@
           "strategy": "Preserve references, scripts, assets, evals, reports, and adapter metadata as relative package resources.",
           "counts": {
             "references": 32,
-            "scripts": 69,
+            "scripts": 70,
             "assets": 2,
             "reports": 41
           },
@@ -2329,7 +2332,7 @@
         },
         "scripts": {
           "strategy": "Expose script and permission metadata for downstream clients or installers to enforce.",
-          "script_count": 69,
+          "script_count": 70,
           "help_smoke_failed_count": 0
         },
         "permissions": {
@@ -2591,7 +2594,8 @@
             "scripts/verify_package.py",
             "scripts/yao.py",
             "scripts/yao_cli_config.py",
-            "scripts/yao_cli_parser.py"
+            "scripts/yao_cli_parser.py",
+            "scripts/yao_cli_telemetry.py"
           ],
           "assets": [
             "templates/basic_skill.md.j2",
@@ -2642,7 +2646,7 @@
           ],
           "counts": {
             "references": 32,
-            "scripts": 69,
+            "scripts": 70,
             "assets": 2,
             "reports": 41
           }
@@ -2883,7 +2887,7 @@
             "strategy": "Keep optional directories as relative resources next to SKILL.md.",
             "counts": {
               "references": 32,
-              "scripts": 69,
+              "scripts": 70,
               "assets": 2,
               "reports": 41
             },
@@ -2894,7 +2898,7 @@
           },
           "scripts": {
             "strategy": "Scripts remain local optional resources and should advertise --help when executable.",
-            "script_count": 69,
+            "script_count": 70,
             "help_smoke_failed_count": 0
           },
           "permissions": {
@@ -3101,7 +3105,7 @@
           "strategy": "Keep optional directories as relative resources next to SKILL.md.",
           "counts": {
             "references": 32,
-            "scripts": 69,
+            "scripts": 70,
             "assets": 2,
             "reports": 41
           },
@@ -3112,7 +3116,7 @@
         },
         "scripts": {
           "strategy": "Scripts remain local optional resources and should advertise --help when executable.",
-          "script_count": 69,
+          "script_count": 70,
           "help_smoke_failed_count": 0
         },
         "permissions": {
@@ -3373,7 +3377,8 @@
             "scripts/verify_package.py",
             "scripts/yao.py",
             "scripts/yao_cli_config.py",
-            "scripts/yao_cli_parser.py"
+            "scripts/yao_cli_parser.py",
+            "scripts/yao_cli_telemetry.py"
           ],
           "assets": [
             "templates/basic_skill.md.j2",
@@ -3424,7 +3429,7 @@
           ],
           "counts": {
             "references": 32,
-            "scripts": 69,
+            "scripts": 70,
             "assets": 2,
             "reports": 41
           }
@@ -3665,7 +3670,7 @@
             "strategy": "Install as project or user scoped skill source, preserving relative references and scripts.",
             "counts": {
               "references": 32,
-              "scripts": 69,
+              "scripts": 70,
               "assets": 2,
               "reports": 41
             },
@@ -3676,7 +3681,7 @@
           },
           "scripts": {
             "strategy": "Scripts require workspace trust and operator/client approval outside this compiler.",
-            "script_count": 69,
+            "script_count": 70,
             "help_smoke_failed_count": 0
           },
           "permissions": {
@@ -3887,7 +3892,7 @@
           "strategy": "Install as project or user scoped skill source, preserving relative references and scripts.",
           "counts": {
             "references": 32,
-            "scripts": 69,
+            "scripts": 70,
             "assets": 2,
             "reports": 41
           },
@@ -3898,7 +3903,7 @@
         },
         "scripts": {
           "strategy": "Scripts require workspace trust and operator/client approval outside this compiler.",
-          "script_count": 69,
+          "script_count": 70,
           "help_smoke_failed_count": 0
         },
         "permissions": {
diff --git a/reports/context_budget.json b/reports/context_budget.json
index cb22e04..b068fe2 100644
--- a/reports/context_budget.json
+++ b/reports/context_budget.json
@@ -6,10 +6,10 @@
     "context_budget_tier": "production",
     "context_budget_limit": 1000,
     "skill_body_tokens": 751,
-    "other_text_tokens": 915033,
+    "other_text_tokens": 917960,
     "estimated_initial_load_tokens": 944,
-    "estimated_total_text_tokens": 915784,
-    "relevant_file_count": 392,
+    "estimated_total_text_tokens": 918711,
+    "relevant_file_count": 394,
     "unused_resource_dirs": [],
     "quality_signal_points": 130,
     "quality_density": 137.7
diff --git a/reports/install_simulation.json b/reports/install_simulation.json
index 92a0067..6973bf8 100644
--- a/reports/install_simulation.json
+++ b/reports/install_simulation.json
@@ -8,7 +8,7 @@
   "installed_skill_dir": "dist/install-simulation/simulate-yao-meta-skill/yao-meta-skill",
   "summary": {
     "archive_present": true,
-    "archive_entry_count": 494,
+    "archive_entry_count": 495,
     "archive_extracted": true,
     "entrypoint_loaded": true,
     "manifest_loaded": true,
diff --git a/reports/output_execution_runs.json b/reports/output_execution_runs.json
index 0b6541a..78b3d8c 100644
--- a/reports/output_execution_runs.json
+++ b/reports/output_execution_runs.json
@@ -34,7 +34,7 @@
       "execution_mode": "command",
       "model_executed": false,
       "command_executed": true,
-      "duration_ms": 33.6,
+      "duration_ms": 31.15,
       "provider": "local-output-eval-runner",
       "model": "",
       "usage": {
@@ -62,7 +62,7 @@
       "execution_mode": "command",
       "model_executed": false,
       "command_executed": true,
-      "duration_ms": 33.9,
+      "duration_ms": 31.4,
       "provider": "local-output-eval-runner",
       "model": "",
       "usage": {
@@ -85,7 +85,7 @@
       "execution_mode": "command",
       "model_executed": false,
       "command_executed": true,
-      "duration_ms": 37.17,
+      "duration_ms": 33.61,
       "provider": "local-output-eval-runner",
       "model": "",
       "usage": {
@@ -113,7 +113,7 @@
       "execution_mode": "command",
       "model_executed": false,
       "command_executed": true,
-      "duration_ms": 49.26,
+      "duration_ms": 33.86,
       "provider": "local-output-eval-runner",
       "model": "",
       "usage": {
@@ -136,7 +136,7 @@
       "execution_mode": "command",
       "model_executed": false,
       "command_executed": true,
-      "duration_ms": 32.41,
+      "duration_ms": 33.02,
       "provider": "local-output-eval-runner",
       "model": "",
       "usage": {
@@ -164,7 +164,7 @@
       "execution_mode": "command",
       "model_executed": false,
       "command_executed": true,
-      "duration_ms": 33.26,
+      "duration_ms": 31.39,
       "provider": "local-output-eval-runner",
       "model": "",
       "usage": {
@@ -187,7 +187,7 @@
       "execution_mode": "command",
       "model_executed": false,
       "command_executed": true,
-      "duration_ms": 33.85,
+      "duration_ms": 30.77,
       "provider": "local-output-eval-runner",
       "model": "",
       "usage": {
@@ -214,7 +214,7 @@
       "execution_mode": "command",
       "model_executed": false,
       "command_executed": true,
-      "duration_ms": 34.38,
+      "duration_ms": 32.92,
       "provider": "local-output-eval-runner",
       "model": "",
       "usage": {
@@ -237,7 +237,7 @@
       "execution_mode": "command",
       "model_executed": false,
       "command_executed": true,
-      "duration_ms": 34.12,
+      "duration_ms": 29.09,
       "provider": "local-output-eval-runner",
       "model": "",
       "usage": {
@@ -266,7 +266,7 @@
       "execution_mode": "command",
       "model_executed": false,
       "command_executed": true,
-      "duration_ms": 34.95,
+      "duration_ms": 27.95,
       "provider": "local-output-eval-runner",
       "model": "",
       "usage": {
diff --git a/reports/output_execution_runs.md b/reports/output_execution_runs.md
index dd06dd4..a4d9cd1 100644
--- a/reports/output_execution_runs.md
+++ b/reports/output_execution_runs.md
@@ -23,16 +23,16 @@ Command runner evidence is present. This proves the eval harness executed an ext
 
 | Case | Variant | Mode | Model | Duration ms | Tokens | Score | Status |
 | --- | --- | --- | --- | ---: | ---: | ---: | --- |
-| skill-package-contract | baseline | command | local-output-eval-runner | 33.6 | 33 | 0.0 | pass |
-| skill-package-contract | with_skill | command | local-output-eval-runner | 33.9 | 73 | 100.0 | pass |
-| output-eval-expectation | baseline | command | local-output-eval-runner | 37.17 | 36 | 0.0 | pass |
-| output-eval-expectation | with_skill | command | local-output-eval-runner | 49.26 | 80 | 100.0 | pass |
-| ir-before-packaging | baseline | command | local-output-eval-runner | 32.41 | 33 | 0.0 | pass |
-| ir-before-packaging | with_skill | command | local-output-eval-runner | 33.26 | 80 | 100.0 | pass |
-| near-neighbor-boundary | baseline | command | local-output-eval-runner | 33.85 | 36 | 0.0 | pass |
-| near-neighbor-boundary | with_skill | command | local-output-eval-runner | 34.38 | 65 | 100.0 | pass |
-| file-backed-governed-package | baseline | command | local-output-eval-runner | 34.12 | 37 | 0.0 | pass |
-| file-backed-governed-package | with_skill | command | local-output-eval-runner | 34.95 | 98 | 100.0 | pass |
+| skill-package-contract | baseline | command | local-output-eval-runner | 31.15 | 33 | 0.0 | pass |
+| skill-package-contract | with_skill | command | local-output-eval-runner | 31.4 | 73 | 100.0 | pass |
+| output-eval-expectation | baseline | command | local-output-eval-runner | 33.61 | 36 | 0.0 | pass |
+| output-eval-expectation | with_skill | command | local-output-eval-runner | 33.86 | 80 | 100.0 | pass |
+| ir-before-packaging | baseline | command | local-output-eval-runner | 33.02 | 33 | 0.0 | pass |
+| ir-before-packaging | with_skill | command | local-output-eval-runner | 31.39 | 80 | 100.0 | pass |
+| near-neighbor-boundary | baseline | command | local-output-eval-runner | 30.77 | 36 | 0.0 | pass |
+| near-neighbor-boundary | with_skill | command | local-output-eval-runner | 32.92 | 65 | 100.0 | pass |
+| file-backed-governed-package | baseline | command | local-output-eval-runner | 29.09 | 37 | 0.0 | pass |
+| file-backed-governed-package | with_skill | command | local-output-eval-runner | 27.95 | 98 | 100.0 | pass |
 
 ## Next Fixes
 
diff --git a/reports/package_verification.json b/reports/package_verification.json
index 797ea0b..b390b49 100644
--- a/reports/package_verification.json
+++ b/reports/package_verification.json
@@ -8,8 +8,8 @@
     "target_count": 4,
     "adapter_count": 4,
     "archive_present": true,
-    "archive_sha256": "cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933",
-    "archive_entry_count": 494,
+    "archive_sha256": "0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474",
+    "archive_entry_count": 495,
     "failure_count": 0,
     "warning_count": 0
   },
diff --git a/reports/package_verification.md b/reports/package_verification.md
index a783613..7178423 100644
--- a/reports/package_verification.md
+++ b/reports/package_verification.md
@@ -4,7 +4,7 @@
 - Package directory: `dist`
 - Targets: `4 / 4` adapters present
 - Archive present: `True`
-- Archive SHA256: `cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933`
+- Archive SHA256: `0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474`
 - Failures: `0`
 - Warnings: `0`
 
diff --git a/reports/registry_audit.json b/reports/registry_audit.json
index 0a30ff5..001d867 100644
--- a/reports/registry_audit.json
+++ b/reports/registry_audit.json
@@ -21,8 +21,8 @@
     "trust_level": "local",
     "license": "MIT",
     "checksums": {
-      "package_sha256": "44d9cb1aa096fff1b2c8844a609574c05c8ed9ae12005dc74a5662d3d94013fd",
-      "archive_sha256": "cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933"
+      "package_sha256": "495c5824cf84b56ef77bebc75e415191425e2f1131f0a4027d17037631b52fa2",
+      "archive_sha256": "0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474"
     },
     "compatibility": {
       "openai": "pass",
@@ -53,7 +53,7 @@
     },
     "distribution": {
       "archive_verified": true,
-      "archive_sha256": "cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933",
+      "archive_sha256": "0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474",
       "package_verification": "reports/package_verification.json",
       "install_simulated": true,
       "install_simulation": "reports/install_simulation.json"
@@ -78,7 +78,7 @@
           "vscode"
         ],
         "package_metadata": "registry/packages/yao-meta-skill.json",
-        "package_sha256": "44d9cb1aa096fff1b2c8844a609574c05c8ed9ae12005dc74a5662d3d94013fd"
+        "package_sha256": "495c5824cf84b56ef77bebc75e415191425e2f1131f0a4027d17037631b52fa2"
       }
     ]
   },
diff --git a/reports/registry_audit.md b/reports/registry_audit.md
index 003be7c..98065b2 100644
--- a/reports/registry_audit.md
+++ b/reports/registry_audit.md
@@ -6,8 +6,8 @@
 - Maturity: `governed`
 - Owner: `Yao Team`
 - License: `MIT`
-- Package SHA256: `44d9cb1aa096fff1b2c8844a609574c05c8ed9ae12005dc74a5662d3d94013fd`
-- Archive SHA256: `cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933`
+- Package SHA256: `495c5824cf84b56ef77bebc75e415191425e2f1131f0a4027d17037631b52fa2`
+- Archive SHA256: `0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474`
 - Install simulated: `True`
 
 ## Compatibility
diff --git a/reports/review-studio.html b/reports/review-studio.html
index adc4126..2a86ed1 100644
--- a/reports/review-studio.html
+++ b/reports/review-studio.html
@@ -242,12 +242,12 @@
 
     <section>
       <h2>核心指标</h2>
-      <div class="metrics"><article class='metric'><span>Skill IR</span><strong>2.0.0</strong><p>5 targets in platform-neutral contract</p></article><article class='metric'><span>Compiler</span><strong>5/5</strong><p>target contracts compiled from Skill IR</p></article><article class='metric'><span>Output Delta</span><strong>100.0</strong><p>5 cases; 1 file-backed</p></article><article class='metric'><span>Exec Runs</span><strong>10</strong><p>command 10; model 0; recorded 0</p></article><article class='metric'><span>Blind A/B</span><strong>5</strong><p>review pairs hide baseline vs with-skill labels</p></article><article class='metric'><span>Review A/B</span><strong>0/5</strong><p>adjudication decisions; pending 5</p></article><article class='metric'><span>Runtime</span><strong>5/5</strong><p>target conformance pass rate</p></article><article class='metric'><span>Perm Probe</span><strong>4/4</strong><p>0 native enforcement targets</p></article><article class='metric'><span>Trust</span><strong>0</strong><p>69 scripts scanned; secrets found</p></article><article class='metric'><span>Atlas</span><strong>5</strong><p>12 scanned skills; route collisions</p></article><article class='metric'><span>Drift</span><strong>low</strong><p>1 metadata events; 0 missed triggers</p></article><article class='metric'><span>Waivers</span><strong>0</strong><p>0 gates covered; human risk decisions</p></article><article class='metric'><span>Notes</span><strong>0/0</strong><p>0 open blocker annotations</p></article><article class='metric'><span>Registry</span><strong>1.1.0</strong><p>5 targets; MIT license</p></article><article class='metric'><span>Archive</span><strong>pass</strong><p>494 zip entries; package verification</p></article><article class='metric'><span>Install</span><strong>pass</strong><p>4 adapters; 12 permissions enforced; 0 permission failures</p></article><article class='metric'><span>Upgrade</span><strong>minor</strong><p>declared minor; 0 breaking changes</p></article></div>
+      <div class="metrics"><article class='metric'><span>Skill IR</span><strong>2.0.0</strong><p>5 targets in platform-neutral contract</p></article><article class='metric'><span>Compiler</span><strong>5/5</strong><p>target contracts compiled from Skill IR</p></article><article class='metric'><span>Output Delta</span><strong>100.0</strong><p>5 cases; 1 file-backed</p></article><article class='metric'><span>Exec Runs</span><strong>10</strong><p>command 10; model 0; recorded 0</p></article><article class='metric'><span>Blind A/B</span><strong>5</strong><p>review pairs hide baseline vs with-skill labels</p></article><article class='metric'><span>Review A/B</span><strong>0/5</strong><p>adjudication decisions; pending 5</p></article><article class='metric'><span>Runtime</span><strong>5/5</strong><p>target conformance pass rate</p></article><article class='metric'><span>Perm Probe</span><strong>4/4</strong><p>0 native enforcement targets</p></article><article class='metric'><span>Trust</span><strong>0</strong><p>70 scripts scanned; secrets found</p></article><article class='metric'><span>Atlas</span><strong>5</strong><p>12 scanned skills; route collisions</p></article><article class='metric'><span>Drift</span><strong>low</strong><p>1 metadata events; 0 missed triggers</p></article><article class='metric'><span>Waivers</span><strong>0</strong><p>0 gates covered; human risk decisions</p></article><article class='metric'><span>Notes</span><strong>0/0</strong><p>0 open blocker annotations</p></article><article class='metric'><span>Registry</span><strong>1.1.0</strong><p>5 targets; MIT license</p></article><article class='metric'><span>Archive</span><strong>pass</strong><p>495 zip entries; package verification</p></article><article class='metric'><span>Install</span><strong>pass</strong><p>4 adapters; 12 permissions enforced; 0 permission failures</p></article><article class='metric'><span>Upgrade</span><strong>minor</strong><p>declared minor; 0 breaking changes</p></article></div>
     </section>
 
     <section>
       <h2>审查闸门</h2>
-      <div class="gates"><article class='gate pass'><div><span>通过</span><h3>意图画布</h3></div><p>intent confidence 100/100; Intent is clear enough to package the first routeable version.</p><footer>reports/intent-confidence.json <a href='intent-confidence.md'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>触发实验</h3></div><p>13 trigger cases; 0 misroutes; 0 ambiguous</p><footer>reports/route_scorecard.json <a href='route_scorecard.md'>证据</a></footer></article><article class='gate warn'><div><span>关注</span><h3>输出实验</h3></div><p>5/5 cases; with-skill 100.0; baseline 0.0; file-backed 1; near-neighbor 1; blind A/B 5; exec 10; command 10; model 0; recorded 0; reviewed 0/5; review pending 5</p><footer>reports/output_quality_scorecard.json <a href='output_quality_scorecard.md'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>上下文</h3></div><p>initial load 944/1000; quality density 137.7</p><footer>reports/context_budget.json <a href='context_budget.md'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>运行矩阵</h3></div><p>5 / 5 targets pass</p><footer>reports/conformance_matrix.json <a href='conformance_matrix.md'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>信任报告</h3></div><p>0 secrets; 69 scripts; 3 network-capable scripts; 0 help smoke failures</p><footer>reports/security_trust_report.json <a href='security_trust_report.md'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>权限批准</h3></div><p>3/3 permissions approved; gaps 0; required file_write, network, subprocess</p><footer>reports/security_trust_report.json + security/permission_policy.json <a href='../security/permission_policy.md'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>权限探针</h3></div><p>4/4 targets probed; native 0; metadata fallback 4; residual risks 4</p><footer>reports/runtime_permission_probes.json <a href='runtime_permission_probes.md'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>组合治理</h3></div><p>12 skills, 1 actionable; 0 actionable route collisions; 0 actionable owner gaps; 0 actionable stale; 0 actionable drift; 24 scoped non-actionable issues</p><footer>reports/skill_atlas.json <a href='skill_atlas.html'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>运营回路</h3></div><p>1 metadata events; adoption 100.0; missed 0; bad-output 0; risk low</p><footer>reports/adoption_drift_report.json <a href='adoption_drift_report.md'>证据</a></footer></article><article class='gate warn'><div><span>关注</span><h3>人工批准</h3></div><p>0 active waivers; 1 warning gates still need reviewer decision</p><footer>reports/review_waivers.json <a href='review_waivers.md'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>注册审计</h3></div><p>yao-meta-skill 1.1.0; 6/6 compatibility entries pass; install pass with 4 adapters; installer permissions 12 enforced / 0 failures</p><footer>reports/registry_audit.json + reports/install_simulation.json <a href='registry_audit.md'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>发布路线</h3></div><p>0 promote; 3 keep current; 0 blocked; upgrade minor declared / minor recommended</p><footer>reports/promotion_decisions.json + reports/upgrade_check.json + docs/migration-v2.md <a href='promotion_decisions.md'>证据</a></footer></article></div>
+      <div class="gates"><article class='gate pass'><div><span>通过</span><h3>意图画布</h3></div><p>intent confidence 100/100; Intent is clear enough to package the first routeable version.</p><footer>reports/intent-confidence.json <a href='intent-confidence.md'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>触发实验</h3></div><p>13 trigger cases; 0 misroutes; 0 ambiguous</p><footer>reports/route_scorecard.json <a href='route_scorecard.md'>证据</a></footer></article><article class='gate warn'><div><span>关注</span><h3>输出实验</h3></div><p>5/5 cases; with-skill 100.0; baseline 0.0; file-backed 1; near-neighbor 1; blind A/B 5; exec 10; command 10; model 0; recorded 0; reviewed 0/5; review pending 5</p><footer>reports/output_quality_scorecard.json <a href='output_quality_scorecard.md'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>上下文</h3></div><p>initial load 944/1000; quality density 137.7</p><footer>reports/context_budget.json <a href='context_budget.md'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>运行矩阵</h3></div><p>5 / 5 targets pass</p><footer>reports/conformance_matrix.json <a href='conformance_matrix.md'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>信任报告</h3></div><p>0 secrets; 70 scripts; 3 network-capable scripts; 0 help smoke failures</p><footer>reports/security_trust_report.json <a href='security_trust_report.md'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>权限批准</h3></div><p>3/3 permissions approved; gaps 0; required file_write, network, subprocess</p><footer>reports/security_trust_report.json + security/permission_policy.json <a href='../security/permission_policy.md'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>权限探针</h3></div><p>4/4 targets probed; native 0; metadata fallback 4; residual risks 4</p><footer>reports/runtime_permission_probes.json <a href='runtime_permission_probes.md'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>组合治理</h3></div><p>12 skills, 1 actionable; 0 actionable route collisions; 0 actionable owner gaps; 0 actionable stale; 0 actionable drift; 24 scoped non-actionable issues</p><footer>reports/skill_atlas.json <a href='skill_atlas.html'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>运营回路</h3></div><p>1 metadata events; adoption 0; missed 0; bad-output 0; risk low</p><footer>reports/adoption_drift_report.json <a href='adoption_drift_report.md'>证据</a></footer></article><article class='gate warn'><div><span>关注</span><h3>人工批准</h3></div><p>0 active waivers; 1 warning gates still need reviewer decision</p><footer>reports/review_waivers.json <a href='review_waivers.md'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>注册审计</h3></div><p>yao-meta-skill 1.1.0; 6/6 compatibility entries pass; install pass with 4 adapters; installer permissions 12 enforced / 0 failures</p><footer>reports/registry_audit.json + reports/install_simulation.json <a href='registry_audit.md'>证据</a></footer></article><article class='gate pass'><div><span>通过</span><h3>发布路线</h3></div><p>0 promote; 3 keep current; 0 blocked; upgrade minor declared / minor recommended</p><footer>reports/promotion_decisions.json + reports/upgrade_check.json + docs/migration-v2.md <a href='promotion_decisions.md'>证据</a></footer></article></div>
     </section>
 
     <div class="twocol">
@@ -313,7 +313,7 @@
     </section>
 
     <section id="trust" class="twocol">
-      <div class="panel"><h2>信任报告</h2><dl class='kv-grid'><div><dt>Secret</dt><dd>0</dd></div><div><dt>脚本数</dt><dd>69</dd></div><div><dt>网络脚本</dt><dd>3</dd></div><div><dt>Help 失败</dt><dd>0</dd></div><div><dt>包体哈希</dt><dd><code>44d9cb1aa096fff1b2c8844a609574c05c8ed9ae12005dc74a5662d3d94013fd</code></dd></div></dl></div>
+      <div class="panel"><h2>信任报告</h2><dl class='kv-grid'><div><dt>Secret</dt><dd>0</dd></div><div><dt>脚本数</dt><dd>70</dd></div><div><dt>网络脚本</dt><dd>3</dd></div><div><dt>Help 失败</dt><dd>0</dd></div><div><dt>包体哈希</dt><dd><code>495c5824cf84b56ef77bebc75e415191425e2f1131f0a4027d17037631b52fa2</code></dd></div></dl></div>
       <div class="panel"><h2>安全边界</h2><p>高风险 secret、远程 inline execution、缺失依赖策略或无法解释的脚本接口应阻断 governed release。</p></div>
     </section>
 
@@ -333,8 +333,8 @@
     </section>
 
     <section id="telemetry" class="twocol">
-      <div class="panel"><h2>运营回路</h2><p>1 metadata events; adoption 100.0; missed 0; bad-output 0; risk low</p></div>
-      <div class="panel"><h2>漂移信号</h2><dl class='kv-grid'><div><dt>事件数</dt><dd>1</dd></div><div><dt>采用率</dt><dd>100</dd></div><div><dt>漏触发</dt><dd>0</dd></div><div><dt>Bad Output Count</dt><dd>0</dd></div><div><dt>风险带</dt><dd>low</dd></div></dl></div>
+      <div class="panel"><h2>运营回路</h2><p>1 metadata events; adoption 0; missed 0; bad-output 0; risk low</p></div>
+      <div class="panel"><h2>漂移信号</h2><dl class='kv-grid'><div><dt>事件数</dt><dd>1</dd></div><div><dt>采用率</dt><dd>0</dd></div><div><dt>漏触发</dt><dd>0</dd></div><div><dt>Bad Output Count</dt><dd>0</dd></div><div><dt>风险带</dt><dd>low</dd></div></dl></div>
     </section>
 
     <section id="waivers" class="twocol">
@@ -344,12 +344,12 @@
 
     <section id="registry" class="twocol">
       <div class="panel"><h2>注册审计</h2><p>yao-meta-skill 1.1.0; 6/6 compatibility entries pass; install pass with 4 adapters; installer permissions 12 enforced / 0 failures</p></div>
-      <div class="panel"><h2>包体元数据</h2><dl class='kv-grid'><div><dt>名称</dt><dd>yao-meta-skill</dd></div><div><dt>版本</dt><dd>1.1.0</dd></div><div><dt>Maturity</dt><dd>governed</dd></div><div><dt>Owner</dt><dd>Yao Team</dd></div><div><dt>License</dt><dd>MIT</dd></div><div><dt>信任级别</dt><dd>local</dd></div><div><dt>目标平台</dt><dd>openai, claude, generic, agent-skills-compatible, vscode</dd></div><div><dt>兼容通过</dt><dd>6/6</dd></div><div><dt>归档哈希</dt><dd><code>cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933</code></dd></div></dl></div>
+      <div class="panel"><h2>包体元数据</h2><dl class='kv-grid'><div><dt>名称</dt><dd>yao-meta-skill</dd></div><div><dt>版本</dt><dd>1.1.0</dd></div><div><dt>Maturity</dt><dd>governed</dd></div><div><dt>Owner</dt><dd>Yao Team</dd></div><div><dt>License</dt><dd>MIT</dd></div><div><dt>信任级别</dt><dd>local</dd></div><div><dt>目标平台</dt><dd>openai, claude, generic, agent-skills-compatible, vscode</dd></div><div><dt>兼容通过</dt><dd>6/6</dd></div><div><dt>归档哈希</dt><dd><code>0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474</code></dd></div></dl></div>
     </section>
 
     <section id="release" class="twocol">
       <div class="panel"><h2>发布路线</h2><p>0 promote; 3 keep current; 0 blocked; upgrade minor declared / minor recommended</p></div>
-      <div class="panel"><h2>包体验证</h2><dl class='kv-grid'><div><dt>目标数</dt><dd>4</dd></div><div><dt>Adapter</dt><dd>4</dd></div><div><dt>归档存在</dt><dd>是</dd></div><div><dt>Zip 条目</dt><dd>494</dd></div><div><dt>失败数</dt><dd>0</dd></div><div><dt>警告数</dt><dd>0</dd></div><div><dt>归档哈希</dt><dd><code>cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933</code></dd></div></dl></div>
+      <div class="panel"><h2>包体验证</h2><dl class='kv-grid'><div><dt>目标数</dt><dd>4</dd></div><div><dt>Adapter</dt><dd>4</dd></div><div><dt>归档存在</dt><dd>是</dd></div><div><dt>Zip 条目</dt><dd>495</dd></div><div><dt>失败数</dt><dd>0</dd></div><div><dt>警告数</dt><dd>0</dd></div><div><dt>归档哈希</dt><dd><code>0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474</code></dd></div></dl></div>
     </section>
 
     <section class="twocol">
diff --git a/reports/review-studio.json b/reports/review-studio.json
index c849859..0e0b726 100644
--- a/reports/review-studio.json
+++ b/reports/review-studio.json
@@ -59,7 +59,7 @@
       "key": "trust-report",
       "label": "信任报告",
       "status": "pass",
-      "detail": "0 secrets; 69 scripts; 3 network-capable scripts; 0 help smoke failures",
+      "detail": "0 secrets; 70 scripts; 3 network-capable scripts; 0 help smoke failures",
       "evidence": "reports/security_trust_report.json",
       "link": "security_trust_report.md"
     },
@@ -91,7 +91,7 @@
       "key": "operations-loop",
       "label": "运营回路",
       "status": "pass",
-      "detail": "1 metadata events; adoption 100.0; missed 0; bad-output 0; risk low",
+      "detail": "1 metadata events; adoption 0; missed 0; bad-output 0; risk low",
       "evidence": "reports/adoption_drift_report.json",
       "link": "adoption_drift_report.md"
     },
@@ -355,7 +355,7 @@
           "label": "上下文成本",
           "score": 42,
           "reasons": [
-            "入口约 350 个词/字，references 约 14711 个词/字。",
+            "入口约 350 个词/字，references 约 14859 个词/字。",
             "分数越高代表上下文成本越低。",
             "上下文成本偏高，建议压缩入口或拆分 references。"
           ]
@@ -459,7 +459,7 @@
           "已生成 Output Review Adjudication，可记录盲评决策、一致率和待评审项。"
         ],
         "gaps": [
-          "上下文成本需要补强：入口约 350 个词/字，references 约 14711 个词/字。"
+          "上下文成本需要补强：入口约 350 个词/字，references 约 14859 个词/字。"
         ],
         "recommendations": [
           "先改触发边界，再扩展工作流。",
@@ -692,7 +692,7 @@
             "path": "scripts",
             "label": "Deterministic helpers or local tooling",
             "kind": "folder",
-            "file_count": 69
+            "file_count": 70
           },
           {
             "path": "evals",
@@ -707,7 +707,7 @@
             "file_count": 171
           }
         ],
-        "file_count": 304,
+        "file_count": 305,
         "folder_count": 4,
         "distribution": [
           {
@@ -732,7 +732,7 @@
           },
           {
             "label": "scripts",
-            "value": 69
+            "value": 70
           },
           {
             "label": "evals",
@@ -861,7 +861,7 @@
           "path": "scripts",
           "label": "Deterministic helpers or local tooling",
           "kind": "folder",
-          "file_count": 69
+          "file_count": 70
         },
         {
           "path": "evals",
@@ -1207,9 +1207,9 @@
         "failures": []
       },
       "trust_security": {
-        "scanned_files": 153,
-        "script_count": 69,
-        "internal_module_count": 9,
+        "scanned_files": 154,
+        "script_count": 70,
+        "internal_module_count": 10,
         "secret_findings": 0,
         "dependency_files": [
           "requirements-ci.txt"
@@ -1227,8 +1227,8 @@
         "help_smoke_failed_count": 0,
         "interactive_script_count": 0,
         "package_hash_scope": "source-contract-without-generated-reports",
-        "package_hash_file_count": 153,
-        "package_sha256": "44d9cb1aa096fff1b2c8844a609574c05c8ed9ae12005dc74a5662d3d94013fd"
+        "package_hash_file_count": 154,
+        "package_sha256": "495c5824cf84b56ef77bebc75e415191425e2f1131f0a4027d17037631b52fa2"
       },
       "skill_atlas": {
         "skill_count": 12,
@@ -1266,8 +1266,8 @@
           "trust_level": "local",
           "license": "MIT",
           "checksums": {
-            "package_sha256": "44d9cb1aa096fff1b2c8844a609574c05c8ed9ae12005dc74a5662d3d94013fd",
-            "archive_sha256": "cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933"
+            "package_sha256": "495c5824cf84b56ef77bebc75e415191425e2f1131f0a4027d17037631b52fa2",
+            "archive_sha256": "0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474"
           },
           "compatibility": {
             "openai": "pass",
@@ -1298,7 +1298,7 @@
           },
           "distribution": {
             "archive_verified": true,
-            "archive_sha256": "cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933",
+            "archive_sha256": "0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474",
             "package_verification": "reports/package_verification.json",
             "install_simulated": true,
             "install_simulation": "reports/install_simulation.json"
@@ -1314,8 +1314,8 @@
           "target_count": 4,
           "adapter_count": 4,
           "archive_present": true,
-          "archive_sha256": "cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933",
-          "archive_entry_count": 494,
+          "archive_sha256": "0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474",
+          "archive_entry_count": 495,
           "failure_count": 0,
           "warning_count": 0
         },
@@ -1326,7 +1326,7 @@
         "ok": true,
         "summary": {
           "archive_present": true,
-          "archive_entry_count": 494,
+          "archive_entry_count": 495,
           "archive_extracted": true,
           "entrypoint_loaded": true,
           "manifest_loaded": true,
@@ -1393,12 +1393,12 @@
             {
               "field": "archive_sha256",
               "from": "",
-              "to": "cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933"
+              "to": "0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474"
             },
             {
               "field": "package_sha256",
               "from": "0000000000000000000000000000000000000000000000000000000000000000",
-              "to": "44d9cb1aa096fff1b2c8844a609574c05c8ed9ae12005dc74a5662d3d94013fd"
+              "to": "495c5824cf84b56ef77bebc75e415191425e2f1131f0a4027d17037631b52fa2"
             }
           ]
         },
@@ -1415,14 +1415,14 @@
         "ok": true,
         "summary": {
           "event_count": 1,
-          "adoption_sample_count": 1,
-          "activation_count": 1,
-          "accepted_count": 1,
+          "adoption_sample_count": 0,
+          "activation_count": 0,
+          "accepted_count": 0,
           "edited_count": 0,
           "rejected_count": 0,
           "missed_count": 0,
           "failed_count": 0,
-          "adoption_rate": 100.0,
+          "adoption_rate": 0,
           "missed_trigger_count": 0,
           "wrong_trigger_count": 0,
           "bad_output_count": 0,
@@ -1431,9 +1431,13 @@
           "review_overdue_count": 0,
           "risk_band": "low",
           "event_types": {
-            "skill_activation": 1
+            "review_event": 1
           },
-          "failure_types": {}
+          "failure_types": {},
+          "source_types": {
+            "manual": 1
+          },
+          "command_counts": {}
         },
         "next_iteration_candidates": [],
         "privacy_contract": {
@@ -3128,7 +3132,7 @@
           "execution_mode": "command",
           "model_executed": false,
           "command_executed": true,
-          "duration_ms": 33.6,
+          "duration_ms": 31.15,
           "provider": "local-output-eval-runner",
           "model": "",
           "usage": {
@@ -3156,7 +3160,7 @@
           "execution_mode": "command",
           "model_executed": false,
           "command_executed": true,
-          "duration_ms": 33.9,
+          "duration_ms": 31.4,
           "provider": "local-output-eval-runner",
           "model": "",
           "usage": {
@@ -3179,7 +3183,7 @@
           "execution_mode": "command",
           "model_executed": false,
           "command_executed": true,
-          "duration_ms": 37.17,
+          "duration_ms": 33.61,
           "provider": "local-output-eval-runner",
           "model": "",
           "usage": {
@@ -3207,7 +3211,7 @@
           "execution_mode": "command",
           "model_executed": false,
           "command_executed": true,
-          "duration_ms": 49.26,
+          "duration_ms": 33.86,
           "provider": "local-output-eval-runner",
           "model": "",
           "usage": {
@@ -3230,7 +3234,7 @@
           "execution_mode": "command",
           "model_executed": false,
           "command_executed": true,
-          "duration_ms": 32.41,
+          "duration_ms": 33.02,
           "provider": "local-output-eval-runner",
           "model": "",
           "usage": {
@@ -3258,7 +3262,7 @@
           "execution_mode": "command",
           "model_executed": false,
           "command_executed": true,
-          "duration_ms": 33.26,
+          "duration_ms": 31.39,
           "provider": "local-output-eval-runner",
           "model": "",
           "usage": {
@@ -3281,7 +3285,7 @@
           "execution_mode": "command",
           "model_executed": false,
           "command_executed": true,
-          "duration_ms": 33.85,
+          "duration_ms": 30.77,
           "provider": "local-output-eval-runner",
           "model": "",
           "usage": {
@@ -3308,7 +3312,7 @@
           "execution_mode": "command",
           "model_executed": false,
           "command_executed": true,
-          "duration_ms": 34.38,
+          "duration_ms": 32.92,
           "provider": "local-output-eval-runner",
           "model": "",
           "usage": {
@@ -3331,7 +3335,7 @@
           "execution_mode": "command",
           "model_executed": false,
           "command_executed": true,
-          "duration_ms": 34.12,
+          "duration_ms": 29.09,
           "provider": "local-output-eval-runner",
           "model": "",
           "usage": {
@@ -3360,7 +3364,7 @@
           "execution_mode": "command",
           "model_executed": false,
           "command_executed": true,
-          "duration_ms": 34.95,
+          "duration_ms": 27.95,
           "provider": "local-output-eval-runner",
           "model": "",
           "usage": {
@@ -3882,7 +3886,8 @@
                 "scripts/verify_package.py",
                 "scripts/yao.py",
                 "scripts/yao_cli_config.py",
-                "scripts/yao_cli_parser.py"
+                "scripts/yao_cli_parser.py",
+                "scripts/yao_cli_telemetry.py"
               ],
               "assets": [
                 "templates/basic_skill.md.j2",
@@ -3933,7 +3938,7 @@
               ],
               "counts": {
                 "references": 32,
-                "scripts": 69,
+                "scripts": 70,
                 "assets": 2,
                 "reports": 41
               }
@@ -4174,7 +4179,7 @@
                 "strategy": "Ship the neutral source tree and expose OpenAI-facing interface metadata as a generated companion file.",
                 "counts": {
                   "references": 32,
-                  "scripts": 69,
+                  "scripts": 70,
                   "assets": 2,
                   "reports": 41
                 },
@@ -4185,7 +4190,7 @@
               },
               "scripts": {
                 "strategy": "Keep scripts as local package resources; expose help-smoke and permission metadata for reviewer approval before execution.",
-                "script_count": 69,
+                "script_count": 70,
                 "help_smoke_failed_count": 0
               },
               "permissions": {
@@ -4399,7 +4404,7 @@
               "strategy": "Ship the neutral source tree and expose OpenAI-facing interface metadata as a generated companion file.",
               "counts": {
                 "references": 32,
-                "scripts": 69,
+                "scripts": 70,
                 "assets": 2,
                 "reports": 41
               },
@@ -4410,7 +4415,7 @@
             },
             "scripts": {
               "strategy": "Keep scripts as local package resources; expose help-smoke and permission metadata for reviewer approval before execution.",
-              "script_count": 69,
+              "script_count": 70,
               "help_smoke_failed_count": 0
             },
             "permissions": {
@@ -4680,7 +4685,8 @@
                 "scripts/verify_package.py",
                 "scripts/yao.py",
                 "scripts/yao_cli_config.py",
-                "scripts/yao_cli_parser.py"
+                "scripts/yao_cli_parser.py",
+                "scripts/yao_cli_telemetry.py"
               ],
               "assets": [
                 "templates/basic_skill.md.j2",
@@ -4731,7 +4737,7 @@
               ],
               "counts": {
                 "references": 32,
-                "scripts": 69,
+                "scripts": 70,
                 "assets": 2,
                 "reports": 41
               }
@@ -4972,7 +4978,7 @@
                 "strategy": "Preserve the source tree directly; write target notes in targets/claude/README.md.",
                 "counts": {
                   "references": 32,
-                  "scripts": 69,
+                  "scripts": 70,
                   "assets": 2,
                   "reports": 41
                 },
@@ -4983,7 +4989,7 @@
               },
               "scripts": {
                 "strategy": "Scripts remain local package resources and must be reviewed through trust and permission reports before use.",
-                "script_count": 69,
+                "script_count": 70,
                 "help_smoke_failed_count": 0
               },
               "permissions": {
@@ -5197,7 +5203,7 @@
               "strategy": "Preserve the source tree directly; write target notes in targets/claude/README.md.",
               "counts": {
                 "references": 32,
-                "scripts": 69,
+                "scripts": 70,
                 "assets": 2,
                 "reports": 41
               },
@@ -5208,7 +5214,7 @@
             },
             "scripts": {
               "strategy": "Scripts remain local package resources and must be reviewed through trust and permission reports before use.",
-              "script_count": 69,
+              "script_count": 70,
               "help_smoke_failed_count": 0
             },
             "permissions": {
@@ -5478,7 +5484,8 @@
                 "scripts/verify_package.py",
                 "scripts/yao.py",
                 "scripts/yao_cli_config.py",
-                "scripts/yao_cli_parser.py"
+                "scripts/yao_cli_parser.py",
+                "scripts/yao_cli_telemetry.py"
               ],
               "assets": [
                 "templates/basic_skill.md.j2",
@@ -5529,7 +5536,7 @@
               ],
               "counts": {
                 "references": 32,
-                "scripts": 69,
+                "scripts": 70,
                 "assets": 2,
                 "reports": 41
               }
@@ -5770,7 +5777,7 @@
                 "strategy": "Preserve references, scripts, assets, evals, reports, and adapter metadata as relative package resources.",
                 "counts": {
                   "references": 32,
-                  "scripts": 69,
+                  "scripts": 70,
                   "assets": 2,
                   "reports": 41
                 },
@@ -5780,7 +5787,7 @@
               },
               "scripts": {
                 "strategy": "Expose script and permission metadata for downstream clients or installers to enforce.",
-                "script_count": 69,
+                "script_count": 70,
                 "help_smoke_failed_count": 0
               },
               "permissions": {
@@ -5988,7 +5995,7 @@
               "strategy": "Preserve references, scripts, assets, evals, reports, and adapter metadata as relative package resources.",
               "counts": {
                 "references": 32,
-                "scripts": 69,
+                "scripts": 70,
                 "assets": 2,
                 "reports": 41
               },
@@ -5998,7 +6005,7 @@
             },
             "scripts": {
               "strategy": "Expose script and permission metadata for downstream clients or installers to enforce.",
-              "script_count": 69,
+              "script_count": 70,
               "help_smoke_failed_count": 0
             },
             "permissions": {
@@ -6260,7 +6267,8 @@
                 "scripts/verify_package.py",
                 "scripts/yao.py",
                 "scripts/yao_cli_config.py",
-                "scripts/yao_cli_parser.py"
+                "scripts/yao_cli_parser.py",
+                "scripts/yao_cli_telemetry.py"
               ],
               "assets": [
                 "templates/basic_skill.md.j2",
@@ -6311,7 +6319,7 @@
               ],
               "counts": {
                 "references": 32,
-                "scripts": 69,
+                "scripts": 70,
                 "assets": 2,
                 "reports": 41
               }
@@ -6552,7 +6560,7 @@
                 "strategy": "Keep optional directories as relative resources next to SKILL.md.",
                 "counts": {
                   "references": 32,
-                  "scripts": 69,
+                  "scripts": 70,
                   "assets": 2,
                   "reports": 41
                 },
@@ -6563,7 +6571,7 @@
               },
               "scripts": {
                 "strategy": "Scripts remain local optional resources and should advertise --help when executable.",
-                "script_count": 69,
+                "script_count": 70,
                 "help_smoke_failed_count": 0
               },
               "permissions": {
@@ -6770,7 +6778,7 @@
               "strategy": "Keep optional directories as relative resources next to SKILL.md.",
               "counts": {
                 "references": 32,
-                "scripts": 69,
+                "scripts": 70,
                 "assets": 2,
                 "reports": 41
               },
@@ -6781,7 +6789,7 @@
             },
             "scripts": {
               "strategy": "Scripts remain local optional resources and should advertise --help when executable.",
-              "script_count": 69,
+              "script_count": 70,
               "help_smoke_failed_count": 0
             },
             "permissions": {
@@ -7042,7 +7050,8 @@
                 "scripts/verify_package.py",
                 "scripts/yao.py",
                 "scripts/yao_cli_config.py",
-                "scripts/yao_cli_parser.py"
+                "scripts/yao_cli_parser.py",
+                "scripts/yao_cli_telemetry.py"
               ],
               "assets": [
                 "templates/basic_skill.md.j2",
@@ -7093,7 +7102,7 @@
               ],
               "counts": {
                 "references": 32,
-                "scripts": 69,
+                "scripts": 70,
                 "assets": 2,
                 "reports": 41
               }
@@ -7334,7 +7343,7 @@
                 "strategy": "Install as project or user scoped skill source, preserving relative references and scripts.",
                 "counts": {
                   "references": 32,
-                  "scripts": 69,
+                  "scripts": 70,
                   "assets": 2,
                   "reports": 41
                 },
@@ -7345,7 +7354,7 @@
               },
               "scripts": {
                 "strategy": "Scripts require workspace trust and operator/client approval outside this compiler.",
-                "script_count": 69,
+                "script_count": 70,
                 "help_smoke_failed_count": 0
               },
               "permissions": {
@@ -7556,7 +7565,7 @@
               "strategy": "Install as project or user scoped skill source, preserving relative references and scripts.",
               "counts": {
                 "references": 32,
-                "scripts": 69,
+                "scripts": 70,
                 "assets": 2,
                 "reports": 41
               },
@@ -7567,7 +7576,7 @@
             },
             "scripts": {
               "strategy": "Scripts require workspace trust and operator/client approval outside this compiler.",
-              "script_count": 69,
+              "script_count": 70,
               "help_smoke_failed_count": 0
             },
             "permissions": {
@@ -8207,9 +8216,9 @@
       "ok": true,
       "skill_dir": ".",
       "summary": {
-        "scanned_files": 153,
-        "script_count": 69,
-        "internal_module_count": 9,
+        "scanned_files": 154,
+        "script_count": 70,
+        "internal_module_count": 10,
         "secret_findings": 0,
         "dependency_files": [
           "requirements-ci.txt"
@@ -8227,8 +8236,8 @@
         "help_smoke_failed_count": 0,
         "interactive_script_count": 0,
         "package_hash_scope": "source-contract-without-generated-reports",
-        "package_hash_file_count": 153,
-        "package_sha256": "44d9cb1aa096fff1b2c8844a609574c05c8ed9ae12005dc74a5662d3d94013fd"
+        "package_hash_file_count": 154,
+        "package_sha256": "495c5824cf84b56ef77bebc75e415191425e2f1131f0a4027d17037631b52fa2"
       },
       "failures": [],
       "warnings": [],
@@ -9216,6 +9225,20 @@
           "uses_subprocess": false,
           "network_urls": [],
           "network_hosts": []
+        },
+        {
+          "path": "scripts/yao_cli_telemetry.py",
+          "interface": "internal-module",
+          "interface_declared": true,
+          "interface_reason": "Imported by yao.py to record opt-in metadata-only CLI run telemetry.",
+          "has_argparse": true,
+          "has_main_guard": false,
+          "uses_input": false,
+          "uses_network": false,
+          "uses_file_write": false,
+          "uses_subprocess": false,
+          "network_urls": [],
+          "network_hosts": []
         }
       ],
       "dependencies": {
@@ -9252,7 +9275,7 @@
         "checked_count": 60,
         "passed_count": 60,
         "failed_count": 0,
-        "skipped_count": 9,
+        "skipped_count": 10,
         "failed_scripts": [],
         "results": [
           {
@@ -9852,7 +9875,7 @@
             "timed_out": false,
             "passed": true,
             "has_help_text": true,
-            "stdout_excerpt": "usage: yao.py [-h]\n              {init,quickstart,validate,optimize-description,promote-check,review,release-snapshot,workspace-flow,report,skill-report,review-viewer,review-studio,reference-scan,github-benchmark-scan,intent-confidence,inte",
+            "stdout_excerpt": "usage: yao.py [-h] [--record-cli-telemetry] [--no-cli-telemetry]\n              [--telemetry-events-jsonl TELEMETRY_EVENTS_JSONL]\n              {init,quickstart,validate,optimize-description,promote-check,review,release-snapshot,workspace-fl",
             "stderr_excerpt": ""
           }
         ],
@@ -9892,6 +9915,10 @@
           {
             "path": "scripts/yao_cli_parser.py",
             "reason": "internal module"
+          },
+          {
+            "path": "scripts/yao_cli_telemetry.py",
+            "reason": "internal module"
           }
         ]
       },
@@ -10060,10 +10087,10 @@
         "context_budget_tier": "production",
         "context_budget_limit": 1000,
         "skill_body_tokens": 751,
-        "other_text_tokens": 915033,
+        "other_text_tokens": 917960,
         "estimated_initial_load_tokens": 944,
-        "estimated_total_text_tokens": 915784,
-        "relevant_file_count": 392,
+        "estimated_total_text_tokens": 918711,
+        "relevant_file_count": 394,
         "unused_resource_dirs": [],
         "quality_signal_points": 130,
         "quality_density": 137.7
@@ -10996,6 +11023,7 @@
               "scripts/yao.py",
               "scripts/yao_cli_config.py",
               "scripts/yao_cli_parser.py",
+              "scripts/yao_cli_telemetry.py",
               "references/artifact-design-doctrine.md",
               "references/authoring-discipline.md",
               "references/distribution-registry-method.md",
@@ -11891,7 +11919,7 @@
     "adoption_drift": {
       "ok": true,
       "schema_version": "2.0",
-      "generated_at": "2026-06-13T13:13:24Z",
+      "generated_at": "2026-06-13T13:30:00Z",
       "skill_dir": ".",
       "privacy_contract": {
         "storage": "local-first",
@@ -11915,14 +11943,14 @@
       },
       "summary": {
         "event_count": 1,
-        "adoption_sample_count": 1,
-        "activation_count": 1,
-        "accepted_count": 1,
+        "adoption_sample_count": 0,
+        "activation_count": 0,
+        "accepted_count": 0,
         "edited_count": 0,
         "rejected_count": 0,
         "missed_count": 0,
         "failed_count": 0,
-        "adoption_rate": 100.0,
+        "adoption_rate": 0,
         "missed_trigger_count": 0,
         "wrong_trigger_count": 0,
         "bad_output_count": 0,
@@ -11931,37 +11959,43 @@
         "review_overdue_count": 0,
         "risk_band": "low",
         "event_types": {
-          "skill_activation": 1
+          "review_event": 1
         },
-        "failure_types": {}
+        "failure_types": {},
+        "source_types": {
+          "manual": 1
+        },
+        "command_counts": {}
       },
       "adoption_by_skill": [
         {
           "skill": "yao-meta-skill",
           "events": 1,
-          "adoption_events": 1,
-          "accepted": 1,
+          "adoption_events": 0,
+          "accepted": 0,
           "edited": 0,
           "rejected": 0,
           "missed": 0,
-          "adoption_rate": 100.0
+          "adoption_rate": 0
         }
       ],
       "next_iteration_candidates": [],
       "recent_events": [
         {
-          "event": "skill_activation",
+          "command": "unknown",
+          "event": "review_event",
           "skill": "yao-meta-skill",
+          "source": "manual",
           "version": "1.1.0",
-          "activation_type": "explicit",
-          "outcome": "accepted",
+          "activation_type": "manual",
+          "outcome": "reviewed",
           "failure_type": "none",
-          "timestamp": "2026-06-13T10:00:00Z"
+          "timestamp": "2026-06-13T12:00:00Z"
         }
       ],
       "failures": [],
       "artifacts": {
-        "events_jsonl": "tests/tmp_review_studio/telemetry_events.jsonl",
+        "events_jsonl": "reports/telemetry_events.jsonl",
         "json": "reports/adoption_drift_report.json",
         "markdown": "reports/adoption_drift_report.md"
       }
@@ -12010,7 +12044,7 @@
       "schema_version": "1.0",
       "ok": true,
       "skill_dir": ".",
-      "source": "tests/tmp_review_studio/empty_review_annotations_input.json",
+      "source": "reports/review_annotations_input.json",
       "summary": {
         "annotation_count": 0,
         "open_count": 0,
@@ -12053,8 +12087,8 @@
         "trust_level": "local",
         "license": "MIT",
         "checksums": {
-          "package_sha256": "44d9cb1aa096fff1b2c8844a609574c05c8ed9ae12005dc74a5662d3d94013fd",
-          "archive_sha256": "cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933"
+          "package_sha256": "495c5824cf84b56ef77bebc75e415191425e2f1131f0a4027d17037631b52fa2",
+          "archive_sha256": "0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474"
         },
         "compatibility": {
           "openai": "pass",
@@ -12085,7 +12119,7 @@
         },
         "distribution": {
           "archive_verified": true,
-          "archive_sha256": "cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933",
+          "archive_sha256": "0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474",
           "package_verification": "reports/package_verification.json",
           "install_simulated": true,
           "install_simulation": "reports/install_simulation.json"
@@ -12110,7 +12144,7 @@
               "vscode"
             ],
             "package_metadata": "registry/packages/yao-meta-skill.json",
-            "package_sha256": "44d9cb1aa096fff1b2c8844a609574c05c8ed9ae12005dc74a5662d3d94013fd"
+            "package_sha256": "495c5824cf84b56ef77bebc75e415191425e2f1131f0a4027d17037631b52fa2"
           }
         ]
       },
@@ -12133,8 +12167,8 @@
         "target_count": 4,
         "adapter_count": 4,
         "archive_present": true,
-        "archive_sha256": "cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933",
-        "archive_entry_count": 494,
+        "archive_sha256": "0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474",
+        "archive_entry_count": 495,
         "failure_count": 0,
         "warning_count": 0
       },
@@ -12799,7 +12833,7 @@
       "installed_skill_dir": "dist/install-simulation/simulate-yao-meta-skill/yao-meta-skill",
       "summary": {
         "archive_present": true,
-        "archive_entry_count": 494,
+        "archive_entry_count": 495,
         "archive_extracted": true,
         "entrypoint_loaded": true,
         "manifest_loaded": true,
@@ -13141,12 +13175,12 @@
           {
             "field": "archive_sha256",
             "from": "",
-            "to": "cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933"
+            "to": "0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474"
           },
           {
             "field": "package_sha256",
             "from": "0000000000000000000000000000000000000000000000000000000000000000",
-            "to": "44d9cb1aa096fff1b2c8844a609574c05c8ed9ae12005dc74a5662d3d94013fd"
+            "to": "495c5824cf84b56ef77bebc75e415191425e2f1131f0a4027d17037631b52fa2"
           }
         ]
       },
diff --git a/reports/review_annotations.json b/reports/review_annotations.json
index 66f2b1d..76fadc1 100644
--- a/reports/review_annotations.json
+++ b/reports/review_annotations.json
@@ -2,7 +2,7 @@
   "schema_version": "1.0",
   "ok": true,
   "skill_dir": ".",
-  "source": "tests/tmp_review_studio/empty_review_annotations_input.json",
+  "source": "reports/review_annotations_input.json",
   "summary": {
     "annotation_count": 0,
     "open_count": 0,
diff --git a/reports/security_trust_report.json b/reports/security_trust_report.json
index 10219c2..3d7d373 100644
--- a/reports/security_trust_report.json
+++ b/reports/security_trust_report.json
@@ -2,9 +2,9 @@
   "ok": true,
   "skill_dir": ".",
   "summary": {
-    "scanned_files": 153,
-    "script_count": 69,
-    "internal_module_count": 9,
+    "scanned_files": 154,
+    "script_count": 70,
+    "internal_module_count": 10,
     "secret_findings": 0,
     "dependency_files": [
       "requirements-ci.txt"
@@ -22,8 +22,8 @@
     "help_smoke_failed_count": 0,
     "interactive_script_count": 0,
     "package_hash_scope": "source-contract-without-generated-reports",
-    "package_hash_file_count": 153,
-    "package_sha256": "44d9cb1aa096fff1b2c8844a609574c05c8ed9ae12005dc74a5662d3d94013fd"
+    "package_hash_file_count": 154,
+    "package_sha256": "495c5824cf84b56ef77bebc75e415191425e2f1131f0a4027d17037631b52fa2"
   },
   "failures": [],
   "warnings": [],
@@ -1011,6 +1011,20 @@
       "uses_subprocess": false,
       "network_urls": [],
       "network_hosts": []
+    },
+    {
+      "path": "scripts/yao_cli_telemetry.py",
+      "interface": "internal-module",
+      "interface_declared": true,
+      "interface_reason": "Imported by yao.py to record opt-in metadata-only CLI run telemetry.",
+      "has_argparse": true,
+      "has_main_guard": false,
+      "uses_input": false,
+      "uses_network": false,
+      "uses_file_write": false,
+      "uses_subprocess": false,
+      "network_urls": [],
+      "network_hosts": []
     }
   ],
   "dependencies": {
@@ -1047,7 +1061,7 @@
     "checked_count": 60,
     "passed_count": 60,
     "failed_count": 0,
-    "skipped_count": 9,
+    "skipped_count": 10,
     "failed_scripts": [],
     "results": [
       {
@@ -1647,7 +1661,7 @@
         "timed_out": false,
         "passed": true,
         "has_help_text": true,
-        "stdout_excerpt": "usage: yao.py [-h]\n              {init,quickstart,validate,optimize-description,promote-check,review,release-snapshot,workspace-flow,report,skill-report,review-viewer,review-studio,reference-scan,github-benchmark-scan,intent-confidence,inte",
+        "stdout_excerpt": "usage: yao.py [-h] [--record-cli-telemetry] [--no-cli-telemetry]\n              [--telemetry-events-jsonl TELEMETRY_EVENTS_JSONL]\n              {init,quickstart,validate,optimize-description,promote-check,review,release-snapshot,workspace-fl",
         "stderr_excerpt": ""
       }
     ],
@@ -1687,6 +1701,10 @@
       {
         "path": "scripts/yao_cli_parser.py",
         "reason": "internal module"
+      },
+      {
+        "path": "scripts/yao_cli_telemetry.py",
+        "reason": "internal module"
       }
     ]
   },
diff --git a/reports/security_trust_report.md b/reports/security_trust_report.md
index 1919ce0..094edde 100644
--- a/reports/security_trust_report.md
+++ b/reports/security_trust_report.md
@@ -1,9 +1,9 @@
 # Security Trust Report
 
 - OK: `True`
-- Scanned files: `153`
-- Scripts: `69`
-- Internal script modules: `9`
+- Scanned files: `154`
+- Scripts: `70`
+- Internal script modules: `10`
 - Secret findings: `0`
 - Network-capable scripts: `3`
 - Network policy covered scripts: `3`
@@ -15,8 +15,8 @@
 - CLI help smoke failures: `0`
 - Interactive scripts: `0`
 - Package hash scope: `source-contract-without-generated-reports`
-- Package hash files: `153`
-- Package SHA256: `44d9cb1aa096fff1b2c8844a609574c05c8ed9ae12005dc74a5662d3d94013fd`
+- Package hash files: `154`
+- Package SHA256: `495c5824cf84b56ef77bebc75e415191425e2f1131f0a4027d17037631b52fa2`
 
 ## Failures
 
@@ -131,3 +131,4 @@
 | scripts/yao.py | cli | False | True | True | False | False | False | True | Default CLI classification; add SCRIPT_INTERFACE for internal modules. |
 | scripts/yao_cli_config.py | internal-module | True | False | False | False | False | False | False | Imported by yao.py for CLI target maps and side-effect-free shaping helpers. |
 | scripts/yao_cli_parser.py | internal-module | True | True | False | False | False | False | False | Imported by yao.py to keep CLI parser declarations separate from command orchestration. |
+| scripts/yao_cli_telemetry.py | internal-module | True | True | False | False | False | False | False | Imported by yao.py to record opt-in metadata-only CLI run telemetry. |
diff --git a/reports/skill-os-2-review.md b/reports/skill-os-2-review.md
index 7fee917..0e47bc9 100644
--- a/reports/skill-os-2-review.md
+++ b/reports/skill-os-2-review.md
@@ -22,6 +22,7 @@ Yao Meta Skill is no longer only a Meta Skill factory. The current working tree
 - Install Simulation v0 for local extraction, entrypoint loading, interface loading, report presence, adapter readability, and installer-level permission approval/enforcement checks.
 - Upgrade Check v0 for registry package diffs, semver bump recommendations, breaking-change notes, and release evidence.
 - Adoption Drift v0 for local-first metadata-only telemetry, privacy-field blocking, usage-signal aggregation, iteration candidate generation, and Skill Atlas drift-signal input.
+- CLI Telemetry Capture v0 for opt-in `yao.py` command-run metadata that records command name, source, outcome, failure class, and timestamp without command arguments or raw user/model content.
 - Review Waivers v0 for human warning acceptance with reviewer, reason, scope, expiry, and blocker-safe policy.
 - Governed Permission Gates v0 for reviewer-approved network, file-write, and subprocess capabilities with scope, reason, expiry, evidence, and target-enforcement mapping.
 - Runtime Permission Probes v0 for packaged target adapter checks, explicit native-enforcement flags, metadata fallback evidence, and residual permission risks.
@@ -33,7 +34,7 @@ Yao Meta Skill is no longer only a Meta Skill factory. The current working tree
 - Output Review Adjudication now preserves blind-review integrity by hiding expected winners for pending or invalid reviewer decisions; answer keys are revealed only after a valid A/B decision exists for that case.
 - Provider Output Eval Runner v0 so `python3 scripts/yao.py output-exec --provider-runner openai` can collect real provider-backed model evidence through a reviewed OpenAI Responses API compatible runner instead of ad hoc shell glue.
 
-This is still not the final world-class state. Target-native behavior contracts are now explicit, VS Code / Copilot package metadata is auditable, local output-eval command execution is wired, blind-review answers remain hidden until valid decisions exist, a provider-backed output runner exists, installer-level permission coverage is now locally enforced during install simulation and local install sync, and Skill Atlas now consumes aggregate drift reports. Review Studio keeps pending human adjudication visible as a warning instead of treating it as a clean pass. Deeper provider-native execution transforms, real client telemetry capture, provider-native installer integration, real provider holdout runs, real human adjudication decisions, and native runtime permission enforcement remain open.
+This is still not the final world-class state. Target-native behavior contracts are now explicit, VS Code / Copilot package metadata is auditable, local output-eval command execution is wired, blind-review answers remain hidden until valid decisions exist, a provider-backed output runner exists, installer-level permission coverage is now locally enforced during install simulation and local install sync, opt-in `yao.py` CLI telemetry can capture metadata-only real run signals, and Skill Atlas now consumes aggregate drift reports. Review Studio keeps pending human adjudication visible as a warning instead of treating it as a clean pass. Deeper provider-native execution transforms, external client telemetry capture, provider-native installer integration, real provider holdout runs, real human adjudication decisions, and native runtime permission enforcement remain open.
 
 ## Coverage Matrix
 
@@ -54,7 +55,7 @@ This is still not the final world-class state. Target-native behavior contracts
 | Install Simulation | `scripts/simulate_install.py`, `reports/install_simulation.md`, `tests/verify_install_simulation.py` with installer permission coverage checks | v0 landed |
 | Local Install Sync Preflight | `scripts/sync_local_install.py`, `tests/verify_local_install_sync.py`, `Makefile` package-check prerequisites | v0 landed |
 | Upgrade Check | `scripts/upgrade_check.py`, `reports/upgrade_check.md`, `tests/verify_upgrade_check.py` | v0 landed |
-| Telemetry & Drift | `scripts/render_adoption_drift_report.py`, `reports/adoption_drift_report.md`, `tests/verify_adoption_drift.py`, `references/telemetry-drift-method.md` | v0 landed |
+| Telemetry & Drift | `scripts/render_adoption_drift_report.py`, `scripts/yao_cli_telemetry.py`, `reports/adoption_drift_report.md`, `tests/verify_adoption_drift.py`, `tests/verify_yao_cli.py`, `references/telemetry-drift-method.md` | v0 landed |
 | Review Waivers | `scripts/render_review_waivers.py`, `reports/review_waivers.md`, `tests/verify_review_waivers.py`, `references/review-waiver-method.md` | v0 landed |
 | Governed Permission Gates | `security/permission_policy.json`, `scripts/trust_check.py`, `scripts/render_review_studio.py`, `tests/verify_trust_check.py`, `tests/verify_review_studio.py` | v0 landed |
 | Runtime Permission Probes | `scripts/probe_runtime_permissions.py`, `reports/runtime_permission_probes.md`, `tests/verify_runtime_permission_probes.py`, `tests/verify_review_studio.py` | v0 landed |
@@ -84,9 +85,9 @@ Next move: add richer source-line anchors inside generated reports and record re
 
 ### 4. Multi-skill operation now links Atlas with drift, but needs real client capture
 
-The new Skill Atlas can scan a workspace and report catalog, route overlap, dependency graph, stale skill, missing owner/review metadata, aggregate drift signals, and no-route opportunities. It now also supports `skill_atlas/policy.json` so release gates distinguish actionable library skills from examples and fixtures while keeping full visibility. Adoption Drift v0 can record metadata-only local events, block raw prompt/output fields, summarize missed-trigger, bad-output, script-error, and review-overdue signals, feed next iteration candidates into Review Studio, and publish aggregate drift input for Atlas. It still needs real client-side capture instead of manual CLI event recording.
+The new Skill Atlas can scan a workspace and report catalog, route overlap, dependency graph, stale skill, missing owner/review metadata, aggregate drift signals, and no-route opportunities. It now also supports `skill_atlas/policy.json` so release gates distinguish actionable library skills from examples and fixtures while keeping full visibility. Adoption Drift v0 can record metadata-only local events, block raw prompt/output fields, summarize missed-trigger, bad-output, script-error, and review-overdue signals, feed next iteration candidates into Review Studio, and publish aggregate drift input for Atlas. `yao.py` now adds opt-in automatic CLI run capture through `YAO_CLI_TELEMETRY=1` or `--record-cli-telemetry`, recording only `source=yao_cli`, normalized subcommand name, outcome, failure class, and timestamp. It still needs external client-side capture beyond the local CLI.
 
-Next move: connect client activations and failure history so Atlas can rank stale, drifting, or conflicting skills by real usage impact.
+Next move: connect non-CLI client activations and failure history so Atlas can rank stale, drifting, or conflicting skills by real usage impact.
 
 ### 5. Trust report is structural, not full security review
 
@@ -106,11 +107,11 @@ Next move: add real client or installer permission enforcement integration.
 | Runtime Permission Probes | `4 / 4` target adapters probed, `0` native-enforcement adapters, `4` explicit metadata fallbacks, `4` residual risks retained for reviewer visibility |
 | Skill Atlas | `12` scanned skills, `1` actionable root skill, `1` telemetry report, `0` actionable route collisions, `0` actionable owner gaps, `0` actionable stale skills, `0` actionable drift signals, `24` scoped non-actionable issue signals retained for visibility |
 | Registry Audit | package metadata generated with version, owner, license, source checksum, archive checksum, Skill IR provenance, and compatibility matrix |
-| Package Verification | `4 / 4` target adapters present, archive verified, `494` zip entries, `0` failures, `0` warnings |
-| Install Simulation | archive with `494` entries extracted into a local verification root, entrypoint/manifest/interface loaded, reports present, `4` adapters readable, `12` installer permission checks enforced, `0` permission failures, `0` failures, `0` warnings |
+| Package Verification | `4 / 4` target adapters present, archive verified, `495` zip entries, `0` failures, `0` warnings |
+| Install Simulation | archive with `495` entries extracted into a local verification root, entrypoint/manifest/interface loaded, reports present, `4` adapters readable, `12` installer permission checks enforced, `0` permission failures, `0` failures, `0` warnings |
 | Local Install Sync Preflight | `make sync-local-install` and `make sync-active-install` rebuild the package first, then sync only after install simulation passes with `12` enforced installer permission checks and `0` permission failures |
 | Upgrade Check | current package declares `minor` over the 1.0.0 baseline, recommended bump is `minor`, and release notes include added targets plus checksum changes |
-| Adoption Drift | `1` metadata-only review event, `0` adoption samples, adoption `0`, risk band `low`; raw `reports/telemetry_events.jsonl` is gitignored and blocked from zip packages |
+| Adoption Drift | `1` metadata-only review event, `0` adoption samples, adoption `0`, risk band `low`; optional `yao.py` CLI capture is available but off by default for reproducible release evidence; raw `reports/telemetry_events.jsonl` is gitignored and blocked from zip packages |
 | Review Waivers | ledger generated; current release has `1` warning gate that still needs reviewer decision or a time-bounded waiver; blockers remain non-waivable in v0 |
 | Review Annotations | ledger generated; current release has `0` reviewer annotations and `0` open annotation blockers |
 | Review Studio | decision `review`, world-class score `92`, `13` gates, `0` blockers, `2` warnings, `2` review actions, `0` open annotation blockers |
@@ -124,4 +125,4 @@ Next move: add real client or installer permission enforcement integration.
 2. Add native client or installer runtime enforcement for approved high-permission capabilities.
 3. Run the new provider-backed output runner against holdout cases with real credentials, then record the current blind A/B decisions before claiming fully ready status.
 4. Add real reviewer annotation records during the next human review pass.
-5. Connect real client telemetry capture and failure history so Atlas drift signals are based on live usage, not manual samples.
+5. Connect external client telemetry capture and failure history so Atlas drift signals include non-CLI live usage, not only manual samples or opt-in CLI runs.
diff --git a/reports/skill-overview.html b/reports/skill-overview.html
index 3225f1f..6197154 100644
--- a/reports/skill-overview.html
+++ b/reports/skill-overview.html
@@ -609,7 +609,7 @@
           <ul class="list"><li><span data-lang="zh-CN">把一次性经验沉淀为可复用、可评估、可迁移的 Skill 包体。</span><span data-lang="en">把一次性经验沉淀为可复用、可评估、可迁移的 Skill 包体。</span></li><li><span data-lang="zh-CN">Skill 作者、复用团队和后续 reviewer。</span><span data-lang="en">Skill 作者、复用团队和后续 reviewer。</span></li><li><span data-lang="zh-CN">创建完成后建议先打开 reports/skill-overview.html，再继续扩展包体。</span><span data-lang="en">创建完成后建议先打开 reports/skill-overview.html，再继续扩展包体。</span></li></ul>
         </aside>
       </div>
-      <div class="score-strip" aria-label="报告关键指标"><article class='score-chip'><span>完整度</span><strong>100</strong><i style='--score:100%'></i><small><span data-lang="zh-CN">SKILL.md 已存在，是 Skill 的入口。</span><span data-lang="en">SKILL.md 已存在，是 Skill 的入口。</span></small></article><article class='score-chip'><span>触发清晰</span><strong>100</strong><i style='--score:100%'></i><small><span data-lang="zh-CN">frontmatter description 已存在，具备基础路由面。</span><span data-lang="en">frontmatter description 已存在，具备基础路由面。</span></small></article><article class='score-chip'><span>证据充分</span><strong>100</strong><i style='--score:100%'></i><small><span data-lang="zh-CN">已生成 20 / 20 类报告证据。</span><span data-lang="en">已生成 20 / 20 类报告证据。</span></small></article><article class='score-chip'><span>上下文成本</span><strong>42</strong><i style='--score:42%'></i><small><span data-lang="zh-CN">入口约 350 个词/字，references 约 14711 个词/字。</span><span data-lang="en">入口约 350 个词/字，references 约 14711 个词/字。</span></small></article></div>
+      <div class="score-strip" aria-label="报告关键指标"><article class='score-chip'><span>完整度</span><strong>100</strong><i style='--score:100%'></i><small><span data-lang="zh-CN">SKILL.md 已存在，是 Skill 的入口。</span><span data-lang="en">SKILL.md 已存在，是 Skill 的入口。</span></small></article><article class='score-chip'><span>触发清晰</span><strong>100</strong><i style='--score:100%'></i><small><span data-lang="zh-CN">frontmatter description 已存在，具备基础路由面。</span><span data-lang="en">frontmatter description 已存在，具备基础路由面。</span></small></article><article class='score-chip'><span>证据充分</span><strong>100</strong><i style='--score:100%'></i><small><span data-lang="zh-CN">已生成 20 / 20 类报告证据。</span><span data-lang="en">已生成 20 / 20 类报告证据。</span></small></article><article class='score-chip'><span>上下文成本</span><strong>42</strong><i style='--score:42%'></i><small><span data-lang="zh-CN">入口约 350 个词/字，references 约 14859 个词/字。</span><span data-lang="en">入口约 350 个词/字，references 约 14859 个词/字。</span></small></article></div>
     </section>
 
     <section id="overview">
@@ -641,10 +641,10 @@
               <article class="panel metrics-note">
                 <h3><span data-lang="zh-CN">指标判读</span><span data-lang="en">Reading</span></h3>
                 <p><span data-lang="zh-CN">先看雷达图判断能力短板，再看下方每项分数的证据原因。分数不是装饰数字，必须和本地文件、reports 证据或证据不足提示对应。</span><span data-lang="en">Read the radar first for weak spots, then inspect each score with its evidence. Scores must map to local files, reports, or explicit evidence gaps.</span></p>
-                <ol class='metric-summary-list'><li><span class='metric-status'><span data-lang="zh-CN">稳定</span><span data-lang="en">Stable</span></span><b>完整度</b><em>100</em><small><span data-lang="zh-CN">SKILL.md 已存在，是 Skill 的入口。</span><span data-lang="en">SKILL.md 已存在，是 Skill 的入口。</span></small></li><li><span class='metric-status'><span data-lang="zh-CN">稳定</span><span data-lang="en">Stable</span></span><b>触发清晰</b><em>100</em><small><span data-lang="zh-CN">frontmatter description 已存在，具备基础路由面。</span><span data-lang="en">frontmatter description 已存在，具备基础路由面。</span></small></li><li><span class='metric-status'><span data-lang="zh-CN">稳定</span><span data-lang="en">Stable</span></span><b>证据充分</b><em>100</em><small><span data-lang="zh-CN">已生成 20 / 20 类报告证据。</span><span data-lang="en">已生成 20 / 20 类报告证据。</span></small></li><li><span class='metric-status'><span data-lang="zh-CN">稳定</span><span data-lang="en">Stable</span></span><b>可维护性</b><em>100</em><small><span data-lang="zh-CN">SKILL.md 约 350 个词/字。</span><span data-lang="en">SKILL.md 约 350 个词/字。</span></small></li><li><span class='metric-status'><span data-lang="zh-CN">稳定</span><span data-lang="en">Stable</span></span><b>可迁移性</b><em>100</em><small><span data-lang="zh-CN">agents/interface.yaml 已存在。</span><span data-lang="en">agents/interface.yaml 已存在。</span></small></li><li><span class='metric-status'><span data-lang="zh-CN">关注</span><span data-lang="en">Watch</span></span><b>上下文成本</b><em>42</em><small><span data-lang="zh-CN">入口约 350 个词/字，references 约 14711 个词/字。</span><span data-lang="en">入口约 350 个词/字，references 约 14711 个词/字。</span></small></li></ol>
+                <ol class='metric-summary-list'><li><span class='metric-status'><span data-lang="zh-CN">稳定</span><span data-lang="en">Stable</span></span><b>完整度</b><em>100</em><small><span data-lang="zh-CN">SKILL.md 已存在，是 Skill 的入口。</span><span data-lang="en">SKILL.md 已存在，是 Skill 的入口。</span></small></li><li><span class='metric-status'><span data-lang="zh-CN">稳定</span><span data-lang="en">Stable</span></span><b>触发清晰</b><em>100</em><small><span data-lang="zh-CN">frontmatter description 已存在，具备基础路由面。</span><span data-lang="en">frontmatter description 已存在，具备基础路由面。</span></small></li><li><span class='metric-status'><span data-lang="zh-CN">稳定</span><span data-lang="en">Stable</span></span><b>证据充分</b><em>100</em><small><span data-lang="zh-CN">已生成 20 / 20 类报告证据。</span><span data-lang="en">已生成 20 / 20 类报告证据。</span></small></li><li><span class='metric-status'><span data-lang="zh-CN">稳定</span><span data-lang="en">Stable</span></span><b>可维护性</b><em>100</em><small><span data-lang="zh-CN">SKILL.md 约 350 个词/字。</span><span data-lang="en">SKILL.md 约 350 个词/字。</span></small></li><li><span class='metric-status'><span data-lang="zh-CN">稳定</span><span data-lang="en">Stable</span></span><b>可迁移性</b><em>100</em><small><span data-lang="zh-CN">agents/interface.yaml 已存在。</span><span data-lang="en">agents/interface.yaml 已存在。</span></small></li><li><span class='metric-status'><span data-lang="zh-CN">关注</span><span data-lang="en">Watch</span></span><b>上下文成本</b><em>42</em><small><span data-lang="zh-CN">入口约 350 个词/字，references 约 14859 个词/字。</span><span data-lang="en">入口约 350 个词/字，references 约 14859 个词/字。</span></small></li></ol>
               </article>
             </div>
-            <div class="metric-grid"><article class='metric-card'><div class='metric-card-head'><span class='metric-label'>完整度</span><strong>100</strong></div><div class='metric-card-body'><ul class="compact-list"><li><span data-lang="zh-CN">SKILL.md 已存在，是 Skill 的入口。</span><span data-lang="en">SKILL.md 已存在，是 Skill 的入口。</span></li><li><span data-lang="zh-CN">README.md 已存在，便于人工阅读。</span><span data-lang="en">README.md 已存在，便于人工阅读。</span></li><li><span data-lang="zh-CN">agents/interface.yaml 已存在，便于跨平台适配。</span><span data-lang="en">agents/interface.yaml 已存在，便于跨平台适配。</span></li></ul></div></article><article class='metric-card'><div class='metric-card-head'><span class='metric-label'>触发清晰</span><strong>100</strong></div><div class='metric-card-body'><ul class="compact-list"><li><span data-lang="zh-CN">frontmatter description 已存在，具备基础路由面。</span><span data-lang="en">frontmatter description 已存在，具备基础路由面。</span></li><li><span data-lang="zh-CN">description 有足够长度说明任务边界。</span><span data-lang="en">description 有足够长度说明任务边界。</span></li><li><span data-lang="zh-CN">description 已包含使用场景或排除边界信号。</span><span data-lang="en">description 已包含使用场景或排除边界信号。</span></li></ul></div></article><article class='metric-card'><div class='metric-card-head'><span class='metric-label'>证据充分</span><strong>100</strong></div><div class='metric-card-body'><ul class="compact-list"><li><span data-lang="zh-CN">已生成 20 / 20 类报告证据。</span><span data-lang="en">已生成 20 / 20 类报告证据。</span></li><li><span data-lang="zh-CN">skill-ir.json 已存在。</span><span data-lang="en">skill-ir.json 已存在。</span></li><li><span data-lang="zh-CN">compiled_targets.json 已存在。</span><span data-lang="en">compiled_targets.json 已存在。</span></li></ul></div></article><article class='metric-card'><div class='metric-card-head'><span class='metric-label'>可维护性</span><strong>100</strong></div><div class='metric-card-body'><ul class="compact-list"><li><span data-lang="zh-CN">SKILL.md 约 350 个词/字。</span><span data-lang="en">SKILL.md 约 350 个词/字。</span></li><li><span data-lang="zh-CN">入口文件保持克制，可维护性较好。</span><span data-lang="en">入口文件保持克制，可维护性较好。</span></li><li><span data-lang="zh-CN">references/ 已承载扩展指导。</span><span data-lang="en">references/ 已承载扩展指导。</span></li></ul></div></article><article class='metric-card'><div class='metric-card-head'><span class='metric-label'>可迁移性</span><strong>100</strong></div><div class='metric-card-body'><ul class="compact-list"><li><span data-lang="zh-CN">agents/interface.yaml 已存在。</span><span data-lang="en">agents/interface.yaml 已存在。</span></li><li><span data-lang="zh-CN">manifest.json 已存在。</span><span data-lang="en">manifest.json 已存在。</span></li><li><span data-lang="zh-CN">目标平台或 adapter target 已声明。</span><span data-lang="en">目标平台或 adapter target 已声明。</span></li></ul></div></article><article class='metric-card'><div class='metric-card-head'><span class='metric-label'>上下文成本</span><strong>42</strong></div><div class='metric-card-body'><ul class="compact-list"><li><span data-lang="zh-CN">入口约 350 个词/字，references 约 14711 个词/字。</span><span data-lang="en">入口约 350 个词/字，references 约 14711 个词/字。</span></li><li><span data-lang="zh-CN">分数越高代表上下文成本越低。</span><span data-lang="en">分数越高代表上下文成本越低。</span></li><li><span data-lang="zh-CN">上下文成本偏高，建议压缩入口或拆分 references。</span><span data-lang="en">上下文成本偏高，建议压缩入口或拆分 references。</span></li></ul></div></article></div>
+            <div class="metric-grid"><article class='metric-card'><div class='metric-card-head'><span class='metric-label'>完整度</span><strong>100</strong></div><div class='metric-card-body'><ul class="compact-list"><li><span data-lang="zh-CN">SKILL.md 已存在，是 Skill 的入口。</span><span data-lang="en">SKILL.md 已存在，是 Skill 的入口。</span></li><li><span data-lang="zh-CN">README.md 已存在，便于人工阅读。</span><span data-lang="en">README.md 已存在，便于人工阅读。</span></li><li><span data-lang="zh-CN">agents/interface.yaml 已存在，便于跨平台适配。</span><span data-lang="en">agents/interface.yaml 已存在，便于跨平台适配。</span></li></ul></div></article><article class='metric-card'><div class='metric-card-head'><span class='metric-label'>触发清晰</span><strong>100</strong></div><div class='metric-card-body'><ul class="compact-list"><li><span data-lang="zh-CN">frontmatter description 已存在，具备基础路由面。</span><span data-lang="en">frontmatter description 已存在，具备基础路由面。</span></li><li><span data-lang="zh-CN">description 有足够长度说明任务边界。</span><span data-lang="en">description 有足够长度说明任务边界。</span></li><li><span data-lang="zh-CN">description 已包含使用场景或排除边界信号。</span><span data-lang="en">description 已包含使用场景或排除边界信号。</span></li></ul></div></article><article class='metric-card'><div class='metric-card-head'><span class='metric-label'>证据充分</span><strong>100</strong></div><div class='metric-card-body'><ul class="compact-list"><li><span data-lang="zh-CN">已生成 20 / 20 类报告证据。</span><span data-lang="en">已生成 20 / 20 类报告证据。</span></li><li><span data-lang="zh-CN">skill-ir.json 已存在。</span><span data-lang="en">skill-ir.json 已存在。</span></li><li><span data-lang="zh-CN">compiled_targets.json 已存在。</span><span data-lang="en">compiled_targets.json 已存在。</span></li></ul></div></article><article class='metric-card'><div class='metric-card-head'><span class='metric-label'>可维护性</span><strong>100</strong></div><div class='metric-card-body'><ul class="compact-list"><li><span data-lang="zh-CN">SKILL.md 约 350 个词/字。</span><span data-lang="en">SKILL.md 约 350 个词/字。</span></li><li><span data-lang="zh-CN">入口文件保持克制，可维护性较好。</span><span data-lang="en">入口文件保持克制，可维护性较好。</span></li><li><span data-lang="zh-CN">references/ 已承载扩展指导。</span><span data-lang="en">references/ 已承载扩展指导。</span></li></ul></div></article><article class='metric-card'><div class='metric-card-head'><span class='metric-label'>可迁移性</span><strong>100</strong></div><div class='metric-card-body'><ul class="compact-list"><li><span data-lang="zh-CN">agents/interface.yaml 已存在。</span><span data-lang="en">agents/interface.yaml 已存在。</span></li><li><span data-lang="zh-CN">manifest.json 已存在。</span><span data-lang="en">manifest.json 已存在。</span></li><li><span data-lang="zh-CN">目标平台或 adapter target 已声明。</span><span data-lang="en">目标平台或 adapter target 已声明。</span></li></ul></div></article><article class='metric-card'><div class='metric-card-head'><span class='metric-label'>上下文成本</span><strong>42</strong></div><div class='metric-card-body'><ul class="compact-list"><li><span data-lang="zh-CN">入口约 350 个词/字，references 约 14859 个词/字。</span><span data-lang="en">入口约 350 个词/字，references 约 14859 个词/字。</span></li><li><span data-lang="zh-CN">分数越高代表上下文成本越低。</span><span data-lang="en">分数越高代表上下文成本越低。</span></li><li><span data-lang="zh-CN">上下文成本偏高，建议压缩入口或拆分 references。</span><span data-lang="en">上下文成本偏高，建议压缩入口或拆分 references。</span></li></ul></div></article></div>
           </div>
         </div>
       </div>
@@ -720,7 +720,7 @@
         <div>
           <table>
             <thead><tr><th><span data-lang="zh-CN">类型</span><span data-lang="en">Type</span></th><th><span data-lang="zh-CN">证据</span><span data-lang="en">Evidence</span></th><th><span data-lang="zh-CN">建议</span><span data-lang="en">Action</span></th></tr></thead>
-            <tbody><tr><td><span data-lang="zh-CN">强项</span><span data-lang="en">Strength</span></td><td><span data-lang="zh-CN">触发面保持精简，并锚定在 frontmatter description。</span><span data-lang="en">The trigger surface stays lean and anchored in the frontmatter description.</span></td><td><span data-lang="zh-CN">保留并复用</span><span data-lang="en">Keep</span></td></tr><tr><td><span data-lang="zh-CN">强项</span><span data-lang="en">Strength</span></td><td><span data-lang="zh-CN">已生成 Skill IR，核心语义可先于平台打包被审查和迁移。</span><span data-lang="en">已生成 Skill IR，核心语义可先于平台打包被审查和迁移。</span></td><td><span data-lang="zh-CN">保留并复用</span><span data-lang="en">Keep</span></td></tr><tr><td><span data-lang="zh-CN">强项</span><span data-lang="en">Strength</span></td><td><span data-lang="zh-CN">已生成目标编译报告，可审查 IR 到 OpenAI、Claude、generic 等目标契约的映射。</span><span data-lang="en">已生成目标编译报告，可审查 IR 到 OpenAI、Claude、generic 等目标契约的映射。</span></td><td><span data-lang="zh-CN">保留并复用</span><span data-lang="en">Keep</span></td></tr><tr><td><span data-lang="zh-CN">缺口</span><span data-lang="en">Gap</span></td><td><span data-lang="zh-CN">上下文成本需要补强：入口约 350 个词/字，references 约 14711 个词/字。</span><span data-lang="en">上下文成本需要补强：入口约 350 个词/字，references 约 14711 个词/字。</span></td><td><span data-lang="zh-CN">纳入下一轮修复</span><span data-lang="en">Fix next</span></td></tr></tbody>
+            <tbody><tr><td><span data-lang="zh-CN">强项</span><span data-lang="en">Strength</span></td><td><span data-lang="zh-CN">触发面保持精简，并锚定在 frontmatter description。</span><span data-lang="en">The trigger surface stays lean and anchored in the frontmatter description.</span></td><td><span data-lang="zh-CN">保留并复用</span><span data-lang="en">Keep</span></td></tr><tr><td><span data-lang="zh-CN">强项</span><span data-lang="en">Strength</span></td><td><span data-lang="zh-CN">已生成 Skill IR，核心语义可先于平台打包被审查和迁移。</span><span data-lang="en">已生成 Skill IR，核心语义可先于平台打包被审查和迁移。</span></td><td><span data-lang="zh-CN">保留并复用</span><span data-lang="en">Keep</span></td></tr><tr><td><span data-lang="zh-CN">强项</span><span data-lang="en">Strength</span></td><td><span data-lang="zh-CN">已生成目标编译报告，可审查 IR 到 OpenAI、Claude、generic 等目标契约的映射。</span><span data-lang="en">已生成目标编译报告，可审查 IR 到 OpenAI、Claude、generic 等目标契约的映射。</span></td><td><span data-lang="zh-CN">保留并复用</span><span data-lang="en">Keep</span></td></tr><tr><td><span data-lang="zh-CN">缺口</span><span data-lang="en">Gap</span></td><td><span data-lang="zh-CN">上下文成本需要补强：入口约 350 个词/字，references 约 14859 个词/字。</span><span data-lang="en">上下文成本需要补强：入口约 350 个词/字，references 约 14859 个词/字。</span></td><td><span data-lang="zh-CN">纳入下一轮修复</span><span data-lang="en">Fix next</span></td></tr></tbody>
           </table>
           <div class="two-col quality-panels">
             <article class="panel">
@@ -771,7 +771,7 @@
           <p><span data-lang="zh-CN">让 reviewer 快速确认关键文件、目录和资产分布。</span><span data-lang="en">Lets reviewers confirm key files, directories, and asset distribution quickly.</span></p>
         </div>
         <div class="two-col">
-          <figure class="chart-figure" data-chart="asset_donut"><svg viewBox="0 0 430 270" role="img" aria-label="资产分布"><text x="20" y="30" class="chart-title">资产分布</text><circle cx="130" cy="130" r="70" fill="none" stroke="#1B365D" stroke-width="24" stroke-dasharray="1.0 99.0" stroke-dashoffset="0.0" pathLength="100" transform="rotate(-90 130 130)"/><circle cx="130" cy="130" r="70" fill="none" stroke="#2D5A8A" stroke-width="24" stroke-dasharray="1.0 99.0" stroke-dashoffset="-1.0" pathLength="100" transform="rotate(-90 130 130)"/><circle cx="130" cy="130" r="70" fill="none" stroke="#D0DCE9" stroke-width="24" stroke-dasharray="1.0 99.0" stroke-dashoffset="-1.9" pathLength="100" transform="rotate(-90 130 130)"/><circle cx="130" cy="130" r="70" fill="none" stroke="#E4ECF5" stroke-width="24" stroke-dasharray="1.0 99.0" stroke-dashoffset="-2.9" pathLength="100" transform="rotate(-90 130 130)"/><circle cx="130" cy="130" r="70" fill="none" stroke="#e8e6dc" stroke-width="24" stroke-dasharray="30.5 69.5" stroke-dashoffset="-3.8" pathLength="100" transform="rotate(-90 130 130)"/><circle cx="130" cy="130" r="70" fill="none" stroke="#504e49" stroke-width="24" stroke-dasharray="65.7 34.3" stroke-dashoffset="-34.3" pathLength="100" transform="rotate(-90 130 130)"/><text x="130" y="136" text-anchor="middle">304项</text><text x="235" y="78">SKILL.md</text><text x="235" y="100">README.md</text><text x="235" y="122">agents/interface.yaml</text><text x="235" y="144">manifest.json</text><text x="235" y="166">references</text><text x="235" y="188">scripts</text></svg><figcaption>资产分布图展示当前包体的文件和目录重心。</figcaption></figure>
+          <figure class="chart-figure" data-chart="asset_donut"><svg viewBox="0 0 430 270" role="img" aria-label="资产分布"><text x="20" y="30" class="chart-title">资产分布</text><circle cx="130" cy="130" r="70" fill="none" stroke="#1B365D" stroke-width="24" stroke-dasharray="0.9 99.1" stroke-dashoffset="0.0" pathLength="100" transform="rotate(-90 130 130)"/><circle cx="130" cy="130" r="70" fill="none" stroke="#2D5A8A" stroke-width="24" stroke-dasharray="0.9 99.1" stroke-dashoffset="-0.9" pathLength="100" transform="rotate(-90 130 130)"/><circle cx="130" cy="130" r="70" fill="none" stroke="#D0DCE9" stroke-width="24" stroke-dasharray="0.9 99.1" stroke-dashoffset="-1.9" pathLength="100" transform="rotate(-90 130 130)"/><circle cx="130" cy="130" r="70" fill="none" stroke="#E4ECF5" stroke-width="24" stroke-dasharray="0.9 99.1" stroke-dashoffset="-2.8" pathLength="100" transform="rotate(-90 130 130)"/><circle cx="130" cy="130" r="70" fill="none" stroke="#e8e6dc" stroke-width="24" stroke-dasharray="30.2 69.8" stroke-dashoffset="-3.8" pathLength="100" transform="rotate(-90 130 130)"/><circle cx="130" cy="130" r="70" fill="none" stroke="#504e49" stroke-width="24" stroke-dasharray="66.0 34.0" stroke-dashoffset="-34.0" pathLength="100" transform="rotate(-90 130 130)"/><text x="130" y="136" text-anchor="middle">305项</text><text x="235" y="78">SKILL.md</text><text x="235" y="100">README.md</text><text x="235" y="122">agents/interface.yaml</text><text x="235" y="144">manifest.json</text><text x="235" y="166">references</text><text x="235" y="188">scripts</text></svg><figcaption>资产分布图展示当前包体的文件和目录重心。</figcaption></figure>
           <table>
             <thead><tr><th><span data-lang="zh-CN">路径</span><span data-lang="en">Path</span></th><th><span data-lang="zh-CN">作用</span><span data-lang="en">Role</span></th><th><span data-lang="zh-CN">类型</span><span data-lang="en">Type</span></th></tr></thead>
             <tbody><tr><td>SKILL.md</td><td><span data-lang="zh-CN">Skill 入口文件</span><span data-lang="en">Skill entrypoint</span></td><td><span data-lang="zh-CN">文件</span><span data-lang="en">file</span></td></tr><tr><td>README.md</td><td><span data-lang="zh-CN">人类可读使用说明</span><span data-lang="en">Human-readable usage guide</span></td><td><span data-lang="zh-CN">文件</span><span data-lang="en">file</span></td></tr><tr><td>agents/interface.yaml</td><td><span data-lang="zh-CN">跨平台接口元数据</span><span data-lang="en">Neutral interface metadata</span></td><td><span data-lang="zh-CN">文件</span><span data-lang="en">file</span></td></tr><tr><td>manifest.json</td><td><span data-lang="zh-CN">生命周期与打包元数据</span><span data-lang="en">Lifecycle and portability metadata</span></td><td><span data-lang="zh-CN">文件</span><span data-lang="en">file</span></td></tr><tr><td>references</td><td><span data-lang="zh-CN">扩展指导与复用资料</span><span data-lang="en">Extended guidance and reusable notes</span></td><td><span data-lang="zh-CN">目录</span><span data-lang="en">folder</span></td></tr><tr><td>scripts</td><td><span data-lang="zh-CN">确定性脚本或本地工具</span><span data-lang="en">Deterministic helpers or local tooling</span></td><td><span data-lang="zh-CN">目录</span><span data-lang="en">folder</span></td></tr><tr><td>evals</td><td><span data-lang="zh-CN">触发与质量检查</span><span data-lang="en">Trigger and quality checks</span></td><td><span data-lang="zh-CN">目录</span><span data-lang="en">folder</span></td></tr><tr><td>reports</td><td><span data-lang="zh-CN">生成的证据与总结报告</span><span data-lang="en">Generated evidence and overview artifacts</span></td><td><span data-lang="zh-CN">目录</span><span data-lang="en">folder</span></td></tr></tbody>
diff --git a/reports/skill-overview.json b/reports/skill-overview.json
index 7f8672a..941260b 100644
--- a/reports/skill-overview.json
+++ b/reports/skill-overview.json
@@ -96,7 +96,7 @@
       "label": "上下文成本",
       "score": 42,
       "reasons": [
-        "入口约 350 个词/字，references 约 14711 个词/字。",
+        "入口约 350 个词/字，references 约 14859 个词/字。",
         "分数越高代表上下文成本越低。",
         "上下文成本偏高，建议压缩入口或拆分 references。"
       ]
@@ -200,7 +200,7 @@
       "已生成 Output Review Adjudication，可记录盲评决策、一致率和待评审项。"
     ],
     "gaps": [
-      "上下文成本需要补强：入口约 350 个词/字，references 约 14711 个词/字。"
+      "上下文成本需要补强：入口约 350 个词/字，references 约 14859 个词/字。"
     ],
     "recommendations": [
       "先改触发边界，再扩展工作流。",
@@ -433,7 +433,7 @@
         "path": "scripts",
         "label": "Deterministic helpers or local tooling",
         "kind": "folder",
-        "file_count": 69
+        "file_count": 70
       },
       {
         "path": "evals",
@@ -448,7 +448,7 @@
         "file_count": 171
       }
     ],
-    "file_count": 304,
+    "file_count": 305,
     "folder_count": 4,
     "distribution": [
       {
@@ -473,7 +473,7 @@
       },
       {
         "label": "scripts",
-        "value": 69
+        "value": 70
       },
       {
         "label": "evals",
@@ -602,7 +602,7 @@
       "path": "scripts",
       "label": "Deterministic helpers or local tooling",
       "kind": "folder",
-      "file_count": 69
+      "file_count": 70
     },
     {
       "path": "evals",
@@ -948,9 +948,9 @@
     "failures": []
   },
   "trust_security": {
-    "scanned_files": 153,
-    "script_count": 69,
-    "internal_module_count": 9,
+    "scanned_files": 154,
+    "script_count": 70,
+    "internal_module_count": 10,
     "secret_findings": 0,
     "dependency_files": [
       "requirements-ci.txt"
@@ -968,8 +968,8 @@
     "help_smoke_failed_count": 0,
     "interactive_script_count": 0,
     "package_hash_scope": "source-contract-without-generated-reports",
-    "package_hash_file_count": 153,
-    "package_sha256": "44d9cb1aa096fff1b2c8844a609574c05c8ed9ae12005dc74a5662d3d94013fd"
+    "package_hash_file_count": 154,
+    "package_sha256": "495c5824cf84b56ef77bebc75e415191425e2f1131f0a4027d17037631b52fa2"
   },
   "skill_atlas": {
     "skill_count": 12,
@@ -1007,8 +1007,8 @@
       "trust_level": "local",
       "license": "MIT",
       "checksums": {
-        "package_sha256": "44d9cb1aa096fff1b2c8844a609574c05c8ed9ae12005dc74a5662d3d94013fd",
-        "archive_sha256": "cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933"
+        "package_sha256": "495c5824cf84b56ef77bebc75e415191425e2f1131f0a4027d17037631b52fa2",
+        "archive_sha256": "0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474"
       },
       "compatibility": {
         "openai": "pass",
@@ -1039,7 +1039,7 @@
       },
       "distribution": {
         "archive_verified": true,
-        "archive_sha256": "cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933",
+        "archive_sha256": "0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474",
         "package_verification": "reports/package_verification.json",
         "install_simulated": true,
         "install_simulation": "reports/install_simulation.json"
@@ -1055,8 +1055,8 @@
       "target_count": 4,
       "adapter_count": 4,
       "archive_present": true,
-      "archive_sha256": "cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933",
-      "archive_entry_count": 494,
+      "archive_sha256": "0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474",
+      "archive_entry_count": 495,
       "failure_count": 0,
       "warning_count": 0
     },
@@ -1067,7 +1067,7 @@
     "ok": true,
     "summary": {
       "archive_present": true,
-      "archive_entry_count": 494,
+      "archive_entry_count": 495,
       "archive_extracted": true,
       "entrypoint_loaded": true,
       "manifest_loaded": true,
@@ -1134,12 +1134,12 @@
         {
           "field": "archive_sha256",
           "from": "",
-          "to": "cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933"
+          "to": "0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474"
         },
         {
           "field": "package_sha256",
           "from": "0000000000000000000000000000000000000000000000000000000000000000",
-          "to": "44d9cb1aa096fff1b2c8844a609574c05c8ed9ae12005dc74a5662d3d94013fd"
+          "to": "495c5824cf84b56ef77bebc75e415191425e2f1131f0a4027d17037631b52fa2"
         }
       ]
     },
@@ -1156,14 +1156,14 @@
     "ok": true,
     "summary": {
       "event_count": 1,
-      "adoption_sample_count": 1,
-      "activation_count": 1,
-      "accepted_count": 1,
+      "adoption_sample_count": 0,
+      "activation_count": 0,
+      "accepted_count": 0,
       "edited_count": 0,
       "rejected_count": 0,
       "missed_count": 0,
       "failed_count": 0,
-      "adoption_rate": 100.0,
+      "adoption_rate": 0,
       "missed_trigger_count": 0,
       "wrong_trigger_count": 0,
       "bad_output_count": 0,
@@ -1172,9 +1172,13 @@
       "review_overdue_count": 0,
       "risk_band": "low",
       "event_types": {
-        "skill_activation": 1
+        "review_event": 1
       },
-      "failure_types": {}
+      "failure_types": {},
+      "source_types": {
+        "manual": 1
+      },
+      "command_counts": {}
     },
     "next_iteration_candidates": [],
     "privacy_contract": {
diff --git a/reports/skill_atlas.json b/reports/skill_atlas.json
index b59a793..492bb5d 100644
--- a/reports/skill_atlas.json
+++ b/reports/skill_atlas.json
@@ -133,6 +133,7 @@
           "scripts/yao.py",
           "scripts/yao_cli_config.py",
           "scripts/yao_cli_parser.py",
+          "scripts/yao_cli_telemetry.py",
           "references/artifact-design-doctrine.md",
           "references/authoring-discipline.md",
           "references/distribution-registry-method.md",
diff --git a/reports/upgrade_check.json b/reports/upgrade_check.json
index e228f00..897b5ee 100644
--- a/reports/upgrade_check.json
+++ b/reports/upgrade_check.json
@@ -70,12 +70,12 @@
       {
         "field": "archive_sha256",
         "from": "",
-        "to": "cdadcbc9a0c92eba0c80a9f4fbd840530d32d19bf3cbb508a24bebb8e8551933"
+        "to": "0f80e2e194d003a99da34f73923b9459f260b2d177c5f1f6ec7104fdd5713474"
       },
       {
         "field": "package_sha256",
         "from": "0000000000000000000000000000000000000000000000000000000000000000",
-        "to": "44d9cb1aa096fff1b2c8844a609574c05c8ed9ae12005dc74a5662d3d94013fd"
+        "to": "495c5824cf84b56ef77bebc75e415191425e2f1131f0a4027d17037631b52fa2"
       }
     ]
   },
diff --git a/scripts/render_adoption_drift_report.py b/scripts/render_adoption_drift_report.py
index 518cc2f..c1bf6d4 100644
--- a/scripts/render_adoption_drift_report.py
+++ b/scripts/render_adoption_drift_report.py
@@ -23,14 +23,17 @@ ALLOWED_FAILURE_TYPES = {
     "review_overdue",
 }
 ALLOWED_FIELDS = {
+    "command",
     "event",
     "skill",
+    "source",
     "version",
     "activation_type",
     "outcome",
     "failure_type",
     "timestamp",
 }
+ALLOWED_SOURCES = {"manual", "yao_cli", "external", "unknown"}
 SENSITIVE_FIELDS = {
     "prompt",
     "content",
@@ -112,6 +115,8 @@ def normalize_event(raw: dict[str, Any], defaults: dict[str, str], line_label: s
     timestamp = str(raw.get("timestamp") or utc_now())
     skill = str(raw.get("skill") or defaults["skill"])
     version = str(raw.get("version") or defaults["version"])
+    source = str(raw.get("source") or "manual")
+    command = str(raw.get("command") or "unknown")
 
     if event not in ALLOWED_EVENTS:
         failures.append(f"{line_label}: unsupported event `{event}`")
@@ -121,12 +126,18 @@ def normalize_event(raw: dict[str, Any], defaults: dict[str, str], line_label: s
         failures.append(f"{line_label}: unsupported outcome `{outcome}`")
     if failure_type not in ALLOWED_FAILURE_TYPES:
         failures.append(f"{line_label}: unsupported failure_type `{failure_type}`")
+    if source not in ALLOWED_SOURCES:
+        failures.append(f"{line_label}: unsupported source `{source}`")
+    if not command.replace("-", "").replace("_", "").isalnum() or len(command) > 64:
+        failures.append(f"{line_label}: command must use only letters, numbers, hyphens, or underscores and stay under 64 chars")
 
     if failures:
         return None, failures
     return {
+        "command": command,
         "event": event,
         "skill": skill,
+        "source": source,
         "version": version,
         "activation_type": activation_type,
         "outcome": outcome,
@@ -254,6 +265,8 @@ def summarize(events: list[dict[str, str]], review_overdue_count: int) -> dict[s
     outcomes = Counter(event["outcome"] for event in adoption_events)
     failures = Counter(event["failure_type"] for event in events if event["failure_type"] != "none")
     event_types = Counter(event["event"] for event in events)
+    source_types = Counter(event.get("source", "manual") for event in events)
+    command_counts = Counter(event.get("command", "unknown") for event in events if event.get("command", "unknown") != "unknown")
     adopted = outcomes["accepted"] + outcomes["edited"]
     event_count = len(events)
     adoption_sample_count = len(adoption_events)
@@ -289,6 +302,8 @@ def summarize(events: list[dict[str, str]], review_overdue_count: int) -> dict[s
         "risk_band": risk_band,
         "event_types": dict(sorted(event_types.items())),
         "failure_types": dict(sorted(failures.items())),
+        "source_types": dict(sorted(source_types.items())),
+        "command_counts": dict(sorted(command_counts.items())),
     }
 
 
@@ -339,6 +354,7 @@ def render_markdown(report: dict[str, Any]) -> str:
     for event in report["recent_events"]:
         lines.append(
             f"- `{event['timestamp']}` `{event['skill']}` event=`{event['event']}` "
+            f"source=`{event.get('source', 'manual')}` command=`{event.get('command', 'unknown')}` "
             f"activation=`{event['activation_type']}` outcome=`{event['outcome']}` failure=`{event['failure_type']}`"
         )
     if not report["recent_events"]:
@@ -415,6 +431,8 @@ def main() -> None:
     parser.add_argument("--activation-type", choices=sorted(ALLOWED_ACTIVATION_TYPES), default="unknown")
     parser.add_argument("--outcome", choices=sorted(ALLOWED_OUTCOMES), default="unknown")
     parser.add_argument("--failure-type", choices=sorted(ALLOWED_FAILURE_TYPES), default="none")
+    parser.add_argument("--source", choices=sorted(ALLOWED_SOURCES), default="manual")
+    parser.add_argument("--command", default="unknown")
     parser.add_argument("--timestamp")
     parser.add_argument("--skill-name")
     parser.add_argument("--version")
@@ -427,6 +445,8 @@ def main() -> None:
             "activation_type": args.activation_type,
             "outcome": args.outcome,
             "failure_type": args.failure_type,
+            "source": args.source,
+            "command": args.command,
         }
         if args.timestamp:
             record_event["timestamp"] = args.timestamp
diff --git a/scripts/yao.py b/scripts/yao.py
index e8d74fc..4de4f77 100644
--- a/scripts/yao.py
+++ b/scripts/yao.py
@@ -23,6 +23,7 @@ from yao_cli_config import (
     resolve_target,
 )
 from yao_cli_parser import build_parser as build_cli_parser
+from yao_cli_telemetry import add_telemetry_args, maybe_record_cli_event
 
 
 ROOT = Path(__file__).resolve().parent.parent
@@ -691,6 +692,8 @@ def command_adoption_drift(args: argparse.Namespace) -> int:
         cmd.extend(["--activation-type", args.activation_type])
         cmd.extend(["--outcome", args.outcome])
         cmd.extend(["--failure-type", args.failure_type])
+        cmd.extend(["--source", args.source])
+        cmd.extend(["--command", args.telemetry_command])
         if args.timestamp:
             cmd.extend(["--timestamp", args.timestamp])
         if args.skill_name:
@@ -1182,13 +1185,20 @@ def command_check_update(args: argparse.Namespace) -> int:
 
 
 def build_parser() -> argparse.ArgumentParser:
-    return build_cli_parser({name: value for name, value in globals().items() if name.startswith("command_")})
+    parser = build_cli_parser({name: value for name, value in globals().items() if name.startswith("command_")})
+    add_telemetry_args(parser)
+    return parser
 
 
 def main() -> None:
     parser = build_parser()
     args = parser.parse_args()
-    raise SystemExit(args.func(args))
+    returncode = 2
+    try:
+        returncode = args.func(args)
+    finally:
+        maybe_record_cli_event(ROOT, args, returncode)
+    raise SystemExit(returncode)
 
 
 if __name__ == "__main__":
diff --git a/scripts/yao_cli_parser.py b/scripts/yao_cli_parser.py
index c4fe44b..caa5274 100644
--- a/scripts/yao_cli_parser.py
+++ b/scripts/yao_cli_parser.py
@@ -277,6 +277,8 @@ def build_parser(command_handlers: dict[str, Callable[[argparse.Namespace], int]
         ],
         default="none",
     )
+    adoption_drift_cmd.add_argument("--source", choices=["external", "manual", "unknown", "yao_cli"], default="manual")
+    adoption_drift_cmd.add_argument("--command", dest="telemetry_command", default="unknown")
     adoption_drift_cmd.add_argument("--timestamp")
     adoption_drift_cmd.add_argument("--skill-name")
     adoption_drift_cmd.add_argument("--version")
diff --git a/scripts/yao_cli_telemetry.py b/scripts/yao_cli_telemetry.py
new file mode 100644
index 0000000..4bb54b1
--- /dev/null
+++ b/scripts/yao_cli_telemetry.py
@@ -0,0 +1,95 @@
+#!/usr/bin/env python3
+"""Metadata-only CLI telemetry helpers for yao.py."""
+
+import argparse
+import os
+import sys
+from pathlib import Path
+from typing import Any
+
+from render_adoption_drift_report import append_event, normalize_event, skill_defaults, utc_now
+
+
+SCRIPT_INTERFACE = "internal-module"
+SCRIPT_INTERFACE_REASON = "Imported by yao.py to record opt-in metadata-only CLI run telemetry."
+
+ENABLE_ENV = "YAO_CLI_TELEMETRY"
+EVENTS_ENV = "YAO_CLI_TELEMETRY_EVENTS"
+TRUTHY = {"1", "true", "yes", "on"}
+FALSY = {"0", "false", "no", "off"}
+
+
+def add_telemetry_args(parser: argparse.ArgumentParser) -> None:
+    parser.add_argument(
+        "--record-cli-telemetry",
+        action="store_true",
+        help="Record metadata-only yao.py command telemetry to reports/telemetry_events.jsonl.",
+    )
+    parser.add_argument(
+        "--no-cli-telemetry",
+        action="store_true",
+        help="Disable yao.py command telemetry even when YAO_CLI_TELEMETRY is enabled.",
+    )
+    parser.add_argument(
+        "--telemetry-events-jsonl",
+        help="Override the local metadata-only telemetry JSONL path.",
+    )
+
+
+def telemetry_enabled(args: argparse.Namespace, environ: dict[str, str] | None = None) -> bool:
+    environ = environ or os.environ
+    if getattr(args, "no_cli_telemetry", False):
+        return False
+    if getattr(args, "record_cli_telemetry", False):
+        return True
+    raw = environ.get(ENABLE_ENV, "").strip().lower()
+    if raw in TRUTHY:
+        return True
+    if raw in FALSY:
+        return False
+    return False
+
+
+def telemetry_path(root: Path, args: argparse.Namespace, environ: dict[str, str] | None = None) -> Path:
+    environ = environ or os.environ
+    configured = getattr(args, "telemetry_events_jsonl", None) or environ.get(EVENTS_ENV)
+    if configured:
+        return Path(configured).expanduser().resolve()
+    return root / "reports" / "telemetry_events.jsonl"
+
+
+def normalize_command_name(value: Any) -> str:
+    raw = str(value or "unknown")
+    lowered = raw.strip().lower()
+    safe = "".join(char for char in lowered if char.isalnum() or char in {"-", "_"})
+    return safe[:64] or "unknown"
+
+
+def cli_event(root: Path, args: argparse.Namespace, returncode: int) -> dict[str, str]:
+    defaults = skill_defaults(root)
+    ok = returncode == 0
+    return {
+        "event": "script_run",
+        "skill": defaults["skill"],
+        "version": defaults["version"],
+        "activation_type": "manual",
+        "outcome": "accepted" if ok else "failed",
+        "failure_type": "none" if ok else "script_error",
+        "timestamp": utc_now(),
+        "source": "yao_cli",
+        "command": normalize_command_name(getattr(args, "command", "unknown")),
+    }
+
+
+def maybe_record_cli_event(root: Path, args: argparse.Namespace, returncode: int) -> None:
+    if not telemetry_enabled(args):
+        return
+    path = telemetry_path(root, args)
+    event, failures = normalize_event(cli_event(root, args, returncode), skill_defaults(root), "yao-cli")
+    if failures or event is None:
+        sys.stderr.write(f"Telemetry skipped: {'; '.join(failures)}\n")
+        return
+    try:
+        append_event(path, event)
+    except OSError as exc:
+        sys.stderr.write(f"Telemetry skipped: {exc}\n")
diff --git a/skill-ir/examples/yao-meta-skill.json b/skill-ir/examples/yao-meta-skill.json
index 4615898..7594699 100644
--- a/skill-ir/examples/yao-meta-skill.json
+++ b/skill-ir/examples/yao-meta-skill.json
@@ -176,7 +176,8 @@
       "scripts/verify_package.py",
       "scripts/yao.py",
       "scripts/yao_cli_config.py",
-      "scripts/yao_cli_parser.py"
+      "scripts/yao_cli_parser.py",
+      "scripts/yao_cli_telemetry.py"
     ],
     "assets": [
       "templates/basic_skill.md.j2",
diff --git a/skill_atlas/catalog.json b/skill_atlas/catalog.json
index 4b3b556..8b95c36 100644
--- a/skill_atlas/catalog.json
+++ b/skill_atlas/catalog.json
@@ -89,6 +89,7 @@
         "scripts/yao.py",
         "scripts/yao_cli_config.py",
         "scripts/yao_cli_parser.py",
+        "scripts/yao_cli_telemetry.py",
         "references/artifact-design-doctrine.md",
         "references/authoring-discipline.md",
         "references/distribution-registry-method.md",
diff --git a/tests/verify_adoption_drift.py b/tests/verify_adoption_drift.py
index fb2e739..03bdf2f 100644
--- a/tests/verify_adoption_drift.py
+++ b/tests/verify_adoption_drift.py
@@ -103,6 +103,10 @@ def main() -> None:
         "failed",
         "--failure-type",
         "script_error",
+        "--source",
+        "yao_cli",
+        "--command",
+        "validate",
         "--timestamp",
         "2026-06-13T10:04:00Z",
     )
@@ -115,11 +119,14 @@ def main() -> None:
     assert summary["bad_output_count"] == 1, summary
     assert summary["script_error_count"] == 1, summary
     assert summary["risk_band"] == "high", summary
+    assert summary["source_types"]["yao_cli"] == 1, summary
+    assert summary["command_counts"]["validate"] == 1, summary
     assert final["payload"]["privacy_contract"]["raw_content_allowed"] is False, final
     assert final["payload"]["next_iteration_candidates"], final
     markdown = (skill_dir / "reports" / "adoption_drift_report.md").read_text(encoding="utf-8")
     assert "metadata-only telemetry" in markdown, markdown
     assert "Raw user prompts" in markdown, markdown
+    assert "source=`yao_cli` command=`validate`" in markdown, markdown
 
     unsafe_events = TMP / "unsafe_events.jsonl"
     unsafe_events.write_text(
diff --git a/tests/verify_trust_check.py b/tests/verify_trust_check.py
index 0348df2..ae96867 100644
--- a/tests/verify_trust_check.py
+++ b/tests/verify_trust_check.py
@@ -97,6 +97,7 @@ def main() -> None:
         "scripts/skill_report_model.py",
         "scripts/yao_cli_config.py",
         "scripts/yao_cli_parser.py",
+        "scripts/yao_cli_telemetry.py",
     ]:
         assert script_map[internal_module]["interface"] == "internal-module", script_map[internal_module]
         assert script_map[internal_module]["interface_declared"], script_map[internal_module]
@@ -110,6 +111,7 @@ def main() -> None:
     assert "skill_report_model.py" not in warning_text, payload["warnings"]
     assert "yao_cli_config.py" not in warning_text, payload["warnings"]
     assert "yao_cli_parser.py" not in warning_text, payload["warnings"]
+    assert "yao_cli_telemetry.py" not in warning_text, payload["warnings"]
     assert "render_context_reports.py" not in warning_text, payload["warnings"]
     assert "render_social_preview.py" not in warning_text, payload["warnings"]
     assert "Network-capable scripts require bounded host policy" not in warning_text, payload["warnings"]
diff --git a/tests/verify_yao_cli.py b/tests/verify_yao_cli.py
index 1b84046..fe1eace 100644
--- a/tests/verify_yao_cli.py
+++ b/tests/verify_yao_cli.py
@@ -16,13 +16,35 @@ import yao_cli_parser  # noqa: E402
 
 
 def run(*args: str, input_text: str | None = None) -> dict:
+    env = dict(os.environ)
+    env["YAO_CLI_TELEMETRY"] = "0"
+    env.pop("YAO_CLI_TELEMETRY_EVENTS", None)
     proc = subprocess.run(
         [sys.executable, str(CLI), *args],
         cwd=ROOT,
         capture_output=True,
         text=True,
         input=input_text,
-        env=os.environ,
+        env=env,
+    )
+    payload = json.loads(proc.stdout)
+    return {
+        "ok": proc.returncode == 0,
+        "returncode": proc.returncode,
+        "payload": payload,
+        "stderr": proc.stderr,
+    }
+
+
+def run_with_env(extra_env: dict[str, str], *args: str) -> dict:
+    env = dict(os.environ)
+    env.update(extra_env)
+    proc = subprocess.run(
+        [sys.executable, str(CLI), *args],
+        cwd=ROOT,
+        capture_output=True,
+        text=True,
+        env=env,
     )
     payload = json.loads(proc.stdout)
     return {
@@ -51,6 +73,7 @@ def main() -> None:
     parser_help = yao_cli_module.build_parser().format_help()
     assert "quickstart" in parser_help, parser_help
     assert "review-studio" in parser_help, parser_help
+    assert "--record-cli-telemetry" in parser_help, parser_help
 
     init_result = run("init", "cli-demo-skill", "--description", "CLI demo skill.", "--output-dir", str(tmp_root))
     assert init_result["ok"], init_result
@@ -96,6 +119,33 @@ def main() -> None:
     assert init_skill_ir["name"] == "cli-demo-skill", init_skill_ir
     assert init_skill_ir["trigger_samples"] >= 1, init_skill_ir
 
+    telemetry_log = tmp_root / "cli-telemetry-events.jsonl"
+    telemetry_env = {
+        "YAO_CLI_TELEMETRY": "1",
+        "YAO_CLI_TELEMETRY_EVENTS": str(telemetry_log),
+    }
+    telemetry_ok = run_with_env(telemetry_env, "validate", str(created))
+    assert telemetry_ok["ok"], telemetry_ok
+    telemetry_fail = run_with_env(
+        telemetry_env,
+        "output-exec",
+        "--runner-command",
+        json.dumps([sys.executable, str(ROOT / "scripts" / "local_output_eval_runner.py")]),
+        "--provider-runner",
+        "openai",
+    )
+    assert not telemetry_fail["ok"], telemetry_fail
+    telemetry_events = [json.loads(line) for line in telemetry_log.read_text(encoding="utf-8").splitlines()]
+    assert len(telemetry_events) == 2, telemetry_events
+    assert telemetry_events[0]["event"] == "script_run", telemetry_events
+    assert telemetry_events[0]["source"] == "yao_cli", telemetry_events
+    assert telemetry_events[0]["command"] == "validate", telemetry_events
+    assert telemetry_events[0]["outcome"] == "accepted", telemetry_events
+    assert telemetry_events[0]["failure_type"] == "none", telemetry_events
+    assert telemetry_events[1]["command"] == "output-exec", telemetry_events
+    assert telemetry_events[1]["outcome"] == "failed", telemetry_events
+    assert telemetry_events[1]["failure_type"] == "script_error", telemetry_events
+
     quickstart_result = run(
         "quickstart",
         "--output-dir",