ase-docs-distill

SkillDocs & knowledge

Distill 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.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the ase-docs-distill skill

What this skill tells your AI

The instructions your AI receives, as published by rse/ase in plugin/skills/ase-docs-distill/SKILL.md and read by ahel’s review.

@${CLAUDE_SKILL_DIR}/../../meta/ase-control.md @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md

$ARGUMENTS

Procedure

  1. Resolve the document source from using probe-as-file-first semantics:

    1. Only output the following and then STOP immediately:

    2. Treat the entire as a file path. If it resolves to a readable file, read that file and capture its content together with its line numbers into , and set to the file path.

    3. Treat verbatim as pasted text, capture it into numbering its lines from 1, and set to empty (so locations are cited as :Ls-Le).

    4. Only output the following and then STOP immediately:

    You MUST NOT output anything else in this STEP 1.

  2. Read and distill it into its key points.

    1. Extract the document's key points, where each point is one atomic, self-contained claim, decision, or fact - not a section-level summary that blends several claims.

    2. For each point, determine:

      • A on a 0-10 salience scale reflecting its importance-to-the-reader (impact, centrality, consequence)

        • not its position in the document.
      • A one-line that justifies why the point earns that .

      • A citing the exact source line range as <origin/>:Ls-Le (for a file) or :Ls-Le (for pasted text), where Ls is the start line and Le is the end line.

      • A verbatim snippet, copied exactly from (but with all newlines replaced with spaces and multiple spaces collapsed into a single space), that proves the point. The cited snippet MUST prove the point verbatim. If it does not, re-investigate and re-cite correctly.

    3. Sort the points by from highest to lowest. Within the same rank, keep the order of first appearance in .

    4. Apply the top-bound as an upper bound only: keep at most min(<getopt-option-top/>, number of salient points) points and never pad the list with filler to reach the bound. If is non-numeric or less than or equal to 0, use the default 5 instead.

    You MUST NOT output anything in this STEP 2.

  3. For each distilled point, emit the following , where is its salience rank, is the atomic claim, is its line-range citation, is the verbatim proving snippet, and is the one-line salience justification:

    KEY POINT:

    ◯ LOCATION: ◯ EVIDENCE: "<evidence/>" ◯ RATIONALE: ◯ RANK: /10

    In the , mark up the line-range reference as code (with backticks) and prepend it with .

    Keep the overall report concise and brief. Do not output any further explanation.

Signals

GitHub stars
52
Forks
5
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
ase-docs-distill
Source
github.com/rse/ase