joshu-proactive

Automates proactive owner nudges, reply resolution, and stale Kanban card hygiene.

108|11|Updated Jun 26, 2026
One-click install
npx skills add https://github.com/db-aeon/joshu-oss --skill joshu-proactive-db-aeon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: joshu-proactive
Source: https://github.com/db-aeon/joshu-oss/tree/main/integrations/hermes/skills/proactive/joshu-proactive
Command: npx skills add https://github.com/db-aeon/joshu-oss --skill joshu-proactive-db-aeon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Blocked Kanban tasks stall silently when an owner forgets to respond, and stale cards accumulate without anyone reviewing them. This Skill keeps work moving by nudging the owner about blocked tasks, interpreting their replies to unblock cards, and running daily hygiene sweeps to close stale items. ## Core Features & Use Cases - Compose owner-facing nudges: Generates first-person SMS or email messages for clarify, nudge, stale-review, and feedback-acknowledgment scenarios, with machine-routing references like Ref: pj/t_<id>. - Resolve owner replies: Runs a dedicated Hermes session per task to interpret the owner's reply, update the originating Kanban card, and reconcile the entire project slug when waiting conditions change. - Daily hygiene sweeps: Uses proactive_hygiene_prepare to scan all boards, auto-closes high-confidence stale cards with audit comments, and routes ambiguous cards to stale-review nudges. - Use Case: A scheduling task is blocked awaiting the owner's availability. The hourly tick sends an SMS nudge; when the owner replies "Tuesday works", the resolve flow comments on the card, unblocks it, triggers the scheduling follow-up, and confirms back to the owner. ## Quick Start Ask the agent to review the blocked Kanban cards and send the owner a nudge about any task waiting on their input.

Frequently Asked Questions about joshu-proactive

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

FAQPage Schema
How do I nudge an owner about a blocked Kanban task?

The hourly sweep runs via the Joshu REST endpoint POST /api/proactive/tick on localhost, which composes a first-person SMS or email nudge for blocked tasks needing owner input. Each nudge ends with a Ref: pj/t_<id> line for machine routing of the reply.

How are owner replies to proactive nudges handled?

Owner replies trigger a dedicated Hermes session named proactive:resolve:<taskId> rather than the sticky SMS session. The agent comments the reply on the card, treats the owner text as authoritative, then unblocks, completes, or re-blocks the card and reconciles sibling project tracks.

Can stale Kanban cards be closed automatically?

Yes, the daily hygiene run auto-closes cards only with high-confidence evidence, such as a confirmation sent or a worker noting the task is done, verified via gbrain queries on source threads. Ambiguous cards are never auto-closed; they become stale-review nudges instead.

What is forbidden during Kanban hygiene runs?

Hygiene forbids execute_code, SQLite queries, Python or shell scripts for Kanban analytics, and direct edits to .joshu/proactive/state.json. All results must be recorded through the proactive_hygiene_record tool, and onboarding cards must never be auto-closed.

When does the skill not send a nudge to the owner?

The hourly tick does not nudge for cards blocked with awaiting reply on a counterparty, since the wait is external. Nudges are also limited to one per local day, within weekday working hours, with evenings and weekends off until the owner opts in.