Read-only summary of items the teacher should look at right now: lessons taught recently that still need a class note, and paper assessments submitted by students but not yet reviewed. The starting point for any "what's on my plate today?" conversation.
Use this skill at the start of a session, especially when the teacher opens Aiko from the dashboard or sends a vague greeting. The summary gives Aiko enough context to either (a) immediately surface the top issues or (b) ask a focused follow-up.
today summary first, then route to
paper-grading or class-pacing based on what's surfaced.Do not use for per-class deep dives — call class-pacing or
roster-management for that.
Counts + first 5 of each bucket. Cheap; safe to call on every new conversation.
aiko-cli today summary --json
Returns:
{
"result": {
"counts": {
"lessons_needing_class_note": 3,
"papers_awaiting_review": 7
},
"sample": {
"lessons_needing_class_note": [
{"offering_id": "...", "offering_title": "Algebra I", "lesson_id": "...", "taught_in_class_at": 1730000000000}
],
"papers_awaiting_review": [
{"offering_id": "...", "lesson_id": "...", "student_name": "...", "submitted_at": "..."}
]
}
}
}
Full list. Use when the teacher wants to triage one bucket.
aiko-cli today lessons-needing-class-note --limit 20 --json
aiko-cli today lessons-needing-class-note --since-ms 1729900000000 --json
Full list, optionally filtered to a single offering.
aiko-cli today papers-awaiting-review --json
aiko-cli today papers-awaiting-review --offering-id ofr_123 --limit 10 --json
daily-triage. The sidecar mints a bridge JWT that includes this scope
when the teacher's message is routed to this skill.
All three tools are read-only and idempotent. Repeated invocations with
the same --tool-call-id short-circuit to the cached response.