Agent skill

Output Dev Upgrade Prompt Models

by growthxai in growthxai/output

Bulk-upgrade the model field across .prompt files to the latest version of each prompt's existing family.

Apache-2.0Auto-check: notes

Install Output Dev Upgrade Prompt Models

skills CLI
$ npx skills add growthxai/output --skill output-dev-upgrade-prompt-models -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install growthxai/output output-dev-upgrade-prompt-models --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/growthxai/output.git skills-src && mkdir -p .claude/skills && cp -r skills-src/coding_assistants/claude/plugins/outputai/skills/output-dev-upgrade-prompt-models .claude/skills/output-dev-upgrade-prompt-models && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
output-dev-upgrade-prompt-models
GitHub stars
442
Token cost
~1.6k tokens
SKILL.md length
746 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
Apache-2.0

At a glance

Bulk-upgrade the model field across .prompt files to the latest version of each prompt's existing family.

  • Works in 7 steps: Discover → Parse current model → Classify family → …
  • Prompt models have drifted (eg sonnet-4 → sonnet-4-6)
  • SKILL.md covers When to invoke, Workflow, Caveats and See also
  • Calls npm

What it does

Output Dev Upgrade Prompt Models is an agent skill from growthxai/output. Bulk-upgrade the model field across .prompt files to the latest version of each prompt's existing family. Use when prompt models have drifted (eg sonnet-4 → sonnet-4-6), after a long pause between framework updates, or as part of a periodic model-freshness pass. Within-family only — never changes provider or tier.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with OpenAI. The repository describes itself as: The open-source TypeScript framework for building AI workflows and agents. Designed for Claude Code describe what you want, Claude builds it, with all the best practices already… The licence is Apache-2.0.

When your agent uses it

  • Prompt models have drifted (eg sonnet-4 → sonnet-4-6)
  • After a long pause between framework updates
  • As part of a periodic model-freshness pass

Example prompts

  • “/output-dev-upgrade-prompt-models”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, Edit, Glob

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Discover
  2. Parse current model
  3. Classify family
  4. Look up latest in family
  5. Diff & confirm
  6. Edit
  7. Verify

What it can do on your machine

Read from SKILL.md and the folder at commit 99ee298. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Edit
    • Glob

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • models.dev

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Output Dev Upgrade Prompt Models loads about 1.6k tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 746 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~87
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Edit, Glob

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from growthxai/output at commit 99ee298, republished under its Apache-2.0 licence (© growthxai). 746 words, ~1,648 tokens.

