@rse/ase 0.9.65 → 0.9.67

package/plugin/skills/ase-code-craft/help.md

@@ -32,18 +32,18 @@ entirely and applies the change set to the affected artifacts itself.
 
 ##  OPTIONS
 
-`--auto`|`-a`:
+-   `--auto`|`-a`:
     Automatically pick the recommended feature approach without
     asking the user via the interactive dialog.
 
-`--dry`|`-d`:
+-   `--dry`|`-d`:
     Compose the plan *without* the `##  VERIFICATION` section. When
     `ase-task-implement` later applies such a plan, it strictly skips
     the entire verification phase (no build, tests, linter,
     type-checker, or program execution) once the source files have
     been modified.
 
-`--direct`|`-D`:
+-   `--direct`|`-D`:
     Craft the feature *immediately* and *in place*: skip the
     feature approaches, the interactive dialog, and the entire task
     plan ceremony, and directly apply the complete change set to the
@@ -52,20 +52,20 @@ entirely and applies the change set to the affected artifacts itself.
     `--next` have no effect, as neither approaches are proposed nor a
     plan is composed.
 
-`--interactive`|`-i`:
+-   `--interactive`|`-i`:
     Craft *interactively*: implies `--direct` and, once the initial
     *feature* has been applied, repeatedly asks for the *next change*
     with a free-text dialog and immediately applies it in place, too,
     until the user stops the loop by answering `DONE`.
 
-`--quick`|`-Q`:
+-   `--quick`|`-Q`:
     Shorthand alias for `-a -d -n IMPLEMENT,DELETE`: automatically pick
     the recommended feature approach, compose the plan *without* the
     `##  VERIFICATION` section, immediately hand off to `ase-task-implement`,
     and finally `ase-task-delete` the now-consumed plan. This gives a
     single, fast *one-shot* crafting mode.
 
-`--next`|`-n` *option*[,...]:
+-   `--next`|`-n` *option*[,...]:
     Automatically choose the next step after composing the plan.
     *option* is a single token or a *comma-separated chronological
     list* of tokens; an `IMPLEMENT`, `PREFLIGHT`, or `GRILL` head token
@@ -84,7 +84,7 @@ entirely and applies the change set to the affected artifacts itself.
 
 ##  ARGUMENTS
 
-[*task-id*:] *feature*:
+-   [*task-id*:] *feature*:
     Description of the *feature* to craft. Optionally prefixed with
     a *task-id* followed by a colon to bind the resulting plan to
     a specific task id.

package/plugin/skills/ase-code-dissect/help.md

@@ -59,22 +59,22 @@ cleanly and are then reported as failed; stage everything and use
 
 ##  OPTIONS
 
-`--max-parts`|`-m` *count*:
+-   `--max-parts`|`-m` *count*:
     Upper bound for the number of derived parts (default: `8`). The
     lower bound is always `2`, because fewer parts are no dissection.
 
-`--staged`|`-s`:
+-   `--staged`|`-s`:
     Dissect the *staged* changes (the Git index against `HEAD`) instead
     of the working copy changes. Untracked files are then *not* folded
     in, because they are by definition not part of the index.
 
-`--dry`|`-d`:
+-   `--dry`|`-d`:
     *Report only* -- print the dissection table but create *no*
     artifacts at all, so the decision stays fully reversible. Note that
     this meaning differs from `--dry`/`-d` in `ase-code-craft`, where it
     instead omits the `##  VERIFICATION` section of the composed plan.
 
-`--force`|`-f`:
+-   `--force`|`-f`:
     Remove and re-create already existing worktrees and branches of the
     derived names. Without this option, the skill detects colliding
     targets *before* writing anything, reports them, and stops with
@@ -82,7 +82,7 @@ cleanly and are then reported as failed; stage everything and use
 
 ##  ARGUMENTS
 
-*dissect-hint*:
+-   *dissect-hint*:
     A free-text hint telling *how* the change set should be split. If
     omitted, the parts are derived from the change set alone.
 

package/plugin/skills/ase-code-edit/help.md

@@ -36,12 +36,12 @@ implementation until it passes). The *querying* state and every
 
 ##  OPTIONS
 
-`--mode`|`-m` `auto`|`craft`|`refactor`|`resolve`:
+-   `--mode`|`-m` `auto`|`craft`|`refactor`|`resolve`:
     Select the tenet set internalized for the implementation: `craft`
     (CRAFTING), `refactor` (REFACTORING), or `resolve` (RESOLVING).
     The default `auto` infers the tenet set from the query itself.
 
-`--grill`|`-g`:
+-   `--grill`|`-g`:
     Grill the query before implementing, similar to `ase-task-grill`:
     raise 1-10 questions per round which resolve the open points of the
     query. Each question carries a `FOCUS-AREA` -- `DOMAIN`
@@ -68,27 +68,27 @@ implementation until it passes). The *querying* state and every
     merged back into the WHAT and HOW parts of the query. Without
     `--grill`, no questions are asked at all.
 
-`--grill-rounds`|`-r` *n*:
+-   `--grill-rounds`|`-r` *n*:
     The number of grill rounds to apply (default: `1`). Each round
     starts from scratch from only the current WHAT and HOW parts,
     forgetting all information of previous rounds, and closes with an
     `EDIT TODO` box. Only effective together with `--grill`.
 
-`--verify`|`-v`:
+-   `--verify`|`-v`:
     Verify whether the implementation fulfills the requirements, by
     running the available verification commands (build, tests, linter,
     type-checker) and adjusting the failing parts of the change set
     until the verification passes. Without `--verify`, strictly no
     verification is performed at all.
 
-`--worktree`|`-w`:
+-   `--worktree`|`-w`:
     Apply the change sets inside a dedicated Git worktree (as
     `ase-task-implement --worktree`) instead of the current working
     copy. One single worktree, named by a two-word id derived from the
     first query, serves the whole skill run: all `--loop` iterations
     land in it and it is left uncommitted for review.
 
-`--loop`|`-l`:
+-   `--loop`|`-l`:
     Loop the whole state cycle: after each iteration, ask for the next
     edit query via the interactive `Edit Query` dialog and repeat, until
     the user answers with its fixed `STOP SKILL` option or cancels the
@@ -96,7 +96,7 @@ implementation until it passes). The *querying* state and every
 
 ##  ARGUMENTS
 
-*query*:
+-   *query*:
     Description of the edit to perform. When omitted, the skill asks
     for the query via an interactive `Edit Query` dialog, carrying the
     fixed `STOP SKILL` option plus free-text input.

package/plugin/skills/ase-code-explain/help.md

@@ -20,7 +20,7 @@ notice), and *GOTCHAS* (what to not stumble over).
 
 ##  ARGUMENTS
 
-*source-reference*:
+-   *source-reference*:
     A file, directory, function, or other reference to the source code
     to explain.
 

package/plugin/skills/ase-code-insight/help.md

@@ -20,7 +20,7 @@ a *MODULE STRUCTURE* Mermaid diagram of modules and their imports.
 
 ##  ARGUMENTS
 
-*code-references*:
+-   *code-references*:
     One or more file or directory references to source code that
     should be inspected for insights.
 

package/plugin/skills/ase-code-lint/help.md

@@ -54,11 +54,11 @@ the code, and comments contradicting the code.
 
 ##  OPTIONS
 
-`--auto`|`-a`:
+-   `--auto`|`-a`:
     Automatically apply every proposed correction without asking the
     user via the interactive dialog.
 
-`--severity`|`-S`=(`LOW`|`MEDIUM`|`HIGH`):
+-   `--severity`|`-S`=(`LOW`|`MEDIUM`|`HIGH`):
     Set the *severity floor* (default `LOW`): findings below the chosen
     threshold are silently suppressed, ordered `LOW` < `MEDIUM` <
     `HIGH`. The default `LOW` keeps all findings; `ACCEPTED` findings are
@@ -66,19 +66,19 @@ the code, and comments contradicting the code.
     severity* order `HIGH`, `MEDIUM`, `LOW`, `ACCEPTED`, keeping the
     `file`/`line` order within the same severity.
 
-`--include`|`-i`=*aspect*[`,`...]:
+-   `--include`|`-i`=*aspect*[`,`...]:
     Restrict the checked code quality aspects to the given
     comma-separated list of aspect ids (e.g. `A01,A04`). Without this
     option, all twenty-one aspects are checked.
 
-`--exclude`|`-e`=*aspect*[`,`...]:
+-   `--exclude`|`-e`=*aspect*[`,`...]:
     Remove the given comma-separated list of aspect ids from the checked
     code quality aspects. Applied *after* `--include`, so
     `-i A01,A02 -e A02` checks `A01` only.
 
 ##  ARGUMENTS
 
-*source-reference*:
+-   *source-reference*:
     A file, directory, or other reference to the source code to lint.
 
 ##  SCENARIOS

package/plugin/skills/ase-code-refactor/help.md

@@ -31,18 +31,18 @@ entirely and applies the change set to the affected artifacts itself.
 
 ##  OPTIONS
 
-`--auto`|`-a`:
+-   `--auto`|`-a`:
     Automatically pick the recommended refactoring approach without
     asking the user via the interactive dialog.
 
-`--dry`|`-d`:
+-   `--dry`|`-d`:
     Compose the plan *without* the `##  VERIFICATION` section. When
     `ase-task-implement` later applies such a plan, it strictly skips
     the entire verification phase (no build, tests, linter,
     type-checker, or program execution) once the source files have
     been modified.
 
-`--direct`|`-D`:
+-   `--direct`|`-D`:
     Apply the refactoring *immediately* and *in place*: skip the
     refactoring approaches, the interactive dialog, and the entire task
     plan ceremony, and directly apply the complete change set to the
@@ -51,14 +51,14 @@ entirely and applies the change set to the affected artifacts itself.
     `--next` have no effect, as neither approaches are proposed nor a
     plan is composed.
 
-`--quick`|`-Q`:
+-   `--quick`|`-Q`:
     Shorthand alias for `-a -d -n IMPLEMENT,DELETE`: automatically pick
     the recommended refactoring approach, compose the plan *without* the
     `##  VERIFICATION` section, immediately hand off to `ase-task-implement`,
     and finally `ase-task-delete` the now-consumed plan. This gives a
     single, fast *one-shot* refactoring mode.
 
-`--next`|`-n` *option*[,...]:
+-   `--next`|`-n` *option*[,...]:
     Automatically choose the next step after composing the plan.
     *option* is a single token or a *comma-separated chronological
     list* of tokens; an `IMPLEMENT`, `PREFLIGHT`, or `GRILL` head token
@@ -77,7 +77,7 @@ entirely and applies the change set to the affected artifacts itself.
 
 ##  ARGUMENTS
 
-[*task-id*:] *request*:
+-   [*task-id*:] *request*:
     Description of the refactoring *request*. Optionally prefixed
     with a *task-id* followed by a colon to bind the resulting plan
     to a specific task id.

package/plugin/skills/ase-code-resolve/help.md

@@ -36,18 +36,18 @@ entirely and applies the change set to the affected artifacts itself.
 
 ##  OPTIONS
 
-`--auto`|`-a`:
+-   `--auto`|`-a`:
     Automatically pick the recommended resolution approach without
     asking the user via the interactive dialog.
 
-`--dry`|`-d`:
+-   `--dry`|`-d`:
     Compose the plan *without* the `##  VERIFICATION` section. When
     `ase-task-implement` later applies such a plan, it strictly skips
     the entire verification phase (no build, tests, linter,
     type-checker, or program execution) once the source files have
     been modified.
 
-`--direct`|`-D`:
+-   `--direct`|`-D`:
     Resolve the problem *immediately* and *in place*: skip the
     resolution approaches, the interactive dialog, and the entire task
     plan ceremony, and directly apply the complete change set to the
@@ -56,14 +56,14 @@ entirely and applies the change set to the affected artifacts itself.
     `--next` have no effect, as neither approaches are proposed nor a
     plan is composed.
 
-`--quick`|`-Q`:
+-   `--quick`|`-Q`:
     Shorthand alias for `-a -d -n IMPLEMENT,DELETE`: automatically pick
     the recommended resolution approach, compose the plan *without* the
     `##  VERIFICATION` section, immediately hand off to `ase-task-implement`,
     and finally `ase-task-delete` the now-consumed plan. This gives a
     single, fast *one-shot* resolution mode.
 
-`--next`|`-n` *option*[,...]:
+-   `--next`|`-n` *option*[,...]:
     Automatically choose the next step after composing the plan.
     *option* is a single token or a *comma-separated chronological
     list* of tokens; an `IMPLEMENT`, `PREFLIGHT`, or `GRILL` head token
@@ -82,7 +82,7 @@ entirely and applies the change set to the affected artifacts itself.
 
 ##  ARGUMENTS
 
-[*task-id*:] *problem*:
+-   [*task-id*:] *problem*:
     Description of the *problem* to resolve, or a bare issue
     identifier like `P1` or `T1` previously produced by an analyzer
     skill. Optionally prefixed with a *task-id* followed by a colon

package/plugin/skills/ase-docs-distill/help.md

@@ -39,7 +39,7 @@ non-numeric value falls back to the default *5*.
 
 ##  OPTIONS
 
-`--top`|`-t` *N*:
+-   `--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
@@ -47,7 +47,7 @@ non-numeric value falls back to the default *5*.
 
 ##  ARGUMENTS
 
-*document-reference*:
+-   *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.

package/plugin/skills/ase-docs-proofread/SKILL.md

@@ -2,7 +2,7 @@
 name: ase-docs-proofread
 argument-hint: "[--help|-h] [--auto|-a] <docs-reference>"
 description: >
-    Analyze the documents for spelling, punctuation, or grammar errors.
+    Analyze the documents for spelling, capitalization, punctuation, word break, or grammar errors.
     Use when the user wants to "proofread" or "spellcheck" a document.
 user-invocable: true
 disable-model-invocation: false
@@ -15,7 +15,7 @@ effort: high
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
 <purpose name="ase-docs-proofread">
-Analyze documents for spelling, punctuation, or grammar errors
+Analyze documents for spelling, capitalization, punctuation, word break, or grammar errors
 </purpose>
 
 <expand name="getopt"
@@ -26,7 +26,7 @@ Analyze documents for spelling, punctuation, or grammar errors
 
 <objective>
 *Proofread* the documents of `<getopt-arguments/>` for problems in their
-*spelling*, *punctuation*, or *grammar* and propose corrections.
+*spelling*, *capitalization*, *punctuation*, *word break*, or *grammar* and propose corrections.
 </objective>
 
 <flow>
@@ -100,19 +100,23 @@ Analyze documents for spelling, punctuation, or grammar errors
     <template>
     <ase-tpl-bullet-secondary/> **PROOFREADING SUMMARY**:
 
-    | *Proofread Type* | *Proofread Result*      |
-    | ---------------- | ----------------------- |
-    | **SPELLING**:    | **<n/>** problems found |
-    | **PUNCTUATION**: | **<m/>** problems found |
-    | **GRAMMAR**:     | **<k/>** problems found |
+    | *Proofread Type*    | *Proofread Result*      |
+    | ------------------- | ----------------------- |
+    | **SPELLING**:       | **<n/>** problems found |
+    | **CAPITALIZATION**: | **<c/>** problems found |
+    | **PUNCTUATION**:    | **<m/>** problems found |
+    | **WORD-BREAK**:     | **<w/>** problems found |
+    | **GRAMMAR**:        | **<k/>** problems found |
 
     </template>
 
     Hints:
 
-    -   <n/> is the number of problems with `type` equal to `SPELLING`    in <problems/>
-    -   <m/> is the number of problems with `type` equal to `PUNCTUATION` in <problems/>
-    -   <k/> is the number of problems with `type` equal to `GRAMMAR`     in <problems/>
+    -   <n/> is the number of problems with `type` equal to `SPELLING`       in <problems/>
+    -   <c/> is the number of problems with `type` equal to `CAPITALIZATION` in <problems/>
+    -   <m/> is the number of problems with `type` equal to `PUNCTUATION`    in <problems/>
+    -   <w/> is the number of problems with `type` equal to `WORD-BREAK`     in <problems/>
+    -   <k/> is the number of problems with `type` equal to `GRAMMAR`        in <problems/>
 
     </step>
 
@@ -238,7 +242,7 @@ Analyze documents for spelling, punctuation, or grammar errors
 
             Set <old-start/> to the 1-based line number of the *first*
             old-side hunk line: if <context-before/> is non-empty, that is
-            the line of its *first* context line, i.e. <line/> minus the
+            the line of its *first* context line, i.e., <line/> minus the
             number of lines in <context-before/>; otherwise it is <line/> itself
             (the first line of <old-text/>). For a hunk that *only inserts*
             new lines (empty <old-text/> *and* empty context), set it to the

package/plugin/skills/ase-docs-proofread/help.md

@@ -13,10 +13,10 @@
 ##  DESCRIPTION
 
 The `ase-docs-proofread` skill analyzes the referenced documents for
-*spelling*, *punctuation*, and *grammar* errors and proposes
-corrections. The investigation is dispatched to a sub-agent
-(`ase:ase-docs-proofread`) so that scanning details do not leak into
-the user-visible transcript.
+*spelling*, *capitalization*, *punctuation*, *word break*, and *grammar*
+errors and proposes corrections. The investigation is dispatched to a
+sub-agent (`ase:ase-docs-proofread`) so that scanning details do not
+leak into the user-visible transcript.
 
 For each detected problem, the skill renders a unified-diff
 *CORRECTION* preview and either asks the user to `ACCEPT` or `REJECT`
@@ -24,21 +24,31 @@ the proposed correction interactively (or refine it via a free-text
 hint, which re-proposes the correction without limit) or - with
 `--auto` - applies all corrections automatically.
 
+`ase-docs-proofread` is the correctness-fixing member of the document
+triple. The recommended order over one document is
+[`ase-docs-shorten`](../ase-docs-shorten/help.md) first (cut the bulk),
+then [`ase-docs-refine`](../ase-docs-refine/help.md) (polish what
+survives), then `ase-docs-proofread` (final correctness pass), so no
+correction effort is spent on text which is later dropped.
+
 ##  OPTIONS
 
-`--auto`|`-a`:
+-   `--auto`|`-a`:
     Automatically apply every proposed correction without asking the
     user via the interactive dialog.
 
 ##  ARGUMENTS
 
-*docs-reference*:
+-   *docs-reference*:
     A file, directory, or other reference to the documents to
     proofread.
 
 ##  SCENARIOS
 
--   You want documents checked for spelling, punctuation, and grammar
+-   You want documents checked for spelling, capitalization,
+    punctuation, word break, and grammar
+-   You want inconsistent capitalization of terms and headings unified
+-   You want wrong word breaks like "data base" or "check-list" repaired
 -   You want corrections proposed which you accept or reject one by one
 -   You want a whole documentation directory corrected automatically
 -   You want a final language pass over a text before publishing
@@ -59,4 +69,4 @@ Proofread an entire documentation directory automatically:
 
 ##  SEE ALSO
 
-[`ase-code-lint`](../ase-code-lint/help.md), [`ase-meta-changelog`](../ase-meta-changelog/help.md).
+[`ase-docs-shorten`](../ase-docs-shorten/help.md), [`ase-docs-refine`](../ase-docs-refine/help.md), [`ase-docs-distill`](../ase-docs-distill/help.md), [`ase-code-lint`](../ase-code-lint/help.md), [`ase-meta-changelog`](../ase-meta-changelog/help.md).