magpie-optimize-skill

Solid

Optimize an existing framework skill (or sweep a set of them) by applying the restructuring patterns proven on the security-skill suite: split an oversized `SKILL.md` into linked sibling docs, lift concrete/project-specific values out of the body into `<project-config>` placeholders, replace in-agent-context body reads with out-of-context tool calls, batch per-item fetches into a single upfront pass, and add a deterministic pre-flight no-op classifier ahead of LLM passes. Every change is a behavior- preserving proposal the maintainer signs off on; the skill validator must stay green before and after. The refactoring sibling of `write-skill` (which authors net-new skills).

AI & Automation 83 stars 78 forks Updated yesterday Apache-2.0

Install

View on GitHub

Quality Score: 84/100

Stars 20%
64
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

<!-- SPDX-License-Identifier: Apache-2.0 https://www.apache.org/licenses/LICENSE-2.0 --> <!-- Placeholder convention (see AGENTS.md#placeholder-convention-used-in-skill-files): <project-config> → adopting project's `.apache-magpie/` directory <tracker> → value of `tracker_repo:` in <project-config>/project.md <upstream> → value of `upstream_repo:` in <project-config>/project.md <framework> → `.apache-magpie/apache-magpie` in adopters; `.` in the framework standalone --> # optimize-skill Take one existing framework skill — or a maintainer-supplied set of them — and make it leaner without changing what it does. The skill diagnoses a target against the optimization catalogue distilled from the recent security-suite refactors, proposes the applicable passes, and applies them one at a time as **behavior-preserving** edits the maintainer confirms. The skill validator (and, for tracker-touching skills, the placeholder linter) is the deterministic gate: it is green before the first pass and green again after the last. This skill operates only on **framework-internal files** — `SKILL.md` bodies, their sibling docs, `<project-config>` manifests, tool adapters in this repo. It reads no external or attacker-controlled content, so the prompt-injection-defence callout does not apply. It is the refactoring counterpart to [`write-skill`](../write-skill/SKILL.md): `write-skill` authors a net-new skill; `optimize-skill` re...

Details

Author
apache
Repository
apache/magpie
Created
3 months ago
Last Updated
yesterday
Language
Python
License
Apache-2.0

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

skill-discovery-optimizer

Use only for an existing Agent Skill (a local folder with SKILL.md) whose core behavior already works or is nearly complete. Review and optimize its discovery and routing metadata, test false-positive and false-negative triggers, improve trust and installability, generate English and Chinese release materials, and optionally publish it to the authenticated user's confirmed GitHub repository and verify remote installation and skills.sh listing. Trigger for requests such as "audit my skill before publishing", "reduce false triggers and missed triggers in this SKILL.md", "optimize my skill description and GitHub metadata", "帮我审阅并优化这个 Agent Skill", "减少这个 Skill 的误触发和漏触发", "让其��� Agent 更容易搜到并触发它", or "生成中英文 README 后上传 GitHub". Do not use to build the skill's core functionality, install somebody else's skill, perform generic repository publishing or bilingual README work merely because a project is called a skill, do generic web GEO/SEO, run long-term growth analytics, or publish an MCP server.

3 Updated 2 days ago
Bing-Bryan
AI & Automation Featured

meta-optimize

Analyze ARIS usage logs and propose optimizations to SKILL.md files, reviewer prompts, and workflow defaults. Outer-loop harness optimization inspired by Meta-Harness (Lee et al., 2026). Use when user says "优化技能", "meta optimize", "improve skills", "分析使用记录", or wants to optimize ARIS's own harness components based on accumulated experience.

14,964 Updated today
wanshuiyin
AI & Automation Listed

refactor-skills

Reviews the markdown and template files changed in the current session and tightens them for agent performance — sharper trigger descriptions, progressive disclosure, imperative voice, one-claim-per-bullet, fewer redundant rules — while preserving every workflow step, constraint, and trigger condition. Use when the user has just edited one or more skill or prompt files (`SKILL.md`, `references/*.md`, `recipes/*.md`, agent templates, slash-command prompts) and wants a tightening pass before committing, or invokes "/refactor-skills", "refactor this skill", "tighten the skill", "polish SKILL.md", "make this skill leaner". Behaviour-preserving only — never use this to add features, expand scope, or remove rules.

0 Updated 1 weeks ago
usrrname