@rse/ase 0.0.55 → 0.0.57

package/plugin/skills/ase-meta-changes/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ase-meta-changes
-argument-hint: ""
+argument-hint: "[--help|-h]"
 description: >
     Update changes entries in CHANGELOG.md files
 user-invocable: true
@@ -17,18 +17,10 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-control.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 
-Update ChangeLog Entries
-========================
-
 <skill name="ase-meta-changes">
 Update ChangeLog Entries
 </skill>
 
-<role>
-Your role is an experienced, *expert-level software developer*,
-specialized in *Git version control*.
-</role>
-
 <objective>
 Help to complete, consolidate and sort *ChangeLog* entries of the most
 recent *ChangeLog* section, based on underlying *Git* commits and staged

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

@@ -0,0 +1,33 @@
+
+##  NAME
+
+`ase-meta-changes` - Update ChangeLog Entries
+
+##  SYNOPSIS
+
+`ase-meta-changes`
+    [`--help`|`-h`]
+
+##  DESCRIPTION
+
+The `ase-meta-changes` skill helps to *complete*, *consolidate*, and
+*sort* the entries of the most recent section of a `CHANGELOG.md`
+file, based on the underlying *Git* commits and the currently staged
+changes in the Git *index*.
+
+Each entry is formatted as `<prefix>: <summary>` where *prefix* is
+one of `FEATURE`, `IMPROVEMENT`, `BUGFIX`, `UPDATE`, `CLEANUP`, or
+`REFACTOR`. Entries are grouped and sorted by this prefix. The
+date in the section header is also updated to the current date.
+
+##  EXAMPLES
+
+Update the most recent ChangeLog section:
+
+```text
+❯ /ase-meta-changes
+```
+
+##  SEE ALSO
+
+`ase-meta-commit`, `ase-docs-proofread`.

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

@@ -1,6 +1,6 @@
 ---
 name: ase-meta-chat
-argument-hint: "<llm> <query>"
+argument-hint: "[--help|-h] <llm> <query>"
 description: >
     Query foreign LLM for chat.
     Use this skill if a foreign LLM like OpenAI ChatGPT, Google Gemini,
@@ -15,17 +15,10 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-control.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 
-Query Foreign LLM for Chat
-==========================
-
 <skill name="ase-meta-chat">
 Query Foreign LLM for Chat
 </skill>
 
-<role>
-Your role is to act as a proxy to query a foreign LLM for a single chat message.
-</role>
-
 <objective>
 Query foreign LLM for: <query>$ARGUMENTS</query>
 </objective>

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

@@ -0,0 +1,45 @@
+
+##  NAME
+
+`ase-meta-chat` - Query Foreign LLM for Chat
+
+##  SYNOPSIS
+
+`ase-meta-chat`
+    [`--help`|`-h`]
+    *llm* *query*
+
+##  DESCRIPTION
+
+The `ase-meta-chat` skill queries a *foreign LLM* (such as OpenAI
+ChatGPT, Google Gemini, DeepSeek, xAI Grok, Z.AI GLM, or Alibaba
+Qwen) with a single chat message. The underlying `ase:ase-meta-chat`
+sub-agent is invoked and its plain response is shown back verbatim
+without any further interpretation.
+
+##  ARGUMENTS
+
+*llm*:
+    Identifier of the foreign LLM to query, e.g. `chatgpt`,
+    `gemini`, `deepseek`, `grok`, `glm`, or `qwen`.
+
+*query*:
+    The chat message to send to the foreign LLM.
+
+##  EXAMPLES
+
+Ask ChatGPT a quick question:
+
+```text
+❯ /ase-meta-chat chatgpt What is the best way to handle UTF-8 BOMs in JSON?
+```
+
+Ask Gemini for a brief comparison:
+
+```text
+❯ /ase-meta-chat gemini Compare gRPC and REST in one paragraph.
+```
+
+##  SEE ALSO
+
+`ase-meta-quorum`, `ase-meta-search`.

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

@@ -1,5 +1,6 @@
 ---
 name: ase-meta-commit
+argument-hint: "[--help|-h]"
 description: >
     Determine commit message for staged Git changes.
 user-invocable: true
@@ -12,18 +13,10 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-control.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 
-Git Commit
-==========
-
 <skill name="ase-meta-commit">
 Git Commit
 </skill>
 
