CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

engine-whats-new

Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44). When to use: - Only activate when explicitly asked by the user to generate what's new in the engine, diff Flutter engine releases, or produce an engine release summary. When not to use: - Do not use for general questions about commits, individual file history, or codebase searches unless explicitly requested to generate the engine release diff or summary.

Quality

86%

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.

A well-structured, highly actionable skill body: every command is copy-paste executable, inputs and outputs are concretely named, and worked examples cover the common cases. Remaining improvements are minor — trim the output-category taxonomy, point to scripts/README.md for the full CLI options, and add brief failure handling.

Suggestions

Consolidate the three near-duplicate dart command blocks and reference scripts/README.md as the source for the full option set (--engine-path, --format text), instead of restating flag combinations inline.

Trim the 9-item category taxonomy of the summary document to a one-line description of what the tool covers, since the tool itself generates that structure.

Add a brief failure-handling note (e.g., what to do when a release tag is not found or the script errors) to close the workflow's validation gap.

DimensionReasoningScore

Conciseness

The workflow and examples are lean with zero concept explanations Claude already knows. The 9-item category taxonomy of the summary output (Impeller & Graphics, Web Engine & Wasm, Android Embedding, etc.) is minor padding — the tool generates that structure, so the agent doesn't need every category enumerated. That keeps it at 4 ('minor instances of over-explanation that could be trimmed') rather than 5.

4 / 5

Actionability

Three copy-paste-ready dart commands with concrete flags (--release, --from, --output-diff, --output-summary, --format json) and default output filenames, plus two worked examples with real release versions. Flags verified against scripts/README.md (--release/--to/--target and --from/--base aliases all exist), so the commands are fully executable, not pseudocode.

5 / 5

Workflow Clarity

A clear 3-step sequence (identify inputs → run generator → review artifacts and present) with concrete artifacts named at each stage. Not 5 because there is no explicit validation or error-recovery guidance — e.g., what to do if a release tag isn't found or the dart script fails — leaving a minor validation gap.

4 / 5

Progressive Disclosure

The bundle (scripts/generate_engine_whats_new.dart + scripts/README.md, no references/ or assets/) is appropriately used: the body is a compact overview that references the script one level deep via executable commands, and sections are well organized. Not 5 because the body inlines three near-duplicate command variants whose full option set (--engine-path, --format text) is already documented in scripts/README.md, which the body never signals as the reference for additional options.

4 / 5

Total

17

/

20

Passed

Description

82%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 with an explicit what, an explicit when-to-use with natural trigger phrases, and a helpful when-not-to-use boundary. Its only real gap is capability coverage — it advertises two outputs where the skill actually supports more (JSON format, custom base release, configurable paths).

DimensionReasoningScore

Specificity

Names the domain ('changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44)') and exactly two concrete actions ('Generates the "what's new" release summary and diff file'). It stays at 3 rather than 4 because only 1-2 actions are listed — capabilities like JSON output or automatic predecessor calculation appear only in the body, not the description.

3 / 5

Completeness

Explicitly answers what ('Generates the "what's new" release summary and diff file for changes in the Flutter engine between two releases') and when ('When to use: Only activate when explicitly asked by the user to generate what's new in the engine, diff Flutter engine releases, or produce an engine release summary'), plus a 'When not to use' boundary. This clearly matches the anchor requiring both what and when with concrete trigger phrases.

5 / 5

Trigger Term Quality

'generate what's new in the engine, diff Flutter engine releases, or produce an engine release summary' are natural phrases a user would actually say. Not 5 because common synonyms like 'release notes' or 'changelog' are absent; not 3 because the included triggers are specific and natural rather than generic.

4 / 5

Distinctiveness Conflict Risk

A clear niche (Flutter engine release-to-release diffs) with distinct triggers and an explicit exclusion clause ('Do not use for general questions about commits, individual file history, or codebase searches'), minimizing overlap with general git/search skills.

5 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

flutter/flutter

Path

.agents/skills/engine-whats-new/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.