CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

flutter-notifications

Implement or repair Flutter local notifications and remote push delivery across permission, scheduling, token, lifecycle, payload, interaction, and reconciliation flows. Use for notification behavior; route ordinary API transport, navigation, persistence, and custom native bridge work to their specialists.

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

The canonical home for this skill is thiennc-tesoglobal/flutter-skills

SKILL.md
Quality
Evals
Security

Quality

Content

86%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-architected orchestration skill: lean overview, explicit routing to real one-level-deep references, clear boundary ownership, and a strong verification section. The main gaps are a handful of abstract directives without concrete examples and the absence of explicit validate/retry feedback loops in the workflow.

Suggestions

Add a short concrete example of the delivery contract (e.g., a sample notification payload JSON with stable ID, type/version, dedup key, and destination intent) to anchor the abstract field list in 'Establish one delivery contract'.

Turn the Verification section into an explicit validate-then-fix loop (e.g., 'If a lifecycle path fails on device, fix the wiring and re-run before reporting') to add error-recovery checkpoints.

Replace abstract permission directives like 'provide a useful disabled state' with one or two concrete behaviors (e.g., what UI/state to fall back to per platform when permission is denied).

DimensionReasoningScore

Conciseness

The body is dense and lean — every section delivers project-specific guidance ("Define stable notification IDs, payload version/type, allowed fields, destination intent, deduplication key...") with zero explanation of concepts Claude already knows (no 'what is FCM', no library tutorials). The Preflight enumeration is long but purposeful (an inspection checklist), not padding, so the 5 anchor fits better than 4's 'minor instances that could be trimmed'.

5 / 5

Actionability

Guidance is largely executable for an instruction-only skill: files to read ("Read pubspec.yaml, SDK constraints, enabled platforms, native manifests"), contract fields to define, and a concrete verification matrix ("foreground, background, terminated launch, denied permission, restart, time-zone change... malformed or duplicate payloads"). It stops short of 5 because some directives remain abstract ("provide a useful disabled state", "model permission as user-controlled state") with no concrete example or command pattern for the common cases.

4 / 5

Workflow Clarity

A coherent sequenced flow is present — Preflight inspection, contract establishment, mode routing, boundaries, then Verification — with an explicit verification section and a conditional checkpoint ("When repository evidence is unavailable, state that inspection is still required and keep proposed changes conditional"). It is not 5 because checkpoints are prose-level rather than explicit validate-then-fix-then-retry loops, and the sequence is implied by section order rather than enumerated steps.

4 / 5

Progressive Disclosure

A lean ~40-line overview with a task-type-to-file routing map ("For device-scheduled reminders... read local notifications", verified to exist at references/local-notifications.md, and likewise for remote-push-notifications.md and platform-delivery.md), all references exactly one level deep with no nested .md chains, plus an explicit load-guard ("Load only the references required by the current task"). This matches the 5 anchor: clear overview, well-signaled one-level-deep references, easy navigation.

5 / 5

Total

18

/

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 concrete capabilities across the full notification lifecycle, gives an explicit 'Use for' trigger, and explicitly fences off adjacent skill territories to avoid mis-triggering. The only weakness is modest synonym coverage (no 'push notifications' plain phrase, no FCM/APNs provider names).

DimensionReasoningScore

Specificity

"Implement or repair Flutter local notifications and remote push delivery across permission, scheduling, token, lifecycle, payload, interaction, and reconciliation flows" names concrete actions (implement, repair) with comprehensive coverage of the notification domain across seven enumerated flow areas. It is not score 4 because coverage has no minor gaps — every major notification flow is explicitly listed; it cannot be inferred as vague at any lower anchor.

5 / 5

Completeness

The 'what' is explicit ("Implement or repair Flutter local notifications and remote push delivery...") and the 'when' is explicit with concrete trigger guidance ("Use for notification behavior") plus negative triggers ("route ordinary API transport, navigation, persistence, and custom native bridge work to their specialists"). Both are clearly and concretely answered, matching the 5 anchor; score 4 would require a less explicit 'when', which is not the case.

5 / 5

Trigger Term Quality

Natural terms include "Flutter local notifications", "remote push", "permission", "scheduling", and "token" — phrases users would plausibly say. It falls short of the 5 anchor because common variations users actually type ("push notifications" as a plain phrase, "FCM", "APNs", "notification tap") are missing, though the coverage is otherwise good rather than merely 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche (Flutter notification lifecycle) and actively defuses conflicts by routing overlapping work ("ordinary API transport, navigation, persistence, and custom native bridge work") to their specialists. This is minimal conflict risk, matching the 5 anchor rather than the 4 anchor's 'minor overlap risk'.

5 / 5

Total

19

/

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

thienqo/flutter-skills

Path

skills/flutter-notifications/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.