-<role>
-Your role is an experienced, *expert-level software developer*,
-specialized in *Git commit messages*.
-</role>
-
 <objective>
 Help to *craft* a *concise commit message* for the
 currently staged Git changes.

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

@@ -0,0 +1,31 @@
+
+##  NAME
+
+`ase-meta-commit` - Git Commit Message
+
+##  SYNOPSIS
+
+`ase-meta-commit`
+    [`--help`|`-h`]
+
+##  DESCRIPTION
+
+The `ase-meta-commit` skill helps to *craft* a *concise commit
+message* for the currently staged Git changes. It inspects the
+output of `git diff --cached` and produces a single-line message of
+the form `<type>: <summary>` where *type* is one of `FEATURE`,
+`IMPROVEMENT`, `BUGFIX`, `UPDATE`, `CLEANUP`, or `REFACTOR`, and
+*summary* is a 60-80 character imperative-mood summary without
+trailing period or Markdown formatting.
+
+##  EXAMPLES
+
+Craft a commit message for the currently staged changes:
+
+```text
+❯ /ase-meta-commit
+```
+
+##  SEE ALSO
+
+`ase-meta-changes`.

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

@@ -1,6 +1,6 @@
 ---
 name: ase-meta-evaluate
-argument-hint: "<request>"
+argument-hint: "[--help|-h] <request>"
 description: >
     Evaluate alternatives through a weighted multi-criteria decision
     matrix. Use when the user calls for the *evaluation* of
@@ -14,18 +14,10 @@ effort: high
 @${CLAUDE_SKILL_DIR}/../../meta/ase-control.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 
-Evaluate Alternatives
-=====================
-
 <skill name="ase-meta-evaluate">
 Evaluate Alternatives
 </skill>
 
-<role>
-Your role is an experienced, *expert-level assistant*,
-specialized in *evaluating alternatives*.
-</role>
-
 <objective>
 *Evaluate* *alternatives* through a weighted
 multi-*criteria* decision matrix.
