AI APPLICATION DEVELOPMENT / Sentry
Sentry Prompt Optimizer
Starts from a written contract before rewriting a prompt, and names the model family as a choice rather than a default.
“Creates, optimizes, and iteratively refines agent prompts, system prompts, developer prompts, and reusable prompt templates. Use when asked to improve a prompt, optimize a system prompt, rewrite an agent prompt, tune prompt wording, make a prompt more reliable, port prompts between OpenAI, Claude, or Gemini, or build prompt evals.”
01 / THE REASONING
Why this made the selection.
- Optimization starts from a written contract and an eval slice, not from a rewrite.
- Different reference files are loaded for a new prompt versus an existing one.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- skills/prompt-optimizer/SKILL.md
- skills/prompt-optimizer/references/core-patterns.md
- LICENSE
- vercel-labs/skills@48dc9e8eb8aa19040e91cb90ba0b642c9cbad57e:README.md
Our findings
- The pinned skill records task type, model snapshot, prompt surface, and success criteria before editing.
- A new prompt loads core patterns, model-family notes, and transformed examples; an existing prompt loads the meta-optimization loop first.
- Optimization baselines the current prompt on the same eval slice, clusters failures, and writes concrete edit criticisms.
- The returned package is Target, Success Criteria, and External Context, with repo context cited by exact path.
- The workflow inventories loaded versus merely referenced context, clusters failures, compares candidate changes and checks holdout behavior instead of optimizing by intuition alone.
- External-context inventory uses repository-relative paths, distinguishes loaded, referenced, and out-of-scope files, and asks for only the excerpts required by the prompt or evaluation case.
Not established by this review
- The skill was not executed inside a host agent.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
npx skills add getsentry/skills/skills/prompt-optimizer --skill prompt-optimizerRun in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.
Optional: install the reviewed revision
Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.
npx skills add https://github.com/getsentry/skills/tree/d18b7aa8ba878354e5c348310230e652f7690f9c/skills/prompt-optimizer --skill prompt-optimizer- Install the complete skill directory with its references, SPEC, and SOURCES; a copied SKILL.md alone is incomplete.
- Choose your AI tools and project or global scope in the installer, then review its permissions before using the skill.
Before you start
- Node.js/npm for this installer
- An agent that supports the Agent Skills format
- The prompts under review and, for eval-backed work, a way to run them
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- Skill definition ↗Checked
https://github.com/getsentry/skills/blob/d18b7aa8ba878354e5c348310230e652f7690f9c/skills/prompt-optimizer/SKILL.md
Supports: Workflow and stated scope
- Repository licence ↗Checked
https://github.com/getsentry/skills/blob/d18b7aa8ba878354e5c348310230e652f7690f9c/LICENSE
Supports: Redistribution terms
https://raw.githubusercontent.com/getsentry/skills/d18b7aa8ba878354e5c348310230e652f7690f9c/skills/prompt-optimizer/SKILL.md
Supports: review.findings, bestFor