Conciseness

The body is dense and operational — nearly every sentence carries non-obvious API behavior (e.g. 'Search is eventually consistent', the 10,000 related-instance limit, groupBy type restrictions) with no padding about concepts Claude already knows. Minor time-sensitive details such as 'Generated code needs TypeScript 5.4 or later' are not placed in a deprecation/old-patterns section, keeping it just below anchor 5.

Actionability

Fully executable throughout: a copy-paste CLI command ('npx @cognite/cli@latest tygen generate --data-model mySpace:myModel:v1'), complete TypeScript examples for search, aggregate and query, and concrete patterns like the 'as const' filter-building snippet. Specific examples cover the common cases, matching the top anchor.

Workflow Clarity

The flow is clearly sequenced — verify the alpha flag first (with the 'unknown command' error explained), then generate, then use — and includes validation ('regenerate, inspect the diff, and run the app's typecheck and tests') plus error-recovery guidance for 403/408 failures. The sequence is implicit in section order rather than an explicit checklist, leaving minor gaps versus anchor 5.

Progressive Disclosure

The skill is self-contained with no bundle files, and the body (~135 lines) is well-organized into clearly headed sections (Availability, Generate, Use, Patterns, Known API limits, terminal exploration) with appropriately placed content. It exceeds the under-50-lines case that would merit a 5 without references, and no content clearly demands a separate file, so it fits anchor 4.

Specificity

The description lists multiple concrete actions — 'Generate a typed client for one CDF data model' and 'search, aggregate and query instances with the model's property names and types' — which comprehensively cover what the skill does. It matches the anchor for multiple specific concrete actions with comprehensive coverage, and is not merely a domain name plus one generic verb.

Completeness

It clearly answers 'what' (generate a typed client, search/aggregate/query instances) and includes an explicit 'Use only when the TyGen alpha flag is explicitly enabled' clause, so the cap for a missing 'when' does not apply. However, the 'when' is a gating condition rather than concrete user-intent trigger phrases, so it does not reach anchor 5.

Trigger Term Quality

Good keyword coverage including 'typed client', 'CDF data model', 'search, aggregate and query instances', which a user needing this skill would plausibly say. A few natural variations are missing (e.g. 'generate types', 'type generation'), so it sits between anchor 3 and the comprehensive synonym coverage of anchor 5.

Distinctiveness Conflict Risk

The description names a clear niche — 'one CDF data model in a Dune or Flows app', 'TyGen alpha flag' — with triggers unlikely to fire for any other skill. It matches the anchor for a clear niche with distinct triggers and minimal conflict risk.