@@ -154,8 +146,8 @@ multi-*criteria* decision matrix.
 
     -   Then, calculate the ratings <rating-K/> (K=1-N) for all
         alternatives in a single call by invoking the `ase_decision_matrix(matrix:
-        [ [ <weight-1/>, <eval-1-1/>, ..., <eval-1-N/> ], ..., [ <weight-M/>,
-        <eval-M-1/>, ..., <eval-M-N/> ] ])` tool of the `ase` MCP server.
+        [ [ <weight-1/>, <eval-1-1/>, ..., <eval-N-1/> ], ..., [ <weight-M/>,
+        <eval-1-M/>, ..., <eval-N-M/> ] ])` tool of the `ase` MCP server.
         The tool returns an array of N numerical values, where the K-th
         entry is the product-sum of all weights <weight-L/> (L=1-M) and
         the evaluation <eval-K-L/> (L=1-M) for alternative <alternative-K/>.
@@ -173,9 +165,9 @@ multi-*criteria* decision matrix.
 
         | ⦿ *Criteria*  | ⚖ *Weight*  | ⚑ **<alternative-1/>** | [...alternatives 2-(N-1)...] | ⚑ **<alternative-N/>** |
         | :------------ | ----------: | ---------------------: | ---------------------------: | ---------------------: |
-        | <criteria-1/> | <weight-1/> | <eval-1-1/>            | [...evals 1-2..1-(N-1)...]   | <eval-1-N/>            |
+        | <criteria-1/> | <weight-1/> | <eval-1-1/>            | [...evals 2-1..(N-1)-1...]   | <eval-N-1/>            |
         [...criteria L=2-(M-1) for M>2...]
-        | <criteria-M/> | <weight-M/> | <eval-M-1/>            | [...evals M-2..M-(N-1)...]   | <eval-M-N/>            |
+        | <criteria-M/> | <weight-M/> | <eval-1-M/>            | [...evals 2-M..(N-1)-M...]   | <eval-N-M/>            |
         | **RATING**    |             | **<rating-1/>**        | [...ratings 2-(N-1)...]      | **<rating-N/>**        |
         </template>
     </step>

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

@@ -0,0 +1,52 @@
+
+##  NAME
+
+`ase-meta-evaluate` - Evaluate Alternatives
+
+##  SYNOPSIS
+
+`ase-meta-evaluate`
+    [`--help`|`-h`]
+    *request*
+
+##  DESCRIPTION
+
+The `ase-meta-evaluate` skill evaluates two or more *alternatives*
+through a *weighted multi-criteria decision matrix*. From the
+*request*, the skill derives the reason for the evaluation, the
+alternatives, and the criteria, fills in additional criteria up to a
+range of 8-12 (using `ase-meta-search` where helpful), assigns weights
+from `{ 4.00, 2.00, 1.00, 0.50, 0.25 }`, evaluates each alternative
+against each criterion on a `{ -2, -1, 0, +1, +2 }` Likert scale, and
+computes the final ratings via the `ase_decision_matrix` MCP tool.
+
+The result is reported as a Markdown decision matrix along with the
+single *BEST ALTERNATIVE*, including a warning if multiple
+alternatives tie, if the distance to the second best is small, or if
+all alternatives rate negatively.
+
+##  ARGUMENTS
+
+*request*:
+    A description of what should be evaluated, including the
+    alternatives and, optionally, the criteria to consider.
+
+##  EXAMPLES
+
+Compare logging libraries for a TypeScript project:
+
+```text
+❯ /ase-meta-evaluate Compare pino, winston, and bunyan as logging libraries.
+```
+
+Evaluate database options with hinted criteria:
+
+```text
+❯ /ase-meta-evaluate Compare PostgreSQL, MySQL, and SQLite for an
+  embedded use case; criteria include footprint and write throughput.
+```
+
+##  SEE ALSO
+
+`ase-meta-quorum`, `ase-meta-search`, `ase-arch-discover`,
+`ase-meta-why`.

package/plugin/skills/ase-meta-persona/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ase-meta-persona
-argument-hint: "[<persona>]"
+argument-hint: "[--help|-h] [<persona>]"
 description: >
     Adjust communication style in four intensity levels of token usage.
     The <persona> can be either the decorative, eloquent, and explaining "writer",
@@ -16,15 +16,21 @@ effort: medium
 @${CLAUDE_SKILL_DIR}/../../meta/ase-control.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 
+<skill name="ase-meta-persona">
 Persona Configuration
-=====================
+</skill>
+
+<objective>
+*Configure* the *persona style* of the agent to adjust the communication
+style and token usage intensity.
+</objective>
 
 1.  Determine request:
     <request>$ARGUMENTS</request>
     Do not output anything.
 
 2.  <if condition="<request/> is empty">
-    1.  Call the `ase_persona(session: <ase-session-id/>)`
+    1.  Call the `ase_persona(session: "<ase-session-id/>")`
         tool from the `ase` MCP server and set
         <ase-persona-style/> to its `text` output.
         Do not output anything.
@@ -46,8 +52,8 @@ Persona Configuration
         </template>
 
     2.  Set <ase-persona-style><request/></ase-persona-style> and
-        call the `ase_persona(style: <ase-persona-style/>, session:
-        <ase-session-id/>)` tool from the `ase` MCP server. Do not
+        call the `ase_persona(style: "<ase-persona-style/>", session:
+        "<ase-session-id/>")` tool from the `ase` MCP server. Do not
         output anything.
 
     3.  Output the following <template/>:

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

@@ -0,0 +1,50 @@
+
+##  NAME
+
+`ase-meta-persona` - Persona Configuration
+
+##  SYNOPSIS
+
+`ase-meta-persona`
+    [`--help`|`-h`]
+    [*persona*]
+
+##  DESCRIPTION
+
+The `ase-meta-persona` skill gets or sets the active *communication
+style* (persona) of the assistant. Four intensity levels of token
+usage are supported, from most verbose to most terse:
+
+-   `writer`: decorative, eloquent, and explaining
+-   `engineer`: concise, factual, and accurate (default)
+-   `telegrapher`: brief, factual, and abbreviating
+-   `caveman`: terse, rough, and stuttering
+
+Without arguments, the skill reports the currently active persona.
+With a *persona* argument, it switches to that persona via the
+`ase_persona` MCP tool.
+
+##  ARGUMENTS
+
+*persona*:
+    The persona to activate; one of `writer`, `engineer`,
+    `telegrapher`, or `caveman`. If omitted, the currently active
+    persona is reported.
+
+##  EXAMPLES
+
+Show the currently active persona:
+
+```text
+❯ /ase-meta-persona
+```
+
+Switch to the telegrapher persona:
+
+```text
+❯ /ase-meta-persona telegrapher
+```
+
+##  SEE ALSO
+
+`ase-task-id`.

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

@@ -1,6 +1,6 @@
 ---
 name: ase-meta-quorum
-argument-hint: "<question>"
+argument-hint: "[--help|-h] <question>"
 description: >
     Query Multiple AIs for Quorum Answer.
 user-invocable: true
@@ -14,17 +14,10 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-control.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 
-Query Multiple AIs for Quorum Answer
-====================================
-
 <skill name="ase-meta-quorum">
 Query Multiple AIs for Quorum Answer
 </skill>
 
-<role>
-Your role is an *expert-level assistant*.
-</role>
-
 <objective>
 Find a *quorum answer* on an arbitrary question,
 by querying *multiple* AIs for an *optimal consensus*.

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

@@ -0,0 +1,41 @@
+
+##  NAME
+
+`ase-meta-quorum` - Query Multiple AIs for Quorum Answer
+
+##  SYNOPSIS
+
+`ase-meta-quorum`
+    [`--help`|`-h`]
+    *question*
+
+##  DESCRIPTION
+
+The `ase-meta-quorum` skill finds a *quorum answer* on an arbitrary
+question by querying *multiple* AIs (Anthropic Claude itself plus
+OpenAI ChatGPT, Google Gemini, DeepSeek, xAI Grok, Z.AI GLM, and
+Alibaba Qwen) for an *optimal consensus*.
+
+The skill first previews its own answer, then dispatches the same
+query to each available foreign LLM via the `ase:ase-meta-chat`
+sub-agent, summarizes all responses, derives a *consensus rate* on
+a Likert scale of `0..N` (where `N` is the number of available
+responders), and reports the consensus answer alongside the
+complete, unmodified individual responses.
+
+##  ARGUMENTS
+
+*question*:
+    The question to ask all available AIs.
+
+##  EXAMPLES
+
+Ask the quorum a factual question:
+
+```text
+❯ /ase-meta-quorum What are the most common causes of memory leaks in Node.js?
+```
+
+##  SEE ALSO
+
+`ase-meta-chat`, `ase-meta-search`, `ase-meta-evaluate`.

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

@@ -1,6 +1,6 @@
 ---
 name: ase-meta-search
-argument-hint: "<query>"
+argument-hint: "[--help|-h] <query>"
 description: >
     Search the Internet/Web with a query.
     Prefer this skill before using Perplexity, Brave and WebSearch.
@@ -18,17 +18,10 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-control.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 
-Search the Internet/Web
-=======================
-
 <skill name="ase-meta-search">
 Search the Internet/Web
 </skill>
 
-<role>
-Your role is an expert-level *web specialist*.
-</role>
-
 <objective>
 Your objective is to *search* the *Internet*/*Web* for the following query:
 <query>$ARGUMENTS</query>

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

@@ -0,0 +1,39 @@
+
+##  NAME
+
+`ase-meta-search` - Search the Internet/Web
+
+##  SYNOPSIS
+
+`ase-meta-search`
+    [`--help`|`-h`]
+    *query*
+
+##  DESCRIPTION
+
+The `ase-meta-search` skill searches the *Internet*/*Web* for the
+given *query*. It dispatches the query in parallel to all available
+search services (Perplexity, Brave, Exa, and Claude's built-in
+`WebSearch`) via the `ase:ase-meta-search` sub-agent and consolidates
+all responses into a single answer without removing original
+information.
+
+This skill should be preferred over directly invoking Perplexity,
+Brave, or `WebSearch` individually.
+
+##  ARGUMENTS
+
+*query*:
+    The search query to dispatch to the search services.
+
+##  EXAMPLES
+
+Search the Web for a topic:
+
+```text
+❯ /ase-meta-search latest stable release of TypeScript and release notes
+```
+
+##  SEE ALSO
+
+`ase-meta-chat`, `ase-meta-quorum`, `ase-arch-discover`.

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

@@ -1,6 +1,6 @@
 ---
 name: ase-meta-why
-argument-hint: "<fact>"
+argument-hint: "[--help|-h] <fact>"
 description: >
     Five-Whys Root-Cause Analysis.
 user-invocable: true
@@ -11,17 +11,10 @@ effort: medium
 @${CLAUDE_SKILL_DIR}/../../meta/ase-control.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 
-Five-Whys Root-Cause Analysis
-=============================
-
 <skill name="ase-meta-why">
 Five-Whys Root-Cause Analysis
 </skill>
 
-<role>
-Your role is an *expert-level assistant*.
-</role>
-
 <objective>
 Apply the *Five-Whys* *root-cause analysis* technique to investigate
 the following problem:

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

@@ -0,0 +1,39 @@
+
+##  NAME
+
+`ase-meta-why` - Five-Whys Root-Cause Analysis
+
+##  SYNOPSIS
+
+`ase-meta-why`
+    [`--help`|`-h`]
+    *fact*
+
+##  DESCRIPTION
+
+The `ase-meta-why` skill applies the *Five-Whys* *root-cause
+analysis* technique to the supplied *fact*. The skill iteratively
+asks "why" — up to five times — to drill down from surface symptoms
+to the underlying root cause, considering technical, domain-specific,
+process-related, and organizational causes. After identifying the
+root cause it proposes a *SOLUTION* that addresses it, optionally
+including concrete source code changes.
+
+##  ARGUMENTS
+
+*fact*:
+    The observed *fact* (symptom, problem, or surprising outcome)
+    whose root cause should be investigated. The skill implicitly
+    prepends "Why" to form the initial question.
+
+##  EXAMPLES
+
+Investigate the root cause of a build failure:
+
+```text
+❯ /ase-meta-why the CI build is intermittently failing on macOS runners
+```
+
+##  SEE ALSO
+
+`ase-code-analyze`, `ase-code-resolve`, `ase-arch-analyze`.

package/plugin/skills/ase-task-delete/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ase-task-delete
-argument-hint: "[<id>]"
+argument-hint: "[--help|-h] [<id>]"
 description: >
     Delete the current or given task plan.
     Use when the user calls to "delete", "remove" or "clear" the
@@ -13,17 +13,13 @@ effort: low
 @${CLAUDE_SKILL_DIR}/../../meta/ase-control.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 
-Delete a Task Plan
-==================
-
 <skill name="ase-task-delete">
 Delete a Task Plan
 </skill>
 
-<role>
-Your role is an experienced, *expert-level assistant*.
-</role>
+<objective>
 *Delete* the task plan.
+</objective>
 
 Procedure
 ---------
@@ -36,7 +32,8 @@ explicitly requested by this procedure via outputs based on a <template/>!
 
 1.  **Determine Task:**
 
-    1.  Set <id>$ARGUMENTS</id> initially.
+    1.  Set <id>$ARGUMENTS</id> initially, with any leading and trailing
+        whitespace stripped.
         Inherit the always existing <ase-task-id/> from the current context.
         Do not output anything.
 
@@ -45,9 +42,18 @@ explicitly requested by this procedure via outputs based on a <template/>!
         Do not output anything.
         </if>
 
+    3.  <if condition="<id/> does NOT match the regexp `^[a-zA-Z][a-zA-Z0-9_-]*$`">
+        Only output the following <template/> and then immediately
+        *STOP* processing the entire current skill:
+
+        <template>
+        ⧉ **ASE**: ☻ skill: **ase-task-delete**, ▶ ERROR: expected single `[<id>]` argument
+        </template>
+        </if>
+
 2.  **Perform Operation**:
 
-    1.  Call the `ase_task_delete(id: <id/>)` tool of the `ase` MCP
+    1.  Call the `ase_task_delete(id: "<id/>")` tool of the `ase` MCP
         server to delete the task plan content and set <text/> to the
         `text` output field of this `ase_task_delete` tool call. Do not
         output anything related to this MCP tool call.
@@ -68,7 +74,7 @@ explicitly requested by this procedure via outputs based on a <template/>!
 
     2.  <if condition="<id/> is equal <ase-task-id/> AND <ase-task-id/> is not equal 'default'">
         Set <ase-task-id>default</ase-task-id>. Call the `ase_task_id(id:
-        <ase-task-id/>, session: <ase-session-id/>)` tool from the `ase`
+        "<ase-task-id/>", session: "<ase-session-id/>")` tool from the `ase`
         MCP server to switch the task to the default task. Only output
         the following <template/>: