CtrlK
BlogDocsLog inGet started
Tessl Logo

flet-deprecation

Use when adding or changing deprecations for Python controls/APIs in sdk/python/packages/, including V.deprecated fields, deprecated decorators, version lifecycle, and docs admonitions/labels.

71

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

88%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.

An exemplary operational skill: concrete, executable patterns for every deprecation form, an unambiguous decision order, and a release-audit workflow with explicit approval and completion checkpoints. The only structural upside is moving the longer code-pattern and release-docs detail into reference files to slim the main SKILL.md.

DimensionReasoningScore

Conciseness

The body is dense and imperative throughout — "Do not add parallel custom warning logic in before_update() when V.deprecated already covers the field", "Keep reason plain text for runtime warnings" — with no explanations of concepts Claude already knows. It falls just short of anchor 5 because a few sections (Target Release Audit's commit-format detail, the four near-identical code patterns) could be trimmed slightly without losing guidance value, matching anchor 4 (efficient, minor trimmable instances).

4 / 5

Actionability

Four complete, copy-paste-ready code patterns (field, function/method, class, property) plus a concrete audit command ("rg -n 'delete_version\s*=...' -S sdk/python/packages"), exact file paths for source-of-truth and test locations, and runnable build steps ("cd website && yarn crocodocs:generate", "yarn build") cover the common cases fully. This matches anchor 5 (fully executable, specific examples covering common cases).

5 / 5

Workflow Clarity

The Deprecation Decision Order gives a stop-at-first-fit sequence, the Target Release Audit gives an explicitly numbered audit pipeline with validation checkpoints (scan, decide, ask approval before edits, ask approval before commit, grouped commit, "Do not consider the release prep complete while unresolved removals remain"), and Release Docs Updates is a numbered 5-step sequence with commands. This matches anchor 5 — clear sequencing with explicit validation/approval checkpoints for a batch, semi-destructive operation.

5 / 5

Progressive Disclosure

The single SKILL.md is well-sectioned with a clear overview flow, and its only external pointers are one-level-deep, clearly signaled cross-skill links ("[flet-validation](../flet-validation/SKILL.md)", "[docs-conventions](../docs-conventions/SKILL.md)"); no bundle files exist to verify beyond these. At ~220 lines with the four code patterns and the full release-docs workflow inlined, some of that detail could live in reference files, which is exactly anchor 4's "minor organization gaps" rather than anchor 5's ideally split content.

4 / 5

Total

18

/

20

Passed

Description

87%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 a concrete what, an explicit "Use when" trigger, the exact repo scope, and the mechanism-specific keywords that distinguish it from sibling skills. Only minor upside remains from adding a couple of natural user phrasings (e.g., removing/sunsetting deprecated APIs) that the body actually covers.

Suggestions

Add one or two natural trigger variants users would actually say, such as "remove or sunset deprecated APIs" or "delete_version cleanup", to lift trigger-term coverage.

Mention the release/migration-docs side of the skill briefly (e.g., "and updating release breaking-changes guides") so the description matches the full scope the body covers.

DimensionReasoningScore

Specificity

Quotes like "adding or changing deprecations for Python controls/APIs in sdk/python/packages/, including V.deprecated fields, deprecated decorators, version lifecycle, and docs admonitions/labels" name several concrete artifacts and actions with a scoped path, but the action verbs themselves are limited to adding/changing rather than the fuller set (e.g., removal, migration-guide authoring) the skill covers. This sits between anchor 3 (1-2 concrete actions) and anchor 5 (multiple specific actions, comprehensive coverage), so 4 fits best.

4 / 5

Completeness

It explicitly answers both questions: the "what" is "adding or changing deprecations for Python controls/APIs ... including V.deprecated fields, deprecated decorators, version lifecycle, and docs admonitions/labels", and the "when" is the leading "Use when adding or changing deprecations for Python controls/APIs in sdk/python/packages()". This matches the anchor-5 good example pattern of concrete what plus explicit trigger phrases, and clearly exceeds anchor 4 (where "when" is only partially explicit).

5 / 5

Trigger Term Quality

Natural phrases like "deprecations", "V.deprecated fields", "deprecated decorators", "version lifecycle", and "docs admonitions/labels" give good keyword coverage within the flet niche. A few natural variants users might say are missing (e.g., "remove deprecated APIs", "delete_version", "sunset", "migration guide"), which keeps it below anchor 5 but clearly above anchor 3.

4 / 5

Distinctiveness Conflict Risk

The trigger is tightly scoped to deprecations in the flet Python package tree via "sdk/python/packages/" plus mechanism-specific terms ("V.deprecated", "deprecated decorators", "docs admonitions/labels"), a clear niche unlikely to fire for validation, docs-conventions, or general Python skills. It matches anchor 5 (clear niche with distinct triggers, minimal conflict risk) and is well above the anchor-4 overlapping-domains case.

5 / 5

Total

18

/

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

relative_links

Relative link issues: 6 suspicious

Warning

Total

15

/

16

Passed

Repository
flet-dev/flet
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.