Content
78%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-architected strategic skill body: lean decision matrices with concrete thresholds, four clearly sequenced and time-boxed workflows, and exemplary progressive disclosure into four existing reference files and three working scripts. The main improvement areas are token efficiency (the Keywords section and occasional rhetorical framing duplicate information) and actionability (input JSON schemas for the scripts should be shown or pointed to explicitly so custom runs don't require reading script source).
Suggestions
Trim the 'Keywords' section — it duplicates trigger terms already in the frontmatter description; if it must stay for search indexing, move it into the description or a reference file instead of spending body tokens.
Show the sources.json/profile.json/corpus.json input schemas (or a one-line pointer to where each is defined) near the Quick Start commands, so custom runs don't require reading script source.
Add a validation/feedback step to Workflow 1 — e.g., 'after remediation, re-run ai_training_data_audit.py to confirm MITIGATE items moved to GO' — and an explicit verification point for the M&A diligence checklist in Workflow 3.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and high-signal — threshold tables like 'Warehouse only ... ≤5 data consumers, <2TB, no ML use cases' and a build-vs-buy matrix assume Claude's competence rather than explaining what a lakehouse or dbt is. Minor trimmable padding remains: the rhetorical framing 'The 2026 question every startup is facing', and a 'Keywords' section that largely duplicates trigger terms already present in the description's frontmatter. That fits anchor 4 (efficient with minor instances that could be trimmed) rather than anchor 5's every-token-earns-its-place. | 4 / 5 |
Actionability | Guidance is mostly executable: copy-paste commands that run out of the box ('python scripts/ai_training_data_audit.py # uses embedded sample'), plus concrete decision rules ('k-anonymity ≥ 5 is the floor', 'Defer until 3+ prod models'). The gap is that custom-input JSON formats are never shown in SKILL.md — 'Run `ai_training_data_audit.py` on a JSON inventory of sources' requires opening the script or reference to know the schema — so it matches anchor 4 (mostly executable with minor gaps) rather than anchor 5's fully copy-paste-ready coverage including input formats. | 4 / 5 |
Workflow Clarity | All four workflows are time-boxed ('AI Training Decision (1 hour)'), goal-stated, and clearly sequenced with per-step actions and cross-check checkpoints ('Cross-check with cs-general-counsel-advisor on top-3 mitigation items', 'Log via /cs:decide'). No explicit validation/re-run feedback loop exists (e.g., re-run the audit after remediation), and steps like 'Run the M&A diligence prep checklist' hand off without a verification point, which fits anchor 4 (clear sequence, most checkpoints, minor validation gaps). The destructive/batch cap at 3 does not apply — the operations are read-only analyses and decisions, not destructive or batch mutations. | 4 / 5 |
Progressive Disclosure | SKILL.md is a genuine overview: each of the four core sections summarizes the decision and signals its reference ('See `references/ai_training_data_rights.md` for the full matrix + GDPR Art. 6 lawful basis decision tree'), the scripts exist and are invocable, all four referenced files exist, and references are one level deep — reference files point to sibling scripts, not to further nested reference chains. Content is appropriately split (full matrices and checklists live in references, thresholds and stage maps stay inline). This matches anchor 5: clear overview, well-signaled one-level-deep references, easy navigation. | 5 / 5 |
Total | 17 / 20 Passed |