rse/ase/ase-docs-distill

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

<purpose name="ase-docs-distill"> Distill Key Points </purpose>

<expand name="getopt" arg1="ase-docs-distill" arg2="--top|-t=5"> $ARGUMENTS </expand>

<objective> Distill the content <getopt-arguments/> into a flat, importance-ranked list of its key points - each point an atomic claim carrying a 0-10 salience rank, a one-line rationale, and a verbatim, line-cited evidence snippet - keeping at most <getopt-option-top/> points. </objective>

Procedure

<flow>

1. <step id="STEP 1: Resolve Input">

Resolve the document source from <getopt-arguments/> using probe-as-file-first semantics:

1. <if condition="<getopt-arguments/> is empty">

Only output the following <template/> and then STOP immediately:

<template> ⧉ ASE: ✪ skill: ase-docs-distill, ▶ status: no document to distill </template>

</if>

1. Treat the entire <getopt-arguments/> as a file path. If it

resolves to a readable file, read that file and capture its content together with its line numbers into <source/>, and set <origin/> to the file path.

1. <if condition="<getopt-arguments/> does NOT resolve to a readable file">

Treat <getopt-arguments/> verbatim as pasted text, capture it into <source/> numbering its lines from 1, and set <origin/> to empty (so locations are cited as :Ls-Le).

</if>

1. <if condition="<source/> is empty">

Only output the following <template/> and then STOP immediately:

<template> ⧉ ASE: ✪ skill: ase-docs-distill, ▶ status: no document to distill </template>

</if>

You MUST NOT output anything else in this STEP 1.

</step>

1. <step id="STEP 2: Distill Key Points">

Read <source/> 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.

1. For each point, determine:

• A <rank/> on a 0-10 salience scale reflecting its

importance-to-the-reader (impact, centrality, consequence)

• not its position in the document.

• A one-line <rationale/> that justifies why the point earns

that <rank/>.

• A <location/> 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 <evidence/> snippet, copied exactly from

<source/> (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.

1. Sort the points by <rank/> from highest to lowest. Within the

same rank, keep the order of first appearance in <source/>.

1. Apply the top-bound <getopt-option-top/> 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 <getopt-option-top/> is non-numeric or less than or equal to 0, use the default 5* instead.

You MUST NOT output anything in this STEP 2.

</step>

1. <step id="STEP 3: Report Ranked Points">

For each distilled point, emit the following <template/>, where <rank/> is its salience rank, <point/> is the atomic claim, <location/> is its line-range citation, <evidence/> is the verbatim proving snippet, and <rationale/> is the one-line salience justification:

<template>

<ase-tpl-bullet-normal/> KEY POINT: <point/>

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

</template>

In the <location/>, 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.

</step>

</flow>