skills.rest
xvxv-stack7
xvxv-stack7COMMUNITY
Explore all skills by this author →
GitHub

proactive-checkin

Schedules recurring AI wake-ups that read device state and decide whether to notify the user.

10|2|Updated Jul 9, 2026
Search Tags:#Android#notifications#polling#proactive AI#cron#Termux#device state
One-click install
npx skills add https://github.com/xvxv-stack7/android-claude-agent --skill proactive-checkin-xvxv-stack7
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: proactive-checkin
Source: https://github.com/xvxv-stack7/android-claude-agent/tree/main/skills/android-monitor/proactive-checkin
Command: npx skills add https://github.com/xvxv-stack7/android-claude-agent --skill proactive-checkin-xvxv-stack7

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Event-driven triggers only fire when something happens, leaving the AI silent during long quiet periods. This Skill adds a polling timer that periodically wakes the AI so it can check on the user even when no event occurred. ## Core Features & Use Cases - Scheduled Wake-ups: Uses a CronCreate timer (e.g., every 30 minutes) to prompt the AI with current device state. - State-Driven Judgment: The AI reads gaze_state.json, health_data.json, and last_contact.json, then decides on its own whether to send a termux-notification or output NO_REPLY. - Rate Limiting: Enforces a minimum 30-minute gap between messages and a maximum of 8 automated messages per day. - Use Case: The user has been on a video app for two hours at midnight; the timer wakes the AI, which reads the state and sends a natural first-person reminder to rest. ## Quick Start Set up a recurring 30-minute cron prompt that reads my device state files and sends me a natural notification only when something is worth saying.

Frequently Asked Questions about proactive-checkin

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make an AI proactively message me on Android?▼

Create a recurring CronCreate timer that prompts the AI every 30 minutes to read device state files and decide whether to send a termux-notification. The AI outputs NO_REPLY when nothing is worth saying, so it only speaks when warranted.

What is the difference between event-driven triggers and polling check-ins?▼

Event-driven triggers fire within 60 seconds when a specific change occurs, like screen wake or app switch. Polling check-ins fire on a fixed schedule regardless of events, letting the AI evaluate the overall state picture and catch long silent periods.

How do I prevent an AI from sending too many proactive notifications?▼

Track the last outreach timestamp in last_contact.json and enforce a minimum 30-minute interval between messages. Additionally cap total automated messages at 8 per day across all channels.

What device state does the AI read before deciding to notify?▼

The AI reads gaze_state.json for foreground app, screen status, and battery, plus health_data.json for heart rate, steps, and sleep hours. It also checks last_contact.json to know when it last reached out.

When should I use polling instead of event triggers for AI notifications?▼

Use polling when the moments you care about produce no event, such as the user being quiet for hours or staying up late with the screen on. Event triggers catch discrete changes; polling catches the absence of change.

Related Skills

Explore More Personal & Entrepreneur Skills→
zeenie-aizeenie-ai
356

battery-skill

Retrieve Android battery level, charging state, temperature, and health.

Community
Basic
vellum-aivellum-ai
1.0k

notifications

Route user-facing alerts through a unified notification pipeline with deduplication and audit logging.

Official
Intermediate
kolife01kolife01

evi-external-poller

Manage external event triggers with a supervisor timer and pending file system.

Community
Intermediate
sarkcesscrewpaysarkcesscrewpay

system-architecture.md

Define production architecture for alert-driven AI trading intelligence workflows.

Community
Advanced