Summarize

---
name: Summarize
description: Summarize text or local UTF-8 files via OpenAI-compatible chat completions.
requires:
  bins: []
  env:
    - SUMMARIZE_OPENAI_API_KEY
---

# Summarize

Use this skill when the user asks for concise summaries of long text or local
documents. Backed by the `summarize` extension which calls any
OpenAI-compatible chat completions endpoint.

## Use when

- "Summarize this text"
- "Give me a short summary of this file"
- "Extract key points from this note"
- Long input that would otherwise blow the context window

## Do not use when

- User asks for full verbatim rewrite
- User asks for strict legal or medical advice
- Input is binary media (audio/video) without transcript first
- Input fits comfortably in the conversation already (just summarize directly without the tool)

## Tools

### `status`
No arguments. Returns endpoint, model, key presence, size limits.

### `summarize_text`
- `text` (string, required, ≤ 60 000 chars)
- `length` (string, optional) — `short` (1–2 sentences) | `medium` (paragraph, default) | `long` (6–10 sentences)
- `language` (string, optional) — output language hint, e.g. `Spanish`

Returns `{length, language, input_chars, summary}`.

### `summarize_file`
- `path` (string, required) — UTF-8 file, max 1 MB
- `length`, `language` (optional, same)

Returns `{path, bytes, length, language, input_chars, summary}`.

## Execution guidance

- Default to `length: "medium"`. Bump to `short` if the user wants a one-liner; `long` if they ask for an exec summary or report.
- Pass `language` only if it differs from the conversation language.
- If the text is over 60k chars, chunk it before calling: split into ≤ 50k blocks, summarize each, then summarize the summaries.
- If error code is `-32011` (unauthorized) → `SUMMARIZE_OPENAI_API_KEY` missing or invalid; ask the operator.
- If error code is `-32007` (empty completion) → provider returned blank content; retry once or report.
- For binary files (PDF, DOCX) extract text first via another tool; this extension does not parse them.