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