You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@magpie.apache.org by po...@apache.org on 2026/10/10 21:20:40 UTC

(magpie) branch main updated: perf(utilities): trim always-on routing metadata of the family's skills (#1590)

This is an automated email from the ASF dual-hosted git repository.

potiuk pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/magpie.git


The following commit(s) were added to refs/heads/main by this push:
     new 5f0d5f47 perf(utilities): trim always-on routing metadata of the family's skills (#1590)
5f0d5f47 is described below

commit 5f0d5f477baf03a40b780c756d44444d36041f5c
Author: kuse <31...@qq.com>
AuthorDate: Sun Oct 11 05:20:35 2026 +0800

    perf(utilities): trim always-on routing metadata of the family's skills (#1590)
    
    * perf(utilities): trim always-on routing metadata of the family's skills
    
    * docs(setup): update the utilities always-on token count after the trim
    
    The routing-metadata trim brings magpie-utilities from ~0.5k to ~0.4k
    always-on tokens; check-doc-sync failed on the stale count.
    
    Generated-by: Claude Opus 5
    Claude-Session: https://claude.ai/code/session_01GTPsZ5aEE5bUVYqp47Dpvv
    
    ---------
    
    Co-authored-by: Jarek Potiuk <po...@apache.org>
---
 docs/setup/marketplace.md                          |  2 +-
 .../magpie-utilities/skills/list-skills/SKILL.md   | 42 +++++++++-------------
 .../skills/report-framework-issue/SKILL.md         | 34 ++++++++----------
 .../skills/skill-reconciler/SKILL.md               | 22 +++++-------
 4 files changed, 40 insertions(+), 60 deletions(-)

diff --git a/docs/setup/marketplace.md b/docs/setup/marketplace.md
index 9cab1bc4..a2f302df 100644
--- a/docs/setup/marketplace.md
+++ b/docs/setup/marketplace.md
@@ -163,7 +163,7 @@ can say so, because it is the floor everything else is managed from.
 | `magpie-pr-management` | 9 | ~1.0k |
 | `magpie-issue` | 8 | ~0.7k |
 | `magpie-repo-health` | 7 | ~0.6k |
-| `magpie-utilities` | 5 | ~0.5k |
+| `magpie-utilities` | 5 | ~0.4k |
 | `magpie-contributor-growth` | 9 | ~0.6k |
 | `magpie-mentoring` | 4 | ~0.4k |
 | `magpie-pairing` | 2 | ~0.2k |
diff --git a/plugins/magpie-utilities/skills/list-skills/SKILL.md b/plugins/magpie-utilities/skills/list-skills/SKILL.md
index 6370da7b..ee97e62c 100644
--- a/plugins/magpie-utilities/skills/list-skills/SKILL.md
+++ b/plugins/magpie-utilities/skills/list-skills/SKILL.md
@@ -6,30 +6,22 @@ family: utilities
 mode: Meta
 description: |
   Print a human-readable index of every skill installed for this
-  repository, grouped by the family each one declares, with the
-  name to invoke it by and the first sentence of its
-  `description`. Discovery is installation-aware: it covers a
-  pinned snapshot install, the framework checkout, and
-  marketplace plugin installs, so the index matches what the
-  agent can actually run. Generated on every run from live
-  `SKILL.md` frontmatter, so it never goes stale when skills are
-  added, removed, or rewritten.
+  repository, grouped by the family each one declares, with the name to
+  invoke it by and the first sentence of its `description`. Generated on
+  every run from live `SKILL.md` frontmatter, so it never goes stale.
 when_to_use: |
-  Invoke when a human asks *"what skills are available"*, *"list
-  the skills"*, *"show me the skills in this repo"*, *"give me a
-  table of contents for the skills"*, or invokes it under
-  whichever name their install method uses.
-  Skill names differ on this install:
-  `/magpie-utilities:list-skills` on a marketplace family-plugin
-  install, `/magpie-list-skills` on the pinned snapshot.
-  This is a help-style overview for humans onboarding to the
-  repository — agents route via the live frontmatter
-  `description` field directly and do not need this index to
-  choose a skill.
+  Invoke when a human asks *"what skills are available"*, *"list the
+  skills"*, *"show me the skills in this repo"*, or *"give me a table of
+  contents for the skills"*.
+  Invocation names differ per install: `/magpie-utilities:list-skills` on
+  a marketplace family-plugin install, `/magpie-list-skills` on the
+  pinned snapshot.
+  This is a help-style overview for humans — agents route via the live
+  frontmatter `description` field directly.
 capability: capability:stats
 surface_hash: sha256:5b9c9751b398f81b
 license: Apache-2.0
-measured_tokens: 2413
+measured_tokens: 2312
 ---
 
 <!-- SPDX-License-Identifier: Apache-2.0
@@ -97,12 +89,10 @@ is in. `/magpie-setup verify` is the full diagnostic.
 <!-- END MAGPIE PREFLIGHT -->
 
 Print a human-readable index of the skills installed for this
