android-notifications
Integrate push notifications using Firebase Cloud Messaging and NotificationCompat on Android. Use when setting up FCM, creating notification channels, or handling local notifications.
53
61%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/android/android-notifications/SKILL.mdQuality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that clearly defines its scope around Android push notifications with specific technologies (FCM, NotificationCompat). It includes an explicit 'Use when' clause with natural trigger terms and is highly distinctive. The description is concise yet comprehensive, covering both the what and when effectively.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: integrating push notifications, using Firebase Cloud Messaging, using NotificationCompat, setting up FCM, creating notification channels, and handling local notifications. | 3 / 3 |
Completeness | Clearly answers both 'what' (integrate push notifications using FCM and NotificationCompat on Android) and 'when' (explicit 'Use when' clause covering setting up FCM, creating notification channels, or handling local notifications). | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'push notifications', 'Firebase Cloud Messaging', 'FCM', 'notification channels', 'local notifications', 'NotificationCompat', 'Android'. These cover common variations of how developers would describe notification-related tasks. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche: Android push notifications via FCM and NotificationCompat. The combination of platform (Android), technology (Firebase Cloud Messaging, NotificationCompat), and task (notification channels, local notifications) makes it very unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
22%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a reasonable high-level overview of Android notification integration concerns but critically lacks executable code examples, making it far less actionable than it should be for a coding-focused skill. The content reads more like a checklist of considerations than a skill that would enable Claude to implement notifications correctly. The workflow is presented as unordered bullets rather than a clear sequence, which is problematic for a multi-step integration task.
Suggestions
Add concrete, executable code examples for key operations: creating a NotificationChannel, building a notification with NotificationCompat.Builder, requesting POST_NOTIFICATIONS permission, and implementing FirebaseMessagingService.
Restructure the Implementation Guidelines as a sequenced workflow (1. Create channel → 2. Request permission → 3. Set up FCM service → 4. Handle notification taps) with validation checkpoints (e.g., verify channel creation, test notification delivery).
Either provide the referenced 'references/implementation.md' bundle file with detailed code examples, or inline the essential code snippets directly in the SKILL.md.
Remove the Anti-Patterns section or merge it into the main guidelines since it largely repeats information already stated above it.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient but some bullet points contain unnecessary bolding noise and slight redundancy (e.g., 'No Missing Channel' anti-pattern repeats what was already stated in the Channels guideline). Generally respects Claude's intelligence but could be tighter. | 2 / 3 |
Actionability | No executable code examples, no concrete commands, no copy-paste ready snippets. The content describes what to do at a high level (create NotificationChannel, implement FirebaseMessagingService) but never shows how with actual code. For a coding skill about Android notifications, this is vague direction rather than concrete guidance. | 1 / 3 |
Workflow Clarity | There is no clear sequenced workflow. The bullet points are unordered guidelines rather than a step-by-step process. For a multi-step integration task (setting up FCM, creating channels, handling permissions, handling taps), there are no validation checkpoints or sequencing of steps. | 1 / 3 |
Progressive Disclosure | There is a reference to 'references/implementation.md' which suggests a one-level-deep structure, but no bundle files were provided to verify the reference exists. The SKILL.md itself is appropriately brief as an overview, but the reference is a single link with no description of what it contains, and the lack of actual bundle content means the progressive disclosure promise is unverifiable. | 2 / 3 |
Total | 6 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
Total | 9 / 11 Passed | |
- Repository
- HoangNguyen0403/agent-skills-standard
- Commit
3df717f
- 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.