One-click install
npx skills add https://github.com/bennoloeffler/claude-code-personal-agent-plugins-skills --skill ai-timer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-timer
Source: https://github.com/bennoloeffler/claude-code-personal-agent-plugins-skills/tree/main/plugins/ai-heartbeat-timer/skills/ai-timer
Command: npx skills add https://github.com/bennoloeffler/claude-code-personal-agent-plugins-skills --skill ai-timer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill lets you create, update, rename, and delete recurring Heartbeat-Timer entries in your timer.md using natural language, without manually editing tables.

Core Features & Use Cases

  • Create recurring reminders: Turn phrases like “every weekday at 18:00” or “every 2h” into a correctly formatted timer row.
  • Update existing schedules: Modify time, days, name, or prompt for an existing timer with validation.
  • Rename and delete safely: Handles identity changes and cleans runtime state so timers don’t duplicate or misfire.

Quick Start

Use /ai-timer to set “jeden werktag um 18:00 tagesabschluss” as a recurring reminder by telling it in one sentence.

Frequently Asked Questions about ai-timer

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

FAQPage Schema
How do I schedule recurring reminders using natural language commands?

Scheduling recurring reminders with natural language commands translates phrases like "every weekday at 18:00" into validated timer.md table rows. The system parses intent and fields to create correctly formatted recurring timer entries automatically.

Can I update existing timer schedules without manually editing tables?

Updating existing timer schedules without manual table editing is possible by requesting changes through chat. You can modify time, days, name, or prompt for an existing timer, and the system validates the update before applying it.

What is timer.md management for heartbeat channel timers?

Timer.md management for heartbeat channel timers is the process of adding, updating, and deleting recurring timer definitions in a structured table. It uses a validation script to ensure schedule entries are correctly formatted before runtime execution.

How do I safely rename a recurring timer and clean up its runtime state?

Safely renaming a recurring timer and cleaning up runtime state requires updating the timer.md identity and removing old runtime references. This prevents timer duplication or misfiring when switching schedule kinds or changing timer names.

Does the heartbeat channel validate script support interval-based recurrences?

The heartbeat channel validate script supports interval-based recurrences alongside daily, weekday, and weekend time lists. It validates parsed natural language inputs to ensure interval formats like "every 2h" are correctly structured in the timer.md file.

What are the limitations of managing recurring timers through chat commands?

Limitations of managing recurring timers through chat commands include dependency on the heartbeat-channel validate script for state validation. Complex schedule changes require parsing intent correctly, and renaming timers demands runtime state cleanup to avoid duplication.