Content
82%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.
The body is an unusually dense, highly actionable research framework — specific sources, numeric parameters, a mandatory cross-validation gate, and a fixed output contract. Its main costs are redundancy between Key Principles and earlier sections, a missing error-recovery loop around the report_audit gate, and a monolithic single-file structure where per-lens detail could be externalized.
Suggestions
Deduplicate 'Key Principles' by cutting items 3, 4, 7, 9, and 10, which restate the Cross-Validation, Data Labeling, and AI-bias sections verbatim in intent.
Add one error-recovery step after the 'report_audit' quality gate — e.g., what class of numeric/labeling failures to fix and that the audit must be re-run until it passes.
Move the six per-lens checklists (and optionally the 14-section report template) into references/ files (e.g., references/lenses.md, references/report-template.md) so SKILL.md stays a navigable overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is telegraphic and dense with no padding of concepts Claude already knows — every lens line carries methodology specifics (metrics, scales, source names). It falls short of a 5 because 'Key Principles' items 3, 4, 7, 9, and 10 restate the Cross-Validation, Data Labeling, and bias self-check sections earlier in the file. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully concrete: named data sources (QuestMobile, Sensor Tower, Google Patents, 天眼查/企查查, LatePost/The Information), exact parameters ('20-40% discount', 'liquidity discount 20-30%', '3-5' comparables, '5-7' bull/bear points), a fixed 14-section report template, a concrete save path 'reports/{company}/{company}-private-{YYYYMMDD}.md', and a 'report_audit' quality gate. Not 4: no key execution details are missing. | 5 / 5 |
Workflow Clarity | The sequence is clear — six lenses in parallel (or sequential), then a 'Cross-Validation (team-lead, mandatory)' gate with a numbered 4-step checklist, then a fixed report structure, then save and 'Run report_audit on the numbers as a quality gate'. Not 5: there is no error-recovery instruction for what to fix and re-run when the audit gate fails; not 3: validation checkpoints are explicit and prominent, not merely implicit. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are all absent), and the single SKILL.md is well organized with clear section headers, a role table, and a one-level-deep structure with no nested references. Not 5: at ~160 lines, the six per-lens checklists and the 14-section report template are candidates for references/ files to keep the overview lean; not 3: organization is strong and nothing is buried. | 4 / 5 |
Total | 17 / 20 Passed |