Download SKILL.mdSave it as .claude/skills/output-dev-upgrade-prompt-models/SKILL.md (or your agent's skills folder).
name
output-dev-upgrade-prompt-models
description
Bulk-upgrade the model field across .prompt files to the latest version of each prompt's existing family. Use when prompt models have drifted (eg sonnet-4 → sonnet-4-6), after a long pause between framework updates, or as part of a periodic model-freshness pass. Within-family only — never changes provider or tier.
allowed-tools
Bash, Read, Edit, Glob

Upgrade Prompt Models In-Place

Walks every .prompt file in a project (or scoped subtree), classifies each model into its provider+family bucket, looks up the latest stable model in that bucket via the output-dev-model-selection snapshot, and rewrites the model: line. Provider and family tier are preserved — a Haiku stays a Haiku, an Anthropic stays an Anthropic.

This skill explicitly does not swap providers or escalate tiers (eg Haiku → Sonnet). Those are deliberate human decisions handled separately.

When to invoke

  • A periodic refresh: "upgrade all my prompt models to the latest"
  • After a long break between framework updates, where dated snapshot IDs (eg claude-sonnet-4-20250514) have aged out
  • Right after creating a new project from the CLI scaffolder, to pull every templated default forward to the current best

Workflow

Step 1 — Discover

Find every .prompt file under the target scope. Default scope is the project's src/ tree; the user may scope to a single workflow.

Step 2 — Parse current model

For each file, read the YAML frontmatter (between the first pair of --- lines) and pull out provider: and model:.

Step 3 — Classify family

Match the existing model into a family bucket. Family is preserved across the upgrade.

PatternFamily
claude-opus-*anthropic-opus
claude-sonnet-*anthropic-sonnet
claude-haiku-*anthropic-haiku
gpt-*-proopenai-pro
gpt-*-miniopenai-mini
gpt-*-nanoopenai-nano
gpt-N.M (no suffix)openai-default
gemini-*-flash-lite*google-flash-lite
gemini-*-flash*google-flash
gemini-*-pro*google-pro

If a model doesn't match any pattern, skip the file and log a warning. Do not guess.

Step 4 — Look up latest in family

For each prompt, find the latest stable model in the same family by following output-dev-model-selection — fetch its snapshot, apply its filter rules (skip preview/alpha/beta, prefer unversioned aliases), and translate the chosen id to prompt-file form.

Use this family → snapshot-key + id regex map to pin the lookup to the existing tier:

FamilySnapshot keyid regex
anthropic-opusanthropicclaude-opus-
anthropic-sonnetanthropicclaude-sonnet-
anthropic-haikuanthropicclaude-haiku-
openai-proopenai-pro$
openai-defaultopenai^openai/gpt-[0-9.]+$
openai-miniopenai-mini$
openai-nanoopenai-nano$
google-progoogle-pro (excluding -flash)
google-flashgoogle-flash$|-flash-[0-9]
google-flash-litegoogle-flash-lite

If no stable match exists for a family (only pre-release entries available), surface that to the user and skip the file rather than guessing or downgrading to a different family.

Bail loudly on a failed snapshot. If the snapshot fetch itself returned nothing — network down, gateway shape changed, curl or jq missing — abort the run before Step 5. Do not continue with an empty snapshot and report "no upgrades needed", because that lies: the prompts weren't actually checked. Tell the user the snapshot fetch failed, point them at the manual-fallback steps in output-dev-model-selection, and exit.

Step 5 — Diff & confirm

Build a per-file report comparing the current model to the resolved latest:

src/workflows/foo/prompts/bar@v1.prompt   claude-sonnet-4-20250514  →  claude-sonnet-4-6
src/workflows/foo/prompts/baz@v1.prompt   claude-haiku-4-5          ✓ already latest

Print the full report. Wait for explicit user confirmation before writing. In CI / non-interactive contexts, default to dry-run.

Show full SKILL.md (288 more words)Show less
Step 6 — Edit

For each confirmed file, edit only the YAML frontmatter:

  • Replace the model: line with the resolved latest ID.
  • If a # current as of YYYY-MM-DD … comment is present (the convention used in output-dev-prompt-file examples and CLI scaffolds), update its date to today's (date +%Y-%m-%d). Match the comment by the literal current as of prefix and only rewrite the date — leave the trailing text intact.
  • Leave provider:, temperature:, maxOutputTokens: (or deprecated maxTokens:), providerOptions:, and the message body untouched.

Refreshing the dated comment in the same edit keeps the "as of" convention coherent — without it, an upgraded prompt would have a fresh model paired with a stale date.

Step 7 — Verify

After the batch:

  • Spot-check a handful of files to confirm the YAML still has a frontmatter delimiter and message body.
  • Rebuild the worker so the new model strings take effect (npm run output:worker:build).

The Output SDK doesn't validate prompt model IDs at build time — invalid IDs only surface at first run. If smoke-tests are available, run at least one workflow per upgraded family.

Caveats

  • Within-family only. This skill never upgrades Sonnet → Opus, never swaps Anthropic for OpenAI. To change tier or provider, edit prompts manually or use output-dev-prompt-file.
  • Dated snapshots get bumped. A pin like claude-sonnet-4-20250514 becomes the unversioned alias claude-sonnet-4-6. If the pin was load-bearing for reproducibility, surface that and skip the file.
  • @vertex and bedrock namespace suffixes. Models like claude-sonnet-4-20250514@vertex or anthropic.claude-sonnet-4-20250514-v1:0 need manual upgrade. The AI Gateway listing covers direct provider IDs only.
  • Models.dev pricing lag. Even after the upgrade, response.cost may be incomplete with total: null for the brand-new model until models.dev catches up. The runtime call still works.

See also

© growthxai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in coding_assistants/claude/plugins/outputai/skills/output-dev-upgrade-prompt-models of growthxai/output.

Open the folder on GitHubat commit 99ee298

Compare with similar skills

Output Dev Upgrade Prompt Models next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Output Dev Upgrade Prompt Models compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Output Dev Upgrade Prompt Models this skillgrowthxai/output442—~1.6kAutomated safety check: NotesApache-2.0
Geo Fundamentalswasp-lang/wasp19k9 repos~861Automated safety check: PassMIT
AI SDKvercel-labs/ai-facts16820 repos~1.2kAutomated safety check: PassNone
AI Image Generation and Editingzhayujie/CowAgent47k—~1.3kAutomated safety check: PassMIT
PR Design DocOpenHands/OpenHands91k—~2.4kAutomated safety check: PassMIT
SEO GeoReScienceLab/opc-skills1.8k4 repos~2.1kAutomated safety check: PassApache-2.0

Similar skills

  • Geo Fundamentals

    wasp-lang/wasp

    Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity).

    19k GitHub starsUsed in 9 repos~861 tokens
    Marketing & SEOAuto-check passed
  • AI SDK

    vercel-labs/ai-facts

    Official

    Answer questions about the AI SDK and help build AI-powered features.

    168 GitHub starsUsed in 20 repos~1.2k tokens
    AI & LLM EngineeringAuto-check passed
  • Generates or edits images from text prompts through a Python script that picks an image backend based on which API keys are configured.

    47k GitHub stars~1.3k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • PR Design Doc

    OpenHands/OpenHands

    For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…

    91k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed
  • SEO Geo

    ReScienceLab/opc-skills

    SEO & GEO (Generative Engine Optimization) for websites. An agent skill from ReScienceLab/opc-skills.

    1.8k GitHub starsUsed in 4 repos~2.1k tokens
    Marketing & SEOAuto-check passed
  • Open Code Review CLI

    alibaba/open-code-review

    Runs the ocr command-line tool to review Git changes, a commit or a branch comparison with an AI model, returning line-level comments and optionally applying fixes.

    46k GitHub stars~3.1k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from growthxai/output