-repository. The index is generated on every run from live
-`SKILL.md` frontmatter — there is no cached copy to keep in sync.
-The skill exists for humans (newcomers reading the repo,
-maintainers checking what is available); agents route invocations
-via the same frontmatter the script reads, so this skill is
-purely informational.
+repository, generated on every run from live `SKILL.md` frontmatter —
+there is no cached copy to keep in sync. The skill exists for humans;
+agents route invocations via the same frontmatter the script reads, so
+this skill is purely informational.
 
 What counts as "installed" depends on how Magpie was put in
 place, so the script covers all three shapes and labels which one
diff --git a/plugins/magpie-utilities/skills/report-framework-issue/SKILL.md b/plugins/magpie-utilities/skills/report-framework-issue/SKILL.md
index 01a2e312..c20f2a20 100644
--- a/plugins/magpie-utilities/skills/report-framework-issue/SKILL.md
+++ b/plugins/magpie-utilities/skills/report-framework-issue/SKILL.md
@@ -5,31 +5,25 @@ name: report-framework-issue
 family: utilities
 mode: Meta
 description: |
-  Help an adopter or framework developer file a clean, redacted
-  GitHub issue against the Apache Magpie framework repo when a
-  skill, tool, or doc misbehaves. It gathers the problem from the
-  user — never from the raw session transcript — then runs a
-  mandatory public-disclosure scrub before rendering the report
-  into the framework's `bug_report` / `change_proposal` issue
-  template, checking for duplicates, and filing via
-  `gh issue create --web` only on explicit confirmation. The scrub
-  is the point: the destination is a public repo, so the skill
-  strips any private tracker, embargoed-CVE, private-list, or
-  cross-project content the report would otherwise leak.
+  File a clean, redacted GitHub issue against the Apache Magpie
+  framework repo when a skill, tool, or doc misbehaves. Gathers the
+  problem from the user — never the raw session transcript — runs a
+  mandatory public-disclosure scrub, renders the report into the
+  framework's issue template, and files via `gh issue create --web`
+  only on explicit confirmation.
 when_to_use: |
-  Invoke when the user says "report this to the framework", "file
-  a magpie bug", "the setup skill is broken — open an issue on
-  magpie", "this magpie tool crashed and I want to report it", or
-  "propose a change to the framework" — any variation on turning a
-  problem they hit *while using Magpie itself* into an issue on the
-  framework repo (`apache/magpie`). Skip when the problem is in the
-  adopter's own project: issues on their `<tracker>` or
-  `<upstream>` have their own skills, not this one.
+  Invoke when the user says "report this to the framework", "file a
+  magpie bug", "the setup skill is broken — open an issue on magpie",
+  or "propose a change to the framework" — turning a problem hit *while
+  using Magpie itself* into an issue on the framework repo
+  (`apache/magpie`). Skip when the problem is in the adopter's own
+  project: issues on their `<tracker>` or `<upstream>` have their own
+  skills, not this one.
 argument-hint: "[what broke, or a problem description]"
 capability: capability:platform
 surface_hash: sha256:f14640fa1249c172
 license: Apache-2.0
-measured_tokens: 4697
+measured_tokens: 4604
 ---
 
 <!-- SPDX-License-Identifier: Apache-2.0
diff --git a/plugins/magpie-utilities/skills/skill-reconciler/SKILL.md b/plugins/magpie-utilities/skills/skill-reconciler/SKILL.md
index 69076c82..1660d7eb 100644
--- a/plugins/magpie-utilities/skills/skill-reconciler/SKILL.md
+++ b/plugins/magpie-utilities/skills/skill-reconciler/SKILL.md
@@ -7,25 +7,21 @@ mode: Meta
 description: |
   Compare two near-duplicate skills — typically an ASF variant and a
   non-ASF or multi-project variant — and classify every difference as
-  ALLOWED, DRIFT, or SAFETY-BASELINE. Produces a structured diff and
-  a reconciliation proposal. Read-only: it never rewrites either skill;
-  convergence is a separate confirmed authoring step. A safety-baseline
-  divergence is always a must-fix, never silently merged into
-  allowed-divergence noise.
+  ALLOWED, DRIFT, or SAFETY-BASELINE. Produces a structured diff and a
+  reconciliation proposal; read-only, it never rewrites either skill.
 when_to_use: |
   Invoke when a maintainer says "reconcile <skill-A> and <skill-B>",
   "diff these two skill copies", "check if <skill-A> and <skill-B> have
-  drifted", "are these two skills in sync", "compare the ASF and non-ASF
-  variants", or "do these two copies agree on the safety baseline". Also a
-  natural companion to any cross-project adoption where the same skill
-  exists in both the framework and an adopter's override layer. Skip when
-  the user wants to actually merge or rewrite one of the copies — that is
-  write-skill or optimize-skill after the reconciler has surfaced the
-  proposal.
+  drifted", "compare the ASF and non-ASF variants", or "do these two
+  copies agree on the safety baseline". Also for cross-project adoption,
+  where the same skill exists in both the framework and an adopter's
+  override layer. Skip when the user wants to merge or rewrite a copy —
+  that is write-skill or optimize-skill after the reconciler has
+  surfaced the proposal.
 capability: capability:reconciliation
 surface_hash: sha256:964dbda42cb402ce
 license: Apache-2.0
-measured_tokens: 4641
+measured_tokens: 4589
 ---
 
 <!-- SPDX-License-Identifier: Apache-2.0