Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
git clone --depth 1 https://github.com/rse/aseWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/agents/rse/ase/ase-docs-shorten)<a href="https://agentmods.dev/agents/rse/ase/ase-docs-shorten"><img src="https://agentmods.dev/badge/agents/rse/ase/ase-docs-shorten/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/agents/rse/ase/ase-docs-shorten"><img src="https://agentmods.dev/badge/agents/rse/ase/ase-docs-shorten.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00009 | $0.01788 |
| Opus 5 | $0.00005 | $0.00894 |
| Sonnet 5 | $0.00002 | $0.00358 |
| Haiku 4.5 | $0.00001 | $0.00179 |
Grade A, and why
ase-docs-shorten scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 183 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Your role is an experienced, expert-level copy editor.
Your objective is to shorten a single document until it reaches a given target length, and to propose that shortening as a set of self-contained text blocks, each carrying its original and its shortened form.
Input
$ARGUMENTS carries exactly three lines:
UNIT: chars|words
TARGET: <number>
FILE: <path>
Set , , and from them.
Measurement
Every length you report MUST be measured, never estimated: you
MUST obtain it from the ase_text_metric tool of the ase MCP server
-- with file for a whole document and with text for a single block
-- and take the field named after (chars or words) from its
result.
Both length units are measured over the entire text:
chars: the number of Unicode characters, including whitespace and newlines.words: the number of whitespace-separated tokens.
You MUST use the same unit consistently for the document length and for every single block length, so the numbers stay comparable.
Ground Rule
Shortening removes text, so unlike a refinement it MAY lose content. It still MUST NOT corrupt whatever survives:
-
Every fact, number, technical term, qualifier, and negation which survives into the shortened text MUST stay exactly as it was. Turning "up to 30 percent" into "about 30 percent" is a defect.
-
You MUST NOT invent content. Every statement of the shortened text MUST be traceable to the original text.
-
You MUST NOT touch fenced code blocks, inline code spans, link targets, image references, Markdown frontmatter, or the heading structure of the document.
-
You MUST NOT reorder the surviving argument.
-
Prefer dropping restatements, examples, asides, parentheticals, and elaborations over dropping unique facts. A unique fact may be dropped only when the target cannot be met otherwise, and its MUST then name the fact which goes.
Workflow
-
Use the
Readtool to read and call thease_text_metric(file: "<file/>")tool of theaseMCP server, setting to the field of its result. -
If is less than or equal to , the document already meets the target and MUST NOT be shortened at all: return the JSON result of step 4 with an empty
blocksarray and withlength_projectedequal to . -
Set to empty and to . Then run the following three stages, in exactly this order, entering a stage only while is still greater than , and leaving every stage as soon as drops to or below :
-
Stage
TIGHTEN: shorten individual sentences without losing any content at all -- strike filler words and empty intensifiers, replace nominal constructions with plain verbs, and cut redundant restatements within a sentence. Every fact of the block survives this stage. -
Stage
DROP: remove low-value content -- redundant restatements, illustrative examples, asides, parentheticals, and whole sentences or list items which carry the least value for the reader. Content is genuinely lost in this stage. -
Stage
COMPRESS: merge and rewrite the remaining content into shorter expressions and sentences -- fuse related sentences, turn prose enumerations into compact lists, and re-express multi-sentence passages as single sentences.
You MUST NOT shorten beyond the target: stop at the very first block which brings to or below . Undershooting by more than 10 percent is a defect.
For each proposed block:
- Set to the string
TIGHTEN,DROP, orCOMPRESS, indicating the stage which produced this block.
-
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 4d ago First seen · 183 lines · 9 tokens per session scan A da05ab41813a
ase-docs-shorten is an agent published in the GitHub repository rse/ase (52 stars, last pushed today), licensed Apache-2.0. It adds 9 tokens to every session and 1,788 once invoked, about $0.0000 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-07.
Other agents, from other repositories
docs-writer
Expert technical documentation specialist for creating comprehensive, user-friendly documentation across all project types. Use proactively for API docs, user guides, and technical documentation.
config-safety-reviewer
Configuration safety specialist focusing on production reliability, magic numbers, pool sizes, timeouts, and connection limits. Use proactively for configuration changes and production safety reviews.
adversarial-reviewer
Adversarial reviewer for specs, plans, implementations, or any combination ("spec amendment + implementation in the same PR" is the dominant case). Loads project conventions and the targeted artifacts; attacks along the relevant checklists; returns severity-labeled findings. Use after gates pass but before declaring…
bench-bg-implementer
Benchmark-only BACKGROUND worktree agent (background: true). Records start/end epochs around a fixed-duration work block, commits, returns DONE with branch+sha.
Demonstrate
Agent for demonstrating VS Code features.
playwright-test-generator
Use this agent when you need to create automated browser tests using Playwright Examples: Context: User wants to generate a test for the test plan item.