Composables

Android Workmanager Notifications

Community

krutikJain

Schedule reliable background work, reminders, and notification delivery with WorkManager and Android execution limits.

Overview

Repository
krutikJain/android-agent-skills
Publisher
krutikJain
Stars
14
Forks
5
Bundled files
5
License
MIT
Updated
Mar 25, 2026

Installation

tmp=$(mktemp -d)
git clone --depth 1 https://github.com/krutikJain/android-agent-skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/android-workmanager-notifications" ~/.claude/skills/android-workmanager-notifications
rm -rf "$tmp"

Instructions

Android WorkManager Notifications

When To Use

  • Use this skill when the request is about: android workmanager job, background reminder notification android, reliable retry workmanager.
  • Primary outcome: Schedule reliable background work, reminders, and notification delivery with WorkManager and Android execution limits.
  • Read references/patterns.md when you need the API-choice matrix for WorkManager vs foreground service vs alarms.
  • Read references/scenarios.md for unique-work, notification-permission, and reminder-delivery review paths.
  • Handoff skills when the scope expands:
  • android-permissions-activity-results
  • android-performance-observability

Workflow

  1. Choose the right execution API first: WorkManager for deferrable guaranteed work, foreground services for ongoing user-visible work, and exact alarms only when clock-time precision and policy requirements truly demand them.
  2. Make work idempotent and uniquely addressable with explicit names, input data contracts, backoff policy, and cancellation behavior.
  3. Apply constraints, expedited work, and retry semantics only where they match user value and platform limits.
  4. Build notification delivery as part of the contract: channels, importance, tap action, runtime permission handling, and graceful behavior when notifications are denied.
  5. Validate duplicate scheduling, reboot/process death, and degraded states before handing off performance or permission-specific follow-up work.

Guardrails

  • Keep background work idempotent and cancellation-aware.
  • Use unique work or unique periodic work when the feature represents one logical reminder or sync pipeline.
  • Treat expedited work as scarce and user-valuable; do not use it as a generic queue-jumping flag.
  • If a worker uses network constraints, ensure the app declares the permissions required for those constraints on modern Android versions.
  • Keep notification value intact even when the user declines POST_NOTIFICATIONS; the app still needs a visible recovery path.

Anti-Patterns

  • Blocking the main thread with disk or network calls.
  • Expecting WorkManager to deliver exact wall-clock timing like an alarm API.
  • Re-enqueueing duplicate reminder work instead of using unique work policies.
  • Failing to create channels or handle notification permission decline paths.
  • Hiding critical foreground or exact-alarm policy assumptions in comments instead of code and docs.

Review Focus

  • Is WorkManager the right API for this workload?
  • Are unique work policies, constraints, retry, and cancellation explicit?
  • Do reminder and notification paths still make sense if notifications are denied?
  • Are expedited, foreground, or exact-alarm behaviors justified and policy-safe?

Examples

Happy path
  • Scenario: Find background-work and notification hooks before proposing a scheduling change.
  • Command: rg -n "WorkManager|Worker|enqueueUnique|PeriodicWorkRequest|NotificationChannel|POST_NOTIFICATIONS" examples
Edge case
  • Scenario: Review exact-alarm, expedited, or network-constrained work for platform-sensitive behavior.
  • Command: rg -n "setExpedited|setRequiredNetworkType|AlarmManager|ForegroundInfo" examples
Failure recovery
  • Scenario: Disambiguate WorkManager requests from permission prompts and performance work.
  • Command: python3 scripts/eval_triggers.py --skill android-workmanager-notifications

Done Checklist

  • The chosen execution API matches the workload's timing and visibility requirements.
  • Unique work, retry, cancellation, and constraint behavior are explicit.
  • Notification channel and permission behavior are handled as part of the feature contract.
  • Process-death, reboot, and duplicate-scheduling behavior have been considered.

Official References

Bundled files

FAQ

What does Android Workmanager Notifications do?

Schedule reliable background work, reminders, and notification delivery with WorkManager and Android execution limits.

Who made Android Workmanager Notifications?

krutikJain (a community member) publishes it in the krutikJain/android-agent-skills repository on GitHub.

Is Android Workmanager Notifications free?

Yes. Android Workmanager Notifications is open source, published by krutikJain under the MIT license.

What comes with Android Workmanager Notifications?

Its instructions and 5 files the agent reads only when a task needs them, such as references, examples or scripts.

Which agents can use Android Workmanager Notifications?

Any coding agent that reads SKILL.md files, including Claude Code, Codex, Cursor, GitHub Copilot and Gemini CLI. The agent loads the skill when a task matches its description.

What are agent skills?

An agent skill is a folder with a SKILL.md file: instructions that teach a coding agent how to do one kind of task, and optionally files it can read while it works. The agent keeps only the skill's name and description in mind and reads the rest when a task calls for it.

How are agent skills different from MCP servers?

An MCP server gives an agent new tools to call, code that runs somewhere and returns results. A skill gives it knowledge: how to approach a task with the tools it already has. Many agents use both.

How can my agent test my Android app?

Robomori lets coding agents create, start and control Android emulators and devices from one command, so they can install your app, take screenshots and check dark mode, font sizes and languages.

You're subscribed

The next lesson lands in on Wednesday.