LabscoConnect MCP ↗
get-convex logo✓ Official★ 63

convex-optimize

Works through improvements to an existing Convex app: it starts from the launch-readiness score, adds upgrades for out-of-date Convex components, and presents one plan, security and data-loss fixes first. Nothing changes until you confirm, and it re-scores afterwards.

by get-convexpart of get-convex/agent-skills

One of 30 skills in the get-convex/agent-skills package — works on its own, and pairs well with its siblings.

WHEN YOUR AGENT SHOULD USE IT

A QUICK BOUNDARY

USE FOR

  • Upgrade stale Convex components as part of one plan.
  • Apply fixes only after you approve the plan.
  • Compare the score before and after.

DO NOT USE FOR

  • Adding production error capture: it offers to install Convex's Sentinel, which is not publicly available as of October 2026.

Documents

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

Audit and optimize an existing Convex app

The remediation WORKFLOW for an existing app: open with a scored assessment, then act on it — upgrade stale components and set up observability — plan-then-confirm-then-apply. The assessment itself is delegated to launch-readiness (the findings-bus scorer); optimize's distinct value is the actions it takes on the result.

Workflow
  1. Detect the app: a convex/ directory, the schema, and whether it's an anonymous or cloud deployment.
  2. ASSESS via launch-readiness — one scored, deduped report across authz/reviewer/advisor/insights with an ordered fix plan. Do not re-run those passes by hand; optimize consumes launch-readiness's report rather than re-implementing the audit.
  3. UPGRADE: run check-updates against the pinned @convex-dev/* components and fold stale-component (staleness-class) findings into the same plan.
  4. OBSERVABILITY: if the readiness report flagged an observability gap (no prod error capture), offer to install sentinel.
  5. Present the combined prioritized plan — the launch-readiness score + the fix plan + upgrades + observability, security/data-loss first — and apply only on explicit confirmation, dispatching each fix to its fixCapability.
  6. After applying, re-run the launch-readiness assessment and show the score delta.
Rules
  • Read-only first. Present a plan and CONFIRM before changing any file.
  • Delegate the audit to launch-readiness (the findings-bus scorer); don't re-implement reviewer/advisor/insights inline — optimize's job is acting on the report (upgrades + observability), not re-scoring.
  • Prioritize security and data-loss risks above style, following launch-readiness's ordering.
  • Never auto-land changes on someone's existing prod app; re-assess after applying and show the score moved.

Installation

Copy & paste — that's it
npx skills add get-convex/agent-skills --skill "convex-optimize" --full-depth

Run this in your project — your agent picks the skill up automatically.

BEFORE IT WILL WORK

2 FOR YOU
  1. 01
    The other Convex skills, starting with launch-readiness

    Install all the Convex skills (add --all to the install command), not this one alone. Its assessment comes from the launch-readiness skill, which runs four other Convex skills.

  2. 02
    A check-updates tool, for component upgrades

    The upgrade step runs a tool called check-updates, which the skill itself does not include. Check your assistant has it before relying on this skill for upgrades.

License

Licensed under Apache-2.0— you can use, modify, and redistribute it under that license's terms.

View the full license file on GitHub →