All 50 skills in this repo
  • Output Build Workflow

    growthxai/output

    Implement an Output SDK workflow from a plan document. An agent skill from growthxai/output.

    442 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Output Credentials Edit

    growthxai/output

    View, edit, and set encrypted credentials in an Output.ai project.

    442 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check: notes
  • Wire encrypted credentials to environment variables using the credential: convention.

    442 GitHub stars~930 tokensUpdated yesterday
    Auto-check: notes
  • Output Credentials Init

    growthxai/output

    Initialize encrypted credentials for an Output.ai project. An agent skill from growthxai/output.

    442 GitHub stars~803 tokensUpdated yesterday
    Auto-check: notes
  • Output Debug Workflow

    growthxai/output

    Debug Output SDK workflow issues. An agent skill from growthxai/output.

    442 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Output Dev Agent Class

    growthxai/output

    Use the Agent class for multi-step tool loops, conversation history, streaming progress, and reusable LLM agents.

    442 GitHub stars~2.6k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Output Dev Upgrade Prompt Models

What does Output Dev Upgrade Prompt Models do?

Bulk-upgrade the model field across .prompt files to the latest version of each prompt's existing family. Output Dev Upgrade Prompt Models is an agent skill from growthxai/output.prompt files to the latest version of each prompt's existing family.

When should I use Output Dev Upgrade Prompt Models?

Output Dev Upgrade Prompt Models fits situations like: prompt models have drifted (eg sonnet-4 → sonnet-4-6); after a long pause between framework updates; as part of a periodic model-freshness pass.

How do I install Output Dev Upgrade Prompt Models in Claude Code?

Run `npx skills add growthxai/output --skill output-dev-upgrade-prompt-models -a claude-code`. Or copy the skill folder (coding_assistants/claude/plugins/outputai/skills/output-dev-upgrade-prompt-models in growthxai/output) into .claude/skills/output-dev-upgrade-prompt-models in your project. Claude Code loads it when a task matches its description.

How do I install Output Dev Upgrade Prompt Models in Codex?

Run `npx skills add growthxai/output --skill output-dev-upgrade-prompt-models -a codex`. Or copy the skill folder (coding_assistants/claude/plugins/outputai/skills/output-dev-upgrade-prompt-models in growthxai/output) into .agents/skills/output-dev-upgrade-prompt-models in your project. Codex loads it when a task matches its description.

Can I use Output Dev Upgrade Prompt Models in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add growthxai/output --skill output-dev-upgrade-prompt-models -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/output-dev-upgrade-prompt-models, .gemini/skills/output-dev-upgrade-prompt-models, .github/skills/output-dev-upgrade-prompt-models and .opencode/skills/output-dev-upgrade-prompt-models in your project.

What does Output Dev Upgrade Prompt Models need to run?

Going by SKILL.md and its folder, Output Dev Upgrade Prompt Models needs the command-line tools its instructions call (npm). Its frontmatter pre-approves these tools: Bash, Read, Edit, Glob.

Does Output Dev Upgrade Prompt Models access the network?

SKILL.md names 1 domain. As links in the text: models.dev. This is read from the text; nothing was executed.

Is Output Dev Upgrade Prompt Models safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Output Dev Upgrade Prompt Models use?

Output Dev Upgrade Prompt Models is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Output Dev Upgrade Prompt Models use?

About 1.6k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Output Dev Upgrade Prompt Models?

Skills that share tags, products or a category with Output Dev Upgrade Prompt Models: Geo Fundamentals (wasp-lang/wasp, 19k stars), AI SDK (vercel-labs/ai-facts, 168 stars), AI Image Generation and Editing (zhayujie/CowAgent, 47k stars) and PR Design Doc (OpenHands/OpenHands, 91k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Output Dev Upgrade Prompt Models?

growthxai (a GitHub organization) maintains it in growthxai/output, which has 442 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on October 9, 2026.

Source: growthxai/output on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.