Skip to main content
skill CX Codex

away-brief — Claude Code skill: what it does, how to install

The away-brief Claude Code skill creates a short report on completed work, blockers, pending questions, and quota readings. It runs when someone asks what happened while they were away.

Apache-2.0 ★ 869 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add sno-ai/sno-station-skills --skill away-brief -a claude-code
Open on GitHub

What away-brief does

The skill runs sno away-brief run to assemble a one-page report from Git commits, charter and progress records, Reach inbox questions, and quota readings. Each section gets its own share of the 60-line limit, so a long list of completed work cannot crowd out questions or quota details. Unreadable sources get an error note while the rest of the report still prints.

It needs Bash 4+, git, jq, reach 2.0+, heartbeat 1.0+, and subscription-quota-check 1.0+. On macOS without GNU date, python3 is also required, and --since must use an ISO 8601 date. Set --as <your seat> or SNO_REACH_ADDR to read the inbox. Quota usage is compared with an earlier reading; without one, the skill does not estimate spend. Uncommitted or unrecorded work will not appear in the report.

What it helps with

  • summarize work completed since the owner left
  • surface unfinished tasks and missing checks
  • list questions waiting for the owner's answer
  • compare current quota readings with an earlier snapshot

Example prompts for the agent

  • Summarize what happened over the last 12h, including blockers and questions for me.
  • Show the work status since I left yesterday and include quota changes.
  • Record the current quota readings before I leave with sno away-brief mark.

How to install away-brief

1Skills CLI (Vercel)

npx skills add sno-ai/sno-station-skills --skill away-brief -a claude-code

2Manually: put the files in place

~/.claude/skills/skill/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/skill/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about away-brief

How do I install away-brief in Claude Code?

Run npx skills add sno-ai/sno-station-skills --skill away-brief -a claude-code. The skill file is at ~/.claude/skills/skill/SKILL.md.

What does away-brief do?

It creates a one-page status report covering completed work, blockers, questions awaiting an answer, and quota readings. Quota changes are based on a comparison with an earlier reading.

What does away-brief need to run?

It requires Bash 4+, git, jq, reach 2.0+, heartbeat 1.0+, and subscription-quota-check 1.0+. On macOS without GNU date, it also needs python3; set --as <your seat> or SNO_REACH_ADDR to read the inbox.

Source text

SKILL.md · Apache-2.0
---
name: away-brief
description: "Give the owner one page when they come back from sleep, a meeting or a long run: what got done, what is stuck, what waits for their answer, and what it cost in quota. Use when the owner asks what happened while they were away, wants a status page, or when you finish a long stretch of work and must report it."
requires:
  programs:
    - {name: reach, min_version: "2.0"}
    - {name: heartbeat, min_version: "1.0"}
    - {name: subscription-quota-check, min_version: "1.0"}
  harness:
    - {slot: 4.shell, need: required}
    - {slot: 4.file-read-write, need: required}
---

# away-brief

`sno away-brief run` reads what already exists and prints one page of at most 60 lines. It changes nothing
except its own list of quota readings, and Reach, which may note that it has seen the cards that the inbox
read listed (it never moves, accepts or finishes them).

```
## Done       new commits, charters delivered since the cutoff (with how many checks are proven),
              progress records that finished or are still going
## Stuck      charters not finished (with the numbers of the checks not yet proven), progress records
              with tasks left that nobody has touched for two hours
## Needs you  Reach cards of type question or decision waiting in the inbox
## Spend      your heartbeats, and each vendor's quota now with the change since the last reading
```

A source it cannot read prints `not read: <what> -> <why>` and the rest of the page still prints. Each section has
its own share of the 60 lines; items beyond it are replaced by an `and N more not shown` line, so a long Done list
never pushes out what waits for the owner or the quota.

Prerequisites: bash 4+, git and jq; without GNU date (macOS) also python3, and a `--since` date must then be
ISO 8601. It uses `sno deliver-proof` (the `deliver` skill) to count
proofs, `sno reach inbox`, `sno heartbeat --list` and `sno subscription-quota-check` when they are installed.

## Use

1. Run `sno away-brief run --since 12h` in the project's git folder. Change `--since` to the time the owner
   left (`8h`, `2d`, or a date). Add `--repo DIR` for each other repository and `--charters DIR` for
   folders that hold charters or progress records outside those repositories. Add `--as <your seat>` (or
   set `SNO_REACH_ADDR`) so the inbox is read.
2. Read the page and tell the owner the three things that matter most, in plain words: what is finished,
   what is blocked and why, and what needs their answer. Keep the page's evidence paths so they can open
   the file. Do not add work that is not on the page.
3. Quota: a reading shows usage now, not spend. When the owner is about to leave, run `sno away-brief mark`
   once; it stores a reading, so the next page can show what was spent since. Without an earlier reading
   the page says so instead of guessing.

## What the page can and cannot say

- "Done" is only what is in git, in a delivered charter, or in a finished progress record. Work that was
  never committed or recorded does not appear.
- "Stuck" is a charter whose recorded proofs are missing or failing, or a progress record (written by
  `sno handoff-checkpoint`) with tasks left and no update for two hours. An agent that is busy but does not
  write records looks quiet.
- "Needs you" is only the seat you name. Questions sent to other seats are not shown.
- The change in quota compares two readings of the same window; if the window reset in between, the page
  says so instead of showing a negative number.

© sno-ai · Apache-2.0 · sno-ai/sno-station-skills

Similar skills

SKILL.md skills catalog →

From the same set40

The whole set →
medic The medic Claude Code skill checks whether an agent team is ready to work and reports problems. Run it on a new machine or after agents stop communicating. CX Codex +1 ★ 869repo stars peer-review The peer-review Claude Code skill runs adversarial reviews of code, plans, specs, and migration manifests. It starts on review or audit requests and can carry code findings through a fix loop. CX Codex +1 ★ 869repo stars cross-vendor-security-audit The cross-vendor-security-audit Claude Code skill reviews security questions and searches code for vulnerabilities. It runs the full audit workflow on explicit audit, pen-test, or report requests. CX Codex +1 ★ 869repo stars catch-report The catch-report Claude Code skill compares findings from peer reviews with mistakes agents catch themselves. It runs when someone asks for review results or a weekly summary. CX Codex +1 ★ 869repo stars agentic-time-estimate agentic-time-estimate — a Claude Code skill that estimates an AI agent’s total runtime or remaining work from measured progress. It gets owner-facing clock times from sno report-time and never estimates human developer time. CX Codex +1 ★ 869repo stars ts-coder The ts-coder Claude Code skill guides TypeScript and TSX implementation and refactoring within an existing repository. It applies to work on types, APIs, and migrations. CX Codex +1 ★ 869repo stars test-writer test-writer — a skill for Claude Code writes and improves test code. It activates when Codex is asked to add or change tests. CX Codex +1 ★ 869repo stars shellscript-coder shellscript-coder — a Claude Code skill for writing and refactoring shell scripts and command-line tools. It applies to automation, Git helpers, and infrastructure tasks. CX Codex +1 ★ 869repo stars

Project sponsors

Companies that keep this analytics open