rse/ase / plugin/skills/ase-docs-proofread
ase-docs-proofread
UnverifiedAnalyze the documents for spelling, capitalization, punctuation, word break, or grammar errors. Use when the user wants to "proofread" or "spellcheck" a document.
@${CLAUDE_SKILL_DIR}/../../meta/ase-control.md @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md @${CLAUDE_SKILL_DIR}/../../meta/ase-dialog.md @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md @${CLAUDE_SKILL_DIR}/../../meta/ase-common-diff.md
$ARGUMENTS
-
The project source artifacts are classified as a black box, so the user does not want them inspected or their problems surfaced. Skip the entire investigation and reporting: do not invoke any
GloborAgenttool and do not read any document, only output the following and then SKIP the remaining steps STEP 2 and STEP 3:First, use the following to give a hint on this step:
Dispatch the investigation to sub-agents via the
Agenttool so that no investigation details leak into the user-visible transcript. The sub-agents perform the silent reading and checking; only their final structured return values are consumed here.For this, first silently resolve
<getopt-arguments/>to the list of individual document files, expanding any directory or wildcard references with theGlobtool. Then partition , preserving order, into at most eight batches of roughly equal size (a single document yields a single batch), and invoke the following tool once per batch, emitting all invocations in one single message so they run in parallel:Agent( description: "Proofread Investigation (<batch-index/>/<batch-count/>)", subagent_type: "ase:ase-docs-proofread", prompt: <batch/>, run_in_background: false )Here is the space-separated list of the document file paths of the corresponding batch, is the 1-based index of that batch, and is the total number of batches, so that each parallel invocation is distinguishable in the progress display.
Parse the result message of each
Agenttool invocation as a JSON array, concatenate all those arrays, sort the combined list byfileand then numerically byline, and set to that list.You MUST NOT output anything at all in this STEP 1 beyond the above hint template and the
GlobandAgenttool invocations. -
Use the following to give a summary of the detected problems in :
Proofread Type Proofread Result SPELLING: problems found CAPITALIZATION: problems found PUNCTUATION: problems found WORD-BREAK: problems found GRAMMAR: problems found Hints:
- is the number of problems with
typeequal toSPELLINGin - is the number of problems with
typeequal toCAPITALIZATIONin - is the number of problems with
typeequal toPUNCTUATIONin - is the number of problems with
typeequal toWORD-BREAKin - is the number of problems with
typeequal toGRAMMARin
- is the number of problems with
-
-
Mark this skill as the active edit-capable skill so that the ASE
pre-tool-usehook auto-approves the subsequentEditinvocations on any invocation path (slash command orSkilltool). Call thease_state_set(key: "skill", val: "ase-docs-proofread", session: "<ase-session-id/>")tool from theaseMCP server. Do not output anything in this substep.Critical safety invariant: the marker set here grants
Editauto-approval and MUST be cleared again (substep 3 below) before this skill yields control, regardless of how the iteration in substep 2 ends - whether it completes normally, is aborted early (e.g. anEditfailure, an unparseable value, or any other unexpected condition), or is otherwise interrupted. If you ever stop or bail out of substep 2 early, you MUST still perform substep 3 first. Never leave this marker active for a later, unrelatedEdit. -
Set to the number of problems in and to
0. Then iterate over all problems:-
Increment by one (the 1-based position of the current within ). Set to the
typefield of . Set to thefilefield of . Set to thelinefield of . Set to thedescriptionfield of . Set to thecontext_beforefield of . Set to theold_textfield of . Set to thenew_textfield of . Set to thecontext_afterfield of .Then normalize the change to its minimal form, so that the proposed diff shows exactly the lines the later
Editwill actually change: while the first line of is identical to the first line of , move that line from both to the end of and increment by one; likewise, while the last line of is identical to the last line of , move that line from both to the front of . Finally, trim to its last two lines and to its first two lines.Then, unless is equal
grey(where the full unified diff is suppressed and no context lines are rendered at all), silently read the current content of with theReadtool - reusing the content read for the same earlier in this iteration, unless anEditwas applied to it in between - and set to its lines, stripped of the line-number prefixes the tool adds. Set to empty if the file cannot be read.Whenever is non-empty, re-derive both context parts from it, overriding the sub-agent supplied values, so the rendered diff shows real context even when a sub-agent supplied none: set to the up to two lines of directly before line (empty if is
1) and to the up to two lines of starting at line ( + ), where is the number of lines in (empty if that line is beyond the end of the document). Keep the sub-agent supplied values only when is empty. -
Report the problem with the following :
-
The project source artifacts are classified as a grey box, so the user does not want the full artifact internals surfaced: suppress the full unified diff and instead show only a condensed one-line representation. Determine as the single-line collapse of (join its lines with
⏎, or∅when is empty for a pure insertion) and as the same collapse of (or∅when empty for a pure deletion). Then report the correction with the following :CORRECTION:
<old-snippet/>→<new-snippet/> -
In the following, you MUST NOT use your built-in tool! Instead, you MUST just show a custom dialog according to the expanded
custom-dialogdefinition. You MUST closely follow this definition:Set ACCEPT.
-
Check and dispatch accordingly:
-
Invoke the
Edittool to apply the change by replacing with at :. The operation will be auto-approved by the ASEpre-tool-usehook (which tracks the active skill), so no interactive permission prompt will appear. Then continue with the next . -
Generate a new proposal for the same , incorporating the user's free-text hint from after the "OTHER:" prefix. Reassign , , and to reflect this refined proposal ( stays anchored to the existing text at :; and carry the refinement) so the subsequent rendering and any
Edituse the new proposal rather than the original. Then re-apply the minimal-form normalization of substep 1 to the refined and (so the re-rendered diff again shows exactly the changed lines) and go back to substep 2 of thisfor-iteration. There is no cap on refinement rounds - keep refining until the user picksACCEPTorREJECT. -
Skip this without any
Editcall and continue with the next .
-
-
-
Clear the active edit-capable skill marker now that all
Editinvocations are done, so a later unrelatedEditis not auto-approved. Call thease_state_delete(key: "skill", session: "<ase-session-id/>")tool from theaseMCP server. Do not output anything in this substep. -
You MUST NOT output any further additional explanations or summaries at the end of this skill processing, except for the following final :
-
Finally, give the closing hint by expanding the following (which, depending on the configured , may expand into nothing and hence emit no output at all):
-
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: 463k | 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: 195k | 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: 195k | 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: 195k | Updated | Claude CodeCodex | Verified | Install |