@rse/ase 0.9.62 → 0.9.64

package/plugin/skills/ase-help-skill/help.md

@@ -46,6 +46,13 @@ The skill exposes *no* option flags beyond `--help`/`-h`.
     description of its purpose. If omitted, the entire skill catalog is
     listed.
 
+##  SCENARIOS
+
+-   You want the manual page of an ASE skill
+-   You want to know what a certain `ase-xxx-xxx` skill does
+-   You want a skill found by an abbreviation or a purpose description
+-   You want to browse the whole catalog of ASE skills
+
 ##  EXAMPLES
 
 Show the manual page of `ase-code-lint` via its shortest abbreviation:

package/plugin/skills/ase-meta-brainstorm/help.md

@@ -61,6 +61,14 @@ the highest-ranked option or a principled synthesis of the shortlist.
     The subject to brainstorm - a feature, component, behavior, or
     design question to explore *what* to build before *how*.
 
+##  SCENARIOS
+
+-   You want to get fresh ideas for an open-ended question
+-   You want to explore what to build before deciding how to build it
+-   You want to widen a solution space that holds a single candidate
+-   You want to get a shortlist of distinct directions with a recommendation
+-   You want to ideate on a feature, component, or design question
+
 ##  EXAMPLES
 
 Brainstorm an approach for a new feature:

package/plugin/skills/ase-meta-changelog/help.md

@@ -23,6 +23,12 @@ comma-separated *artifact class* tags out of `spec`, `arch`, `code`,
 prefix. The date in the section header is also updated to the current
 date.
 
+##  SCENARIOS
+
+-   You want the `CHANGELOG.md` brought up to date with recent commits
+-   You want changelog entries completed, consolidated, and sorted
+-   You want a tidy changelog section before a release
+
 ##  EXAMPLES
 
 Update the most recent ChangeLog section:

package/plugin/skills/ase-meta-chat/help.md

@@ -26,6 +26,12 @@ without any further interpretation.
 *query*:
     The chat message to send to the foreign LLM.
 
+##  SCENARIOS
+
+-   You want a single question answered by one specific foreign LLM
+-   You want an answer from ChatGPT, Gemini, DeepSeek, Grok, GLM, or Qwen
+-   You want a second opinion from exactly one other model, verbatim
+
 ##  EXAMPLES
 
 Ask ChatGPT a quick question:

package/plugin/skills/ase-meta-commit/help.md

@@ -18,6 +18,12 @@ the form `<type>: <summary>` where *type* is one of `FEATURE`,
 *summary* is a 60-80 character imperative-mood summary without
 trailing period or Markdown formatting.
 
+##  SCENARIOS
+
+-   You want a commit message for the currently staged changes
+-   You want a typed one-line summary derived from the staged diff
+-   You want to commit but cannot phrase what changed
+
 ##  EXAMPLES
 
 Craft a commit message for the currently staged changes:

package/plugin/skills/ase-meta-compat/help.md

@@ -54,6 +54,12 @@ The `ase-meta-compat` skill takes no arguments (besides `--help`|`-h`). It
 always runs the most rigorous self-test, with 6 *probes per category*
 (7 for *Regex Matching*), for 25 probes in total.
 
+##  SCENARIOS
+
+-   You want to know how faithfully the current model runs ASE skills
+-   You want a 0-100% compatibility rating of the LLM and its harness
+-   You want the core interpreter primitives checked before relying on ASE
+
 ##  EXAMPLES
 
 Run the compatibility self-test:

package/plugin/skills/ase-meta-config/help.md

@@ -94,6 +94,13 @@ preset-bootstrapping operation that stays a shell concern next to
     The operands of the operation: none for `list`, a dotted *key* for
     `get` and `delete`, and a dotted *key* plus a *value* for `set`.
 
+##  SCENARIOS
+
+-   You want the ASE configuration inspected or changed
+-   You want the persona, guidance, or boxing switched for a session
+-   You want a configuration value persisted at user or project scope
+-   You want to see which scope supplies each effective value
+
 ##  EXAMPLES
 
 List all effective configuration entries:

package/plugin/skills/ase-meta-diaboli/help.md

@@ -51,6 +51,13 @@ contrarian.
     It may be technical, factual, or opinion-based; the skill attacks
     its strongest ("steelman") interpretation.
 
+##  SCENARIOS
+
+-   You want a thesis relentlessly challenged with counter-arguments
+-   You want a decision stress-tested before you commit to it
+-   You want the strongest anti-theses ranked plus a synthesis
+-   You want a devil's advocate against a claim or plan
+
 ##  EXAMPLES
 
 Challenge a technology-choice claim:

package/plugin/skills/ase-meta-diff/help.md

@@ -73,6 +73,13 @@ giving a visual sense of *what a diff endangers* before a deeper review.
     *reverse dependencies* - plus a *brief impact summary* of what
     depends on the touched code and how far the blast reaches.
 
+##  SCENARIOS
+
+-   You want a readable, intent-grouped summary of the staged changes
+-   You want a diff checked for scope creep and stray debug leftovers
+-   You want a graded risk report of a change before committing
+-   You want a blast-radius map of what depends on the touched code
+
 ##  EXAMPLES
 
 Summarize the currently staged changes:

package/plugin/skills/ase-meta-eli5/help.md

@@ -42,6 +42,12 @@ knowledge.
     phenomenon, or any other subject; the skill explains it in a
     child-friendly way.
 
