rse/ase / plugin/skills/ase-docs-distill
ase-docs-distill
VerifiedDistill a provided document into a flat, importance-ranked list of its key points, each with a salience rank, a rationale, and a verbatim line-cited evidence snippet. Use when the user wants to "distill", "summarize the key points", or "extract the essence" of a document or pasted text.
help.md
View on GitHub
## NAME
`ase-docs-distill` - Distill Document Key Points
## SYNOPSIS
`ase-docs-distill`
[`--help`|`-h`]
[`--top`|`-t` *N*]
*document-reference*
## DESCRIPTION
The `ase-docs-distill` skill reads a *provided document* and distills it
into a *flat*, *importance-ranked* list of its *key points*. The
*document-reference* is resolved *probe-as-file-first*: if the argument names
a *readable file* it is read from disk; otherwise the argument is taken
*verbatim* as *pasted text*. The document is read *silently* - only the
final ranked list is shown - so even a large document does not flood the
transcript.
Each emitted point is *one atomic claim, decision, or fact* (not a
section-level summary) and carries four things: a *0-10 salience rank*
reflecting its *importance to the reader* (impact and centrality, *not*
its position in the document), a *one-line rationale* justifying *why* it
earns that rank, an exact *line-range citation* (`file:Ls-Le`, or `:Ls-Le`
for pasted text), and a *verbatim evidence* snippet copied from the source
that *proves* the point. The points are emitted as a *bulleted list* -
one block per point, each showing its *LOCATION*, *EVIDENCE*,
*RATIONALE*, and *RANK* - sorted from highest to lowest salience, so the
ranking is *auditable* rather than an opaque ordering.
The `--top`/`-t` *N* option is a *length dial* that bounds the list to at
most *N* points (default *5*). It is an *upper bound only*: when the
document has fewer salient points than *N*, the skill emits only the
points it found and *never pads* the list with filler; a `0`, negative, or
non-numeric value falls back to the default *5*.
## OPTIONS
- `--top`|`-t` *N*:
Bound the ranked list to at most *N* key points (default *5*). The
bound is a *cap*, never a *quota* - fewer points are emitted when the
document does not contain *N* salient ones, and an invalid or
non-positive *N* reverts to the default.
## ARGUMENTS
- *document-reference*:
The document to distill - either a *path* to a readable file or the
*text* itself pasted inline. If it resolves to a readable file the
file is read; otherwise it is treated verbatim as pasted text.
## SCENARIOS
- You want the key points of a document extracted and ranked
- You want the essence of a long text without reading all of it
- You want each key point backed by verbatim, line-cited evidence
- You want a pasted text or file boiled down to what matters
## EXAMPLES
Distill the key points of a document file:
```text
❯ /ase-docs-distill doc/architecture.md
```
Distill only the top 3 key points:
```text
❯ /ase-docs-distill --top 3 doc/architecture.md
```
Distill a pasted block of text:
```text
❯ /ase-docs-distill The system shall accept payments in EUR and USD only.
```
## SEE ALSO
[`ase-meta-search`](../ase-meta-search/help.md), [`ase-docs-proofread`](../ase-docs-proofread/help.md), [`ase-meta-why`](../ase-meta-why/help.md).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 198k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |