Getting it into your agent
It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.
git clone --depth 1 https://github.com/ravila4/claude-adhd-skillsnpx agentmods add skills/ravila4/claude-adhd-skills/nudgeWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/ravila4/claude-adhd-skills/nudge)<a href="https://agentmods.dev/skills/ravila4/claude-adhd-skills/nudge"><img src="https://agentmods.dev/badge/skills/ravila4/claude-adhd-skills/nudge/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/ravila4/claude-adhd-skills/nudge"><img src="https://agentmods.dev/badge/skills/ravila4/claude-adhd-skills/nudge.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00051 | $0.00683 |
| Opus 5 | $0.00026 | $0.00342 |
| Sonnet 5 | $0.00010 | $0.00137 |
| Haiku 4.5 | $0.00005 | $0.00068 |
Grade A, and why
nudge scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 92 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Nudge
Human-facing reminder system for managing focus and pacing. Nudges are stored in SQLite and surface via hook when due.
When to Use
Proactively set nudges when:
- User mentions a stopping time ("stop me at 11", "I need to wrap up by 5")
- User mentions a deadline or meeting ("standup in 30 minutes")
- A long focus session (2+ hours) is underway without breaks
- User asks for a reminder explicitly
Do NOT use nudge for:
- Tasks Claude will complete in the current turn
- Information that should go in memory instead
- Process monitoring (e.g., "check if the build finished", "see if the pipeline completed"). Nudges require user input (prompt submission) to fire, so they cannot check on running processes. Use
sleep <seconds>in Bash instead -- it blocks inline and resumes without requiring user interaction.
Tools
Scripts are located at hooks/:
Adding a Nudge
python3 hooks/add_alert.py "<time>" "<message>"
Time formats:
HH:MM- Today at that time (e.g.,23:00)YYYY-MM-DD HH:MM- Specific datetime+30m- 30 minutes from now+2h- 2 hours from now
Acknowledging a Nudge
When a nudge has been addressed, dismiss it:
python3 hooks/ack_alert.py <id>
Viewing Nudges
sqlite3 hooks/alerts.db "SELECT id, due_at, message FROM alerts WHERE acknowledged = 0"
Message Format
Messages are notes-to-self for Claude. Include:
- Reason - Why this nudge was set
- Action - What to do when it fires
Format: reason - action to take
Examples
User asked to stop at 11 PM - wrap up current work and suggest break
User mentioned standup in 30m - remind to prep notes
2 hours on debugging session - check if stuck, suggest break
Deployment window opens at 14:00 - remind user to run deploy script
When Nudges Fire
Due nudges appear in the system-reminder on each prompt submission. When a nudge fires:
- Read the message to understand context and action
- Take the specified action (remind user, suggest break, etc.)
- Acknowledge the nudge so it doesn't repeat
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 11d ago First seen · 92 lines · 51 tokens per session scan A 38cd80ff4a3f
nudge is a skill published in the GitHub repository ravila4/claude-adhd-skills (148 stars, last pushed 6mo ago), licensed MIT. It adds 51 tokens to every session and 683 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
obsidian-bases
Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries. Use when working with .base files, creating database-like views of notes, or when the user mentions Bases, table views, card views, filters, or formulas in Obsidian.
obsidian-cli
Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more. Also supports plugin and theme development with commands to reload plugins, run JavaScript, capture errors, take screenshots, and inspect the DOM. Use when the user asks to interact with their…
chief-of-staff
Personal Chief of Staff system for ADHD-ish operators. Vault-based, loop-driven, nervous-system-aware. Built and lived-in across daily sessions on real consulting, content, and long-running personal work.
notion-artifact-capture
Use when a user says “save to Notion” for research, reports, drafts, references, or generated artifacts and wants a reusable default destination. Bootstraps a generic Notion AI Output Library under a user-created shared parent page, saves typed metadata and optional Markdown, verifies every write through the live API…
my-adhd-caveman
Self-contained output mode: ADHD actable structure (action first, numbered steps, one next action, one-line progress) plus caveman diction (drop fluff/articles, fragments, fewer tokens). Use when the user says "adhd-caveman", "my-adhd-caveman", or invokes /my-adhd-caveman. Needs no other skills.
google-workspace
Gmail, Calendar, Drive, Contacts, Sheets, and Docs — through Hermes-managed OAuth and a thin CLI wrapper. When gws is installed, the skill uses it as the execution backend for broader Google Workspace coverage; otherwise it falls back to the bundled Python client implementation.