Generated banner for Convex Optimize
Generated logo for Convex Optimize

Convex Optimize

ConvexOfficialPublished by Convex

  • Skill
  • Workflow
  • Software development
  • Apache-2.0
  • No issues found

From the author

Audit and optimize an existing Convex app: security, scale, upgrades, observability.
— the description by Convex

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The convex-optimize skill provides a systematic approach to improving existing Convex applications. It functions by consuming a comprehensive assessment report from the launch-readiness tool to identify security, scalability, and configuration issues. The skill then orchestrates a remediation plan that includes upgrading stale components and configuring observability tools like sentinel, ensuring that critical security and data-loss risks are addressed before minor improvements. It emphasizes a safe, plan-then-confirm-then-apply methodology, concluding with a re-assessment to demonstrate the impact of the applied changes.

What it does

  • Detects the application structure including schema and deployment type.
  • Consumes audit reports from launch-readiness to generate a prioritized fix plan.
  • Checks for and applies updates to pinned Convex development components.
  • Installs observability tools like sentinel when gaps are identified.
  • Executes remediation steps only after explicit user confirmation.
  • Performs post-remediation assessment to verify score improvements.

When to use it

  • When preparing a Convex application for production deployment.
  • When you need to audit an existing app for security and scalability risks.
  • When you want to ensure all Convex dependencies are up to date.
  • When you need to implement observability to capture production errors.

Advantages

  • Reduces manual effort by automating the remediation of audit findings.
  • Prioritizes critical security and data-loss risks automatically.
  • Provides a safe workflow with mandatory confirmation before file changes.
  • Validates the effectiveness of changes by comparing pre- and post-fix scores.

Usage examples

“Optimize my current Convex project for production readiness.”
The agent will scan the project, run a launch-readiness assessment, identify necessary component upgrades, and present a prioritized plan for your approval.
“Check my Convex app for security issues and missing observability.”
The agent will audit the codebase, report on identified risks, and offer to install observability tools if they are currently missing.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/convex/convex-optimize/download
  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip convex-optimize.zip -d .agents/skills

Documentation by Convex

<!-- GENERATED from convex-agents content/capabilities/optimize.json — do not edit by hand. -->

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.

Files

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
Convex
Publisher
Convex (Official)
Source
convex/agent-skills · skills/convex-optimize · commit f60629d
Licence
Apache License 2.0 (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Convex.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download convex-optimize.zip