Package Optimizer
Turn existing package evidence into one bounded, reviewable proposal. The
optimizer is proposal-only: it never edits a package, changes a profile, or
starts a benchmark run.
Scope
| Situation |
Action |
| One package has current evaluator evidence |
Propose one disposition. |
| A bounded family shares the same evidence/profile |
Propose one family plan with a per-package row. |
| Evidence is missing, stale, structurally invalid, or from another profile |
Return inconclusive; name the unresolved package decision and request the smallest recertification needed. |
| User asks to apply a proposal |
Require explicit approval, preserve before artifacts, then hand the edit to the normal package workflow. |
| User asks for a broad benchmark before identifying a package decision |
Refuse the expansion; identify the package decision first. |
Required inputs
- Package scope — one
type/name package or an explicitly bounded family.
- Current evidence — static conformance and relevant eval-case result or a
recorded behavioral result. Cite exact commands, artifacts, or case IDs.
- Capability profile — model/client/tool-surface identity when behavioral
evidence depends on one. Structural-only evidence is labelled as such.
- Decision question — what behavior should be retained, simplified, or
strengthened.
Do not infer effectiveness from package length, heading count, or a static
conformance report/authored package audit. Report-v2 static conformance is
PASS or FAIL; its live effectiveness remains NOT_MEASURED.
Evidence validity
Reject evidence when any condition holds:
- package path, version, or evaluator case differs from the proposed scope;
- a behavioral result has no model/client/tool-surface identity;
- a profile is older than a recorded package change or cannot be compared to the
requested profile;
- the evidence omits a failure, safety outcome, or relevant evaluator result;
- an M4 recertification report pools model targets or lacks complete cells.
A rejection uses the single output format below with Disposition: inconclusive,
Proposed change: none, and Approval required: yes. Its Unresolved package decision must name the package scope and decision question. A recertification
request repeats that exact field; do not request a benchmark without it.
Procedure
- Resolve the package scope and read its definition, evaluator cases, and
current conformance output.
- State the decision question and evidence class:
structural, behavioral,
or profile-scoped behavioral.
- Verify evidence validity. Stop with
inconclusive on any invalid input.
- Select exactly one disposition:
retain — evidence supports the current contract.
simplify — evidence identifies redundant detail and the retained
contract/evaluator proves the smaller scope.
strengthen — a documented failure requires a concrete contract addition.
retire — explicit deprecation or replacement evidence supports removal.
inconclusive — evidence cannot support a safe change.
- Produce a proposal. For non-
retain dispositions, name exact sections or
files to change and the evaluator behavior that must remain true.
- Stop. Do not edit. Require the user to explicitly approve the proposal.
Approval handoff
An approval must name the package, disposition, and proposal ID. The downstream
applying workflow—not this skill—must:
- Save the original package artifact and evaluator evidence.
- Apply only the approved package/family change.
- Run static conformance and relevant eval cases.
- Record before/after artifacts, verification output, profile identity, and any
regression.
- Revert the bounded package change on regression. Do not broaden the scope.
Output format
## Package Optimization Proposal
Scope: <type/name or bounded family>
Decision question: <question>
Evidence class: <structural | behavioral | profile-scoped behavioral>
Evidence:
- <command/artifact/case and observed result>
Capability profile: <identity | not applicable>
Disposition: <retain | simplify | strengthen | retire | inconclusive>
Rationale: <evidence-backed explanation>
Unresolved package decision: <scope + decision question | not applicable>
Proposal ID: <stable scope + evidence identifier>
Proposed change: <none | exact files/sections and intended behavior>
Preservation check: <existing evaluator/eval case>
Approval required: yes
Smallest next action: <concrete action>
Guardrails
- Never edit without explicit approval.
- Never optimize all packages at once.
- Never turn missing evidence into a simplification recommendation.
- Never claim token, cost, or quality improvement without recorded evidence.
- Prefer
retain or inconclusive over speculative change.
1---2name: package-optimizer3description: 'Evaluate one existing package or bounded package family from recorded evaluator evidence and a capability profile, then propose retain, simplify, strengthen, retire, or inconclusive without editing. Use when optimizing a skill, agent, hook, rule, command, utility, or preset; evaluating whether package detail is justified; reviewing a model-refresh impact; or preparing an approval-gated package improvement. Refuses missing, stale, or incomparable evidence and never edits without explicit approval. Not for static conformance reports or authored package audits; use package-evaluator, whose live effectiveness is NOT_MEASURED.'4metadata:5 source: https://skillmd.com/skills/mathews-tom/package-optimizer6 version: 1.0.17 category: development8 phase: review9 tags: [package, optimization, evaluation, evidence, approval]10 difficulty: advanced11---1213# Package Optimizer1415Turn existing package evidence into one bounded, reviewable proposal. The16optimizer is proposal-only: it never edits a package, changes a profile, or17starts a benchmark run.1819## Scope2021| Situation | Action |22| --- | --- |23| One package has current evaluator evidence | Propose one disposition. |24| A bounded family shares the same evidence/profile | Propose one family plan with a per-package row. |25| Evidence is missing, stale, structurally invalid, or from another profile | Return `inconclusive`; name the unresolved package decision and request the smallest recertification needed. |26| User asks to apply a proposal | Require explicit approval, preserve before artifacts, then hand the edit to the normal package workflow. |27| User asks for a broad benchmark before identifying a package decision | Refuse the expansion; identify the package decision first. |2829## Required inputs30311. **Package scope** — one `type/name` package or an explicitly bounded family.322. **Current evidence** — static conformance and relevant eval-case result or a33 recorded behavioral result. Cite exact commands, artifacts, or case IDs.343. **Capability profile** — model/client/tool-surface identity when behavioral35 evidence depends on one. Structural-only evidence is labelled as such.364. **Decision question** — what behavior should be retained, simplified, or37 strengthened.3839Do not infer effectiveness from package length, heading count, or a static40conformance report/authored package audit. Report-v2 static conformance is41`PASS` or `FAIL`; its live effectiveness remains `NOT_MEASURED`.4243## Evidence validity4445Reject evidence when any condition holds:4647- package path, version, or evaluator case differs from the proposed scope;48- a behavioral result has no model/client/tool-surface identity;49- a profile is older than a recorded package change or cannot be compared to the50 requested profile;51- the evidence omits a failure, safety outcome, or relevant evaluator result;52- an M4 recertification report pools model targets or lacks complete cells.5354A rejection uses the single output format below with `Disposition: inconclusive`,55`Proposed change: none`, and `Approval required: yes`. Its `Unresolved package56decision` must name the package scope and decision question. A recertification57request repeats that exact field; do not request a benchmark without it.5859## Procedure60611. Resolve the package scope and read its definition, evaluator cases, and62 current conformance output.632. State the decision question and evidence class: `structural`, `behavioral`,64 or `profile-scoped behavioral`.653. Verify evidence validity. Stop with `inconclusive` on any invalid input.664. Select exactly one disposition:67 - `retain` — evidence supports the current contract.68 - `simplify` — evidence identifies redundant detail and the retained69 contract/evaluator proves the smaller scope.70 - `strengthen` — a documented failure requires a concrete contract addition.71 - `retire` — explicit deprecation or replacement evidence supports removal.72 - `inconclusive` — evidence cannot support a safe change.735. Produce a proposal. For non-`retain` dispositions, name exact sections or74 files to change and the evaluator behavior that must remain true.756. Stop. Do not edit. Require the user to explicitly approve the proposal.7677## Approval handoff7879An approval must name the package, disposition, and proposal ID. The downstream80applying workflow—not this skill—must:81821. Save the original package artifact and evaluator evidence.832. Apply only the approved package/family change.843. Run static conformance and relevant eval cases.854. Record before/after artifacts, verification output, profile identity, and any86 regression.875. Revert the bounded package change on regression. Do not broaden the scope.8889## Output format9091```text92## Package Optimization Proposal9394Scope: <type/name or bounded family>95Decision question: <question>96Evidence class: <structural | behavioral | profile-scoped behavioral>97Evidence:98- <command/artifact/case and observed result>99Capability profile: <identity | not applicable>100101Disposition: <retain | simplify | strengthen | retire | inconclusive>102Rationale: <evidence-backed explanation>103Unresolved package decision: <scope + decision question | not applicable>104105Proposal ID: <stable scope + evidence identifier>106Proposed change: <none | exact files/sections and intended behavior>107Preservation check: <existing evaluator/eval case>108Approval required: yes109110Smallest next action: <concrete action>111```112113## Guardrails114115- Never edit without explicit approval.116- Never optimize all packages at once.117- Never turn missing evidence into a simplification recommendation.118- Never claim token, cost, or quality improvement without recorded evidence.119- Prefer `retain` or `inconclusive` over speculative change.