.md file to compare - side-by-side diff against krisp-inbox
krisp-inbox
description: "Triggers on prompt mention of 'krisp-inbox'."
What it does for you
Reads your latest meetings and surfaces follow-ups waiting on you.
What it produces
A recent result, so you can see the kind of work it returns.
loading…
How to get it
These run inside the Snappy workspace. Want this working in your business? I set skills like this up with you, in one focused week.
For developers how this skill is built, graded, and how it runs
at a glance- the short version
what's inside - the parts that make up a skill 2/4 present
A skill is just a few plain-text files. Only the main one is required. The rest are optional, added as the work needs them. This is what the skill is made of; how it runs is just below.
state/skills/krisp-inbox.md
present
state/lib/krisp-inbox.ts
not present
state/bin/krisp-inbox/
not present
state/skills/krisp-inbox.agents.md
present
how it runs - the shared frame every skill uses 3/5 present
Every skill runs the same way. One part does the work, a separate part checks it, and a short loader hands the AI exactly what it needs for the job. Anything this skill doesn't use shows a one-line note saying why, on purpose, not by accident.
No separate check found. Without one, the part that makes the work could end up approving its own work, worth a closer look.
state/log/evals.ndjson - ALWAYS dedup against ray-todo for the same date — krisp-inbox covers follow-ups that never became commitments, ray-todo covers commitments; overlap must be reported (even as 0)
- ALWAYS write the dedup count to the output file — the shape gate's dedup_run check requires explicit overlap mention
- ALWAYS use ~/.claude/cache/krisp/meetings.json — Krisp is the one documented MCP exception in program.md "Don't list", isolated to this daily cron dump
- NEVER skip writing the file — score 0.0 if no state/log/krisp-inbox/<date>.md is produced
what it has learned - fixes written back in over time sample
When a run hits something this skill didn't handle, the fix gets written back into the skill so it doesn't happen again. FIXED means it was corrected on the spot. LOGGED means it's queued for a bigger rewrite. Either way, the skill gets a little better and never makes the same mistake twice.
- Loading feedback rows…
how the work flows- step by step
skill is prose, runs the steps in `state/skills/krisp-inbox.md` (read cache → dispatch gemini per meeting → dedup → write)
SKILL.md- the skill, written out in plain English
Backed by: state/lib/log.ts (reads ~/.claude/cache/krisp/ dump) + state/lib/eval.ts (writes the score row)
krisp-inbox
Reads ~/.claude/cache/krisp/meetings.json, groups by participant, and emits a "who's waiting on what" summary. Complement to ray-todo (which covers commitments); this covers follow-ups that never became commitments.
Steps
- Read meetings cache (refresh if stale).
- For each meeting, dispatch
geminiwith transcript (if available) +
prompt "list follow-ups Robert owes the other participant."
- Dedupe against
ray-todooutput for the same date. - Write to
state/log/krisp-inbox/<date>.md.
Eval
Auto. Shape gate on the produced summary file:
| Check | Required | What it verifies |
|---|---|---|
file_written | yes | state/log/krisp-inbox/<date>.md exists and is non-empty |
has_followups | yes | Body contains at least one - [ ] checkbox row OR an explicit "no follow-ups" sentinel |
dedup_run | yes | Output mentions ray-todo overlap count (even if 0) - proves the dedup pass executed |
Score 1.0 if all three pass, 0.5 if file written but missing dedup line, 0.0 if no file. Eval row written via state/lib/eval.ts.
Graduation
Prose; no script until the dedup logic is stable.
AGENTS.md- what the AI loads when this skill comes up
krisp-inbox - loader
Per-turn rules for the krisp-inbox skill. Full reference: state/skills/krisp-inbox.md. Do not skip these.
Critical Rules
- ALWAYS dedup against
ray-todofor the same date - krisp-inbox covers follow-ups that never became commitments, ray-todo covers commitments; overlap must be reported (even as 0) - ALWAYS write the dedup count to the output file - the shape gate's
dedup_runcheck requires explicit overlap mention - ALWAYS use
~/.claude/cache/krisp/meetings.json- Krisp is the one documented MCP exception inprogram.md"Don't list", isolated to this daily cron dump - NEVER skip writing the file - score 0.0 if no
state/log/krisp-inbox/<date>.mdis produced
Commands
|invoke: skill is prose, runs the steps in state/skills/krisp-inbox.md (read cache → dispatch gemini per meeting → dedup → write) |cache refresh: bash state/bin/krisp/refresh.sh (cron-driven dump) |eval log: state/log/evals.ndjson (skill: "krisp-inbox")
Known Pitfalls
- Cache may be stale if
krisp/refresh.shcron didn't run - refresh before scoring rather than emitting an empty inbox - Output must contain at least one
- [ ]checkbox row OR an explicit "no follow-ups" sentinel - silent empty fails thehas_followupsshape check
Self-Test
An agent reading this should correctly:
- [ ] Cite the ray-todo overlap count in the output file even when the count is 0?
- [ ] Read the Krisp cache from
~/.claude/cache/krisp/meetings.json? - [ ] Score 0.5 if file written but dedup line missing, 1.0 if all three shape checks pass?
Self-report
If this loader fell short, append a line:
echo "[$(date -u +%FT%TZ)] krisp-inbox: <what was missing>" >> ~/.claude/logs/snappy-os-loader-feedback.log
<!-- kernel-ok: historical attribution for the PID-loader pattern. -->
Self-correcting loader (PID feedback)
This is the rule that makes loaders learn. Ported from snappy-kernel, where it demonstrably worked: the snappy-dom-cartographer skill mapped Skool admin UI once, every later ship-agent inherited the full map for free.
Before you finish, do two things:
1. Fix gaps (P - proportional). MANDATORY. If this loader didn't cover your case - if you had to read another file, run an undocumented command, work around a wrong selector, or discover a quirk - you MUST attempt an Edit to this .agents.md before you log.
- Default action: edit this file. Surgical. Add the missing line, table
row, or code example where it belongs. No restructuring.
- Only
LOGGEDis allowed when: the fix needs >10 lines, spans multiple
files, or requires a structural rewrite. In that case the state/regen/drain.sh queue picks it up asynchronously.
- "I didn't have time" / "it's minor" / "the next agent will figure it out"
are NOT valid reasons. Minor gaps compound - that's the whole point of this loop.
- Concrete example of a valid P-fix: discover
agent-browser screenshot
takes path positionally not as --output <path>. One line in a table. Edit it in. Do not just log it.
- The goal: the next agent never has to leave the loader.
2. Log the result.
echo "[$(date -u +%FT%TZ)] <skill-name>: <what was missing or fixed> [FIXED|LOGGED]" >> state/log/agents-md-feedback.log
FIXED= you patched this loader inline (P-fix).LOGGED= too large for inline; the PostToolUse enqueue + Stop-hook drain
will rewrite the loader from scratch on next session-end.
Do not skip this. Every agent run must leave the system better than it found it. The loader is the setpoint; you are the sensor; the gap is the error signal; closing the gap is the correction.
api.ts- the code it can call
⚠ no api.ts - this skill has no typed action surface
scripts- helper scripts it can run
prose-only skill - no sidecar under state/bin/ yet. Steps, if any, are described in SKILL.md.
how we check it- the checks, plus the last 10 runs
| timestamp | verb | score | primary_issue | artifact |
|---|---|---|---|---|
| 2026-04-26 04:55Z | - | 1.00 | - | - |
| 2026-04-26 04:26Z | - | 1.00 | - | - |
| 2026-04-25 04:11Z | - | 1.00 | - | - |
| 2026-04-21 15:58Z | - | 1.00 | - | - |
| 2026-04-21 15:56Z | - | 1.00 | - | - |
| 2026-04-21 03:53Z | - | 1.00 | - | - |
| 2026-04-26 04:55Z | - | 1.00 | - | - |
| 2026-04-26 04:26Z | - | 1.00 | - | - |
| 2026-04-25 04:11Z | - | 1.00 | - | - |
| 2026-04-21 15:58Z | - | 1.00 | - | - |