🎁 Get the FREE AI Skills Starter GuideSubscribe →
BytesAgainBytesAgain
🦀 ClawHub

Excretion Tracker

by @herve-clawd

Track bathroom events (pee/poop) via chat: start time, duration, color, pain, and Bristol stool scale. Generates weekly summaries and optional constipation r...

Versionv0.4.1
Downloads608
TERMINAL
clawhub install excretion-tracker

📖 About This Skill


name: excretion-tracker description: "Track bathroom events (pee/poop) via chat: start time, duration, color, pain, and Bristol stool scale. Generates weekly summaries and optional constipation reminders when no poop occurs past a threshold (default 24h, user-configurable). Use for urination/defecation logging, bowel/bladder trends, stool form tracking, diarrhea/constipation monitoring. Search keywords: bathroom tracker, toilet log, BM tracker, stool tracker, poop tracker, pee tracker. Triggers: poop, pee, bowel movement, stool, urination, bathroom log, toilet log, constipation, diarrhea, Bristol, night pee (nocturia)."

Excretion Tracker(排泄记录)

This skill is chat-only: always log via the bundled CLI and store data locally.

0) Safety / scope

  • No medical diagnosis.
  • If the user reports blood in stool/urine, severe pain, fever, or symptoms lasting >24–48h, recommend professional medical advice.
  • 1) What to collect (required vs optional)

    New: Attempt (no output)

    If the user reports abdominal pain / urge and no pee/poop produced (e.g., “蹲了20分钟都没有产出”), log an attempt event with:
  • start time
  • duration
  • pain
  • intent: poop | pee | unknown
  • notes
  • Do not force color/Bristol when there was no output.

    Required for every log

  • type: pee | poop | attempt (no output)
  • start_at: timestamp (default: now)
  • duration_sec: integer (if unknown, ask)
  • pain: 0–3 (0 none, 1 mild, 2 moderate, 3 severe)
  • Color requirement

  • For pee and poop: color is required
  • For attempt (no output): color is not required
  • Poop-only

  • bristol: 1–7 (ask if poop)
  • Optional

  • notes: short free text
  • 2) Bristol stool scale (what it is)

    Bristol(布里斯托大便分类)把便便形态分为 1–7:

  • 1–2:偏干硬(便秘倾向)
  • 3–4:相对正常
  • 5–7:偏稀(腹泻倾向)
  • If user doesn’t know, ask 1 question:

  • “更像:1/2(很硬成颗粒) 3/4(成形) 5/6/7(软烂到水样)?”
  • See details: references/bristol.md.

    3) Color options (display to user in Chinese; English in Title Case)

    Pee color

  • Clear(透明)
  • Pale Yellow(浅黄)
  • Yellow(黄色)
  • Dark Yellow(深黄)
  • Amber(琥珀色)
  • Red(红)
  • Brown(褐)
  • Other(其他)
  • Poop color

  • Normal Brown(正常棕)
  • Light Brown(浅棕)
  • Yellow(黄)
  • Green(绿)
  • Black(黑)
  • Red(红)
  • Pale(偏浅/灰白)
  • Other(其他)
  • Internal storage can still use snake_case enums, but never show snake_case to the user.

    4) Chat-only flow (includes optional card feedback)

    When the user says they went to the bathroom:

    1) Determine type (pee/poop). If unclear, ask. 2) Ask only missing required fields in the user's language (Chinese). - If you need to show any English options, format them in Title Case (no underscores). 3) Ask for: - start time (if not specified) - duration (minutes/seconds) - color - pain (0–3) - for poop: bristol (1–7) 4) Log the event via CLI: excretion log .... 5) Optional visual card (SOP): - Cards are disabled by default. - If the user enables cards, detect whether nano-banana-pro is installed. - If installed: follow references/card_sop.md to generate a consistent cute 3:4 card using nano-banana-pro and send it. - If not installed: skip silently (no extra questions).

    Enable/disable:

  • Enable: excretion config set card_enabled 1
  • Disable: excretion config set card_enabled 0
  • Note: This skill intentionally ships no image-generation scripts. The agent executes the SOP by invoking nano-banana-pro only when cards are enabled. If user says “刚刚/刚才” → use now. If user provides duration like “2分钟” → convert to seconds.

    5) Commands to run

  • Log pee:
  • - excretion log pee --start-at "..." --duration-sec 60 --color yellow --pain 0 --notes "..."

  • Log poop:
  • - excretion log poop --start-at "..." --duration-sec 180 --color normal_brown --pain 1 --bristol 4 --notes "..."

  • Show weekly summary:
  • - excretion week

  • Set reminder threshold (hours):
  • - excretion config set poop_remind_hours 24

    6) Weekly summary (what to send)

    Include:

  • Poop frequency + avg interval
  • Bristol distribution (counts)
  • Poop pain average
  • Pee frequency (day vs night)
  • Red-flag events count (blood/pain>=3)
  • “Not medical advice” note
  • 7) Files

  • CLI: scripts/excretion.py
  • Bristol reference: references/bristol.md
  • (Optional) Card generation SOP: references/card_sop.md (uses nano-banana-pro if installed; otherwise skip)