reminder

Play MP3 audio cues for Codex task lifecycle events via ffplay.

Updated Jan 5, 2026
One-click install
npx skills add https://github.com/LLLLimbo/Skills --skill reminder-llllimbo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reminder
Source: https://github.com/LLLLimbo/Skills/tree/main/reminder
Command: npx skills add https://github.com/LLLLimbo/Skills --skill reminder-llllimbo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates audio alerts for Codex task lifecycle events by playing short MP3 cues via ffplay, ensuring notifications are delivered without blocking the workflow.

Core Features & Use Cases

  • Non-intrusive alerts: plays a single audio cue for TASK_FINISHED, ERROR, or NEED_HELP events.
  • WSL-friendly: designed to work in Windows Subsystem for Linux environments with ffplay in PATH.
  • Asset-driven cues: expects MP3 files under assets/audio/: TASK_FINISHED.mp3, ERROR.mp3, NEED_HELP.mp3, and maps events to the appropriate cue.

Quick Start

Test the reminder by triggering each event type: TASK_FINISHED, ERROR, NEED_HELP. Verify the corresponding MP3 plays once. Ensure ffplay is installed and accessible in PATH and that assets/audio contains the corresponding MP3 files. ffplay -nodisp -autoexit assets/audio/TASK_FINISHED.mp3 ffplay -nodisp -autoexit assets/audio/ERROR.mp3 ffplay -nodisp -autoexit assets/audio/NEED_HELP.mp3

Frequently Asked Questions about reminder

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

FAQPage Schema
How do I set up audio alerts for task events in WSL?

To set up audio alerts for task events in WSL, install ffplay in your PATH and place MP3 files in assets/audio. The system maps TASK_FINISHED, ERROR, and NEED_HELP events to corresponding audio cues.

Why use ffplay for non-blocking workflow notifications?

Using ffplay for non-blocking workflow notifications ensures audio cues play without interrupting automated processes. It executes short MP3 alerts for task lifecycle events and exits immediately via the -autoexit flag.

Do I need specific MP3 files to trigger task lifecycle alerts?

Yes, you need specific MP3 files to trigger task lifecycle alerts. You must place TASK_FINISHED.mp3, ERROR.mp3, and NEED_HELP.mp3 inside the assets/audio directory for the event mapping to function correctly.

Can I test task event audio alerts without running a full workflow?

You can test task event audio alerts without a full workflow by running ffplay commands directly. Execute ffplay -nodisp -autoexit assets/audio/TASK_FINISHED.mp3 to verify each specific event cue plays successfully.

What limitations exist when playing audio cues in Windows Subsystem for Linux?

A key limitation when playing audio cues in Windows Subsystem for Linux is the strict dependency on ffplay being accessible in PATH. Without ffplay configured properly, the automated event alerts will not execute.

What is the best way to get notified when automated tasks finish or encounter errors?

The best way to get notified when automated tasks finish or encounter errors is configuring asset-driven audio alerts. This approach maps specific task lifecycle events to distinct MP3 cues, providing immediate non-intrusive feedback.