+##  SCENARIOS
+
+-   You want a topic explained so simply a child could follow
+-   You want a jargon-free summary with an everyday analogy
+-   You want a simple explanation grounded in current Internet/Web facts
+
 ##  EXAMPLES
 
 Explain a technical concept from model knowledge:

package/plugin/skills/ase-meta-evaluate/help.md

@@ -31,6 +31,13 @@ all alternatives rate negatively.
     A description of what should be evaluated, including the
     alternatives and, optionally, the criteria to consider.
 
+##  SCENARIOS
+
+-   You want alternatives compared and the best one named
+-   You want a weighted multi-criteria decision matrix
+-   You want a defensible, criteria-based technology choice
+-   You want to know which option out of a list wins and by how much
+
 ##  EXAMPLES
 
 Compare logging libraries for a TypeScript project:

package/plugin/skills/ase-meta-proximity/help.md

@@ -59,6 +59,13 @@ the `ase-meta-proximity` sub-agent before its proximity is re-determined.
     a technical concept, a phenomenon, or any other subject; the skill
     determines its parent, sibling, and child topics.
 
+##  SCENARIOS
+
+-   You want the conceptual neighborhood of a topic explored
+-   You want the parent, sibling, and child topics of a subject
+-   You want a topic taxonomy navigated interactively
+-   You want related topics grounded in Internet/Web facts
+
 ##  EXAMPLES
 
 Determine the proximity of a topic from model knowledge:

package/plugin/skills/ase-meta-quorum/help.md

@@ -40,6 +40,12 @@ complete, unmodified individual responses.
 *question*:
     The question to ask all available AIs.
 
+##  SCENARIOS
+
+-   You want a consensus answer from multiple AIs
+-   You want to know whether different models agree on a question
+-   You want the individual responses plus a consensus rate
+
 ##  EXAMPLES
 
 Ask the quorum a factual question:

package/plugin/skills/ase-meta-quotes/help.md

@@ -90,6 +90,13 @@ the attribution of the quote.
     search query and as the keyword set of the *literalness* dimension of
     the matrix.
 
+##  SCENARIOS
+
+-   You want quotes, sayings, or aphorisms on a topic
+-   You want citations arranged by attribution and literalness
+-   You want quote wording and attribution verified against the Web
+-   You want the quote harvest widened to related topics
+
 ##  EXAMPLES
 
 Find quotes from model knowledge:

package/plugin/skills/ase-meta-review/help.md

@@ -27,7 +27,7 @@ naming, abstraction level), **clarity** (readability and
 self-documentation for a future reader), **robustness** (error handling,
 resource and concurrency safety), **security** and **performance** (risks
 introduced by the change), **convention** (conformance to the
-project's documented conventions - code style and the plan/spec/arch
+project's documented conventions - code style and the plan/spec
 formats described in `AGENTS.md` and the `ase-format-*` meta documents),
 **testing** (inadequate coverage for the change - new or fixed behavior
 left untested, adjacent tests not updated, or existing tests silently
@@ -69,6 +69,13 @@ before it is committed.
 The `ase-meta-review` skill takes no positional arguments; it always
 reviews the currently *staged* Git changes.
 
+##  SCENARIOS
+
+-   You want the staged changes reviewed like a human reviewer would
+-   You want an approve or reject verdict before committing
+-   You want severity-tagged, line-cited findings on a diff
+-   You want a holistic judgment instead of a mechanical lint
+
 ##  EXAMPLES
 
 Review the currently staged changes before committing:

package/plugin/skills/ase-meta-search/help.md

@@ -34,6 +34,12 @@ Brave, or `WebSearch` individually.
 *query*:
     The search query to dispatch to the search services.
 
+##  SCENARIOS
+
+-   You want the Internet/Web searched for a query
+-   You want results from several search backends consolidated
+-   You want current facts which model knowledge may lack
+
 ##  EXAMPLES
 
 Search the Web for a topic across all backends:

package/plugin/skills/ase-meta-steelman/help.md

@@ -68,6 +68,12 @@ cheerleading.
     It may be technical, factual, or opinion-based; the skill defends
     its strongest ("steelman") interpretation.
 
+##  SCENARIOS
+
+-   You want the strongest possible case built for a thesis
+-   You want supporting arguments ranked plus a fortification
+-   You want a charitable defense before pitching a decision
+
 ##  EXAMPLES
 
 Strengthen a technology-choice claim:

package/plugin/skills/ase-meta-why/help.md

@@ -56,6 +56,13 @@ source code changes.
     whose root cause should be investigated. The skill implicitly
     prepends "Why" to form the initial question.
 
+##  SCENARIOS
+
+-   You want the root cause of a problem, not just its symptom
+-   You want a Five-Whys causality chain walked for an observed fact
+-   You want candidate causes weighed with backtracking
+-   You want a solution proposed which addresses the root cause
+
 ##  EXAMPLES
 
 Investigate the root cause of a build failure:

package/plugin/skills/ase-meta-workflow/help.md

@@ -96,6 +96,13 @@ agent tool:
     dispatched "in a sub-agent", or naming concrete `ase-xxx-xxx` skills
     steers the derived structure accordingly.
 
+##  SCENARIOS
+
+-   You want a recurring multi-step procedure automated as its own skill
+-   You want several ASE skills orchestrated or chained into one command
+-   You want sequential and parallel actions woven into a generated skill
+-   You want a new agent tool skill generated in the style of ASE skills
+
 ##  EXAMPLES
 
 Generate a project-local skill which analyzes the code and then resolves