CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

data-model

Add or update a dart_mappable data model in lib/src/models/content/, including adding format validation, regenerating code, and adding tests. Use when adding a new content type or modifying an existing model's fields.

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a highly actionable, project-specific guide with an executable template, exact commands, and explicit verification steps. Its weaknesses are mild: some duplication between the template comments and the guidelines list, no error-recovery loop after the test/analyze steps, and all guidance inlined in one ~170-line file rather than split into references.

Suggestions

Remove the duplication between the inline comments in the Dart template and the 'Key guidelines' list (state each convention once, in whichever location is clearer) to tighten conciseness.

Add an explicit feedback loop after the test and analyze steps, e.g. 'If tests or analysis fail, fix the model or test and re-run' to reach level-5 workflow clarity.

Consider moving the validation-helper table and/or the 'Use the data model from a page' section into a references/ file linked from SKILL.md to reduce the inline footprint.

DimensionReasoningScore

Conciseness

The body is dense with project-specific knowledge Claude cannot infer (mapper naming conventions, part directives, validation helpers, custom test matchers), but the inline comments in the Dart template partially duplicate the 'Key guidelines' list, and Effective Dart doc-comment guidance is stated twice — minor trimming opportunities that keep it below level 5.

4 / 5

Actionability

Guidance is fully executable: a complete annotated Dart model template, exact commands ('dart run build_runner build --delete-conflicting-outputs', 'dart test test/models/content/content_models_test.dart', 'dart analyze lib/src/models/content/'), concrete file paths, a validation helper table, named custom matchers, and copy-paste-ready decodeJsonList/decodeJsonObject usage — matching the level-5 anchor.

5 / 5

Workflow Clarity

The sequence is clear ('Before starting' → conventions → codegen → tests → run tests → analyze) with verification checkpoints (run tests, run analysis), but there is no explicit feedback loop telling Claude what to do when tests or analysis fail (fix and re-run), which the level-5 anchor requires.

4 / 5

Progressive Disclosure

The single file is well-organized with clear section headers, a table, and focused code blocks, and no bundle files exist so nothing is misfiled. However, at ~170 lines, content like the validation-helper table or the page-usage section could live in reference files, and the simple-skill exception (under 50 lines) does not apply — good structure with minor organization gaps, i.e. level 4.

4 / 5

Total

17

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it states the concrete capabilities in third person, pins the exact location and framework, and provides an explicit 'Use when' clause with two distinct trigger conditions. The only minor weakness is limited synonym coverage for natural trigger phrasing.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Add or update a dart_mappable data model in lib/src/models/content/', 'adding format validation, regenerating code, and adding tests' — covering the full workflow comprehensively; not the level-4 anchor because there is no meaningful gap in action coverage for the skill's core purpose.

5 / 5

Completeness

It explicitly answers both questions: what ('Add or update a dart_mappable data model... including adding format validation, regenerating code, and adding tests') and when ('Use when adding a new content type or modifying an existing model's fields') with concrete trigger phrases, matching the level-5 anchor exactly.

5 / 5

Trigger Term Quality

Natural terms like 'data model', 'content type', and 'model's fields' match what a user would say, but common variations such as 'schema', 'entity', or a generic 'model' phrasing beyond 'data model' are absent, so it falls just short of the comprehensive-synonym coverage of level 5.

4 / 5

Distinctiveness Conflict Risk

The niche is highly specific — dart_mappable models in a named project directory — with distinct triggers ('adding a new content type', 'modifying an existing model's fields') that are unlikely to fire for unrelated skills; clearly the level-5 anchor.

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

flutter/website

Path

sites/www/.agents/skills/data-model/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.