← Back to Skills Marketplace
plaer1

Poke

by Æliott · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
57
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install pokecron
Description
Schedule reminders, alarms, recurring nudges, and deferred agent tasks with OS-nativeC timers (systemd/launchd/Task Scheduler). Reply-aware with escalation,...
README (SKILL.md)

Poke

When to Use

Use poke for reminders, alarms, recurring nudges, deferred agent work, reply-driven escalation, and reminder side effects such as scripts that start before delivery or stop when the user replies.

Core Workflow

  1. Classify the poke style from the user's request.
  2. Read the matching sub-skills/*.md file before building the command.
  3. Check for an existing matching reminder before creating a duplicate.
  4. Use --dry-run for unfamiliar flag combinations.
  5. Forward plausible user replies with poke --reply; read sub-skills/replies.md first when handling replies.

Sub-skill Routing

If making or handling... Read first
Basic one-shot, exact-time, recurring reminders, or deferred tasks sub-skills/scheduling.md
"Keep poking until I reply", escalation, rotating tones, heartbeat-style checks, unconfirmed followups, task intervals sub-skills/escalation.md
Pre/post actions, side-effect scripts, wake lights, or stop-on-reply hooks sub-skills/stages.md
User replies such as done, cancel, snooze, later, or ambiguous inbound messages sub-skills/replies.md
Quiet hours, active hours, DND, urgent delivery, or "do not wake me" behavior sub-skills/quiet-hours.md
Multiple channels, dependency chains, or per-channel visibility sub-skills/multi-channel.md
Listing, showing, cancelling, history, stats, presets, tones, path sets, or state layout sub-skills/management.md
Inferred promises like "I'll check on that tomorrow" without a precise fire time sub-skills/commitments.md
Migrating OpenClaw heartbeat polling into scheduled poke tasks sub-skills/migration.md

Notes

  • --remind is for static reminder text.
  • --task is for deferred agent work and needs --agent.
  • --channel and --target identify where delivery and replies happen.
  • Poke has no ears; inbound user messages must be forwarded explicitly.
Usage Guidance
Install only if you trust this publisher and want a scheduler that can create OS timers and run local commands later. Avoid command hooks unless you wrote the exact script, keep path sets limited to non-sensitive files, do not store secrets in commitments, and disable or avoid vector tones unless you are comfortable with the configured embedding endpoint.
Capability Tags
crypto
Capability Assessment
Purpose & Capability
The core purpose is coherent: reminders, recurring nudges, deferred agent tasks, and OS-native scheduling. However, the artifacts also make arbitrary local command hooks and reply-triggered hooks first-class persisted features, which is high-impact authority for a reminder skill.
Instruction Scope
The docs disclose many advanced behaviors, but they normalize broad reply forwarding, LLM-based reply classification, command hooks, path sets, and future prompt injection without strong consent, allowlisting, or per-execution confirmation. Commitments are documented as scoped by agent/channel/target, but the implementation injects all due commitments into task prompts.
Install Mechanism
The package is a Node CLI with no declared dependencies or install scripts. Optional migration scripts can edit OpenClaw config only with --apply and create a backup, but normal use creates scheduler entries and local runtime state.
Credentials
Access to the OpenClaw CLI/config and OS schedulers is expected for this purpose, but hook subprocesses inherit the process environment and receive reminder text plus channel/target metadata, which is broader than necessary for many reminders.
Persistence & Privilege
The skill persists reminder state, history, commitments, path sets, and systemd/launchd/schtasks timers. Persisted reminders can later run arbitrary argv commands under the user's privileges, with logging but no clear runtime approval gate.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install pokecron
  3. After installation, invoke the skill by name or use /pokecron
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release — replaces heartbeat polling with reliable, reply-aware reminders and deferred agent tasks. - OS-scheduled reminders and agent tasks: no daemons, no polling required (systemd/launchd/Task Scheduler support). - Fast reply matching: forwards user responses to auto-cancel, snooze, or confirm reminders. - Robust reminder creation, listing, management, and history—stateless delivery with local tracking. - Cross-platform support (Linux, macOS, Windows). - Modular design: sub-skills available for escalation, quiet hours, multi-channel, commitments, and more. - All state and history managed locally under `.runtime/`, no cloud storage required.
Metadata
Slug pokecron
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Poke?

Schedule reminders, alarms, recurring nudges, and deferred agent tasks with OS-nativeC timers (systemd/launchd/Task Scheduler). Reply-aware with escalation,... It is an AI Agent Skill for Claude Code / OpenClaw, with 57 downloads so far.

How do I install Poke?

Run "/install pokecron" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Poke free?

Yes, Poke is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Poke support?

Poke is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Poke?

It is built and maintained by Æliott (@plaer1); the current version is v1.0.0.

💬 Comments