Attention Please

Overview

Play a short audible alert and a spoken prompt indicating which project needs attention. Use this as the final step after completing work on every response, and also right before asking the user for input.

Source Of Truth And Publishing

GitHub repository: https://github.com/Mindgames/attention-please
Local development repository: ~/Projects/skills/attention-please
Do not edit installed copies in ~/.agents/skills/... or ~/.codex/skills/... directly.
Update this repository, push to GitHub, open a PR, then reinstall via skills.

Install Or Refresh

This repository uses skills.sh as the primary install path for Codex, Claude, and most agentic CLI/IDE clients.

Install globally (recommended):

npx skills add Mindgames/attention-please -g -y

Project scope (default):

npx skills add Mindgames/attention-please

Target specific agents (optional):

npx skills add Mindgames/attention-please --agent codex

npx skills add Mindgames/attention-please --agent claude-code

Install for multiple agents in one command:

npx skills add Mindgames/attention-please --agent codex claude-code -g -y

After reinstall, restart your agent client if needed so it reloads skills.

Path Resolution (avoid missing-skill errors)

Always open this skill using the absolute path from the active session skills list.
Do not guess repo-relative .codex/skills/... paths unless that exact path was listed by the session.

Rules (non-negotiable)

Always run this script at the end of every response, even if you are not asking for input.
If you missed it in the previous turn, run it immediately at the start of the next turn before doing anything else, then continue.
Treat a missed run as a bug; prioritize correcting it as soon as you notice.

Workflow

Run from inside the target repo so the script can read the git remote.
Execute the installed script using the absolute path from the active session skill list:
```
/absolute/path/to/attention-please/scripts/attention-please.sh
```
If your environment does not expose the session skill path directly, use the actual install location used in that session (for example under ~/.agents/... or ~/.codex/...) as that absolute path.
Run this immediately before sending your final response to the user.
Continue with your response to the user.

Project name resolution

Primary: git remote get-url origin and extract the repo name.
Remote override: set ATTENTION_PLEASE_REMOTE.
Fallback: repo folder name.
Override: set ATTENTION_PLEASE_PROJECT.

Sound and speech

Sound: macOS afplay with /System/Library/Sounds/Ping.aiff by default.
Override sound: set ATTENTION_PLEASE_SOUND.
Disable sound: set ATTENTION_PLEASE_NO_SOUND=1.
Speech: macOS say; if unavailable, the message prints to stdout.
Disable speech: set ATTENTION_PLEASE_NO_SAY=1.
Voice: set ATTENTION_PLEASE_SAY_VOICE.
Rate: set ATTENTION_PLEASE_SAY_RATE.
If you see AudioQueueStart failed, set ATTENTION_PLEASE_NO_SAY=1 (or ATTENTION_PLEASE_NO_SOUND=1) to avoid audio device errors.

Message override

Override the full phrase with ATTENTION_PLEASE_MESSAGE.

Example

ATTENTION_PLEASE_PROJECT="project-name" ATTENTION_PLEASE_SAY_VOICE="Samantha" /absolute/path/to/attention-please/scripts/attention-please.sh