Agent skill

Persona Upgrade Migration

by jeremylongshore in jeremylongshore/tons-of-skills-marketplace

Migrate between dated Persona API versions using inventory, contract fixtures, dual-read evidence, and rollback.

MITAuto-check passedDevOps & Cloud

Install Persona Upgrade Migration

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill persona-upgrade-migration -a claude-code

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

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace persona-upgrade-migration --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/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/persona-upgrade-migration .claude/skills/persona-upgrade-migration && 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
persona-upgrade-migration
GitHub stars
2.8k
Token cost
~1.2k tokens
SKILL.md length
481 words
Files
2 (incl. references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Migrate between dated Persona API versions using inventory, contract fixtures, dual-read evidence, and rollback.

  • Works in 6 steps: Freeze the baseline → Read the provider delta → Harden for additions → …
  • Changing Persona-Version
  • SKILL.md covers Overview, Prerequisites, Instructions and Authentication, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Persona Upgrade Migration is an agent skill from jeremylongshore/tons-of-skills-marketplace. Migrate between dated Persona API versions using inventory, contract fixtures, dual-read evidence, and rollback. Use when changing Persona-Version. Trigger with: "upgrade Persona API", "migrate Persona version", "update Persona-Version".

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/official-docs.md`). Compatibility notes: Requires an authorized Persona environment, current first-party documentation, a reviewed dated API version, and privacy-safe operational evidence.

It sits in DevOps & Cloud. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • Changing Persona-Version
  • With: upgrade Persona API
  • Migrate Persona version
  • Update Persona-Version

Example prompts

  • “upgrade Persona API”
  • “migrate Persona version”
  • “update Persona-Version”
  • “/persona-upgrade-migration”

Requirements

  • Compatibility (from SKILL.md): Requires an authorized Persona environment, current first-party documentation, a reviewed dated API version, and privacy-safe operational evidence.
  • Pre-approved tools (allowed-tools): Read, Grep, Write, Edit

Workflow steps

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

  1. Freeze the baseline
  2. Read the provider delta
  3. Harden for additions
  4. Build dual-version fixtures
  5. Canary the explicit header
  6. Promote with rollback

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. 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:

    • Read
    • Grep
    • Write
    • Edit

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    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):

    • docs.withpersona.com

    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.

  • Compatibility

    Requires an authorized Persona environment, current first-party documentation, a reviewed dated API version, and privacy-safe operational evidence.

    From compatibility in the SKILL.md frontmatter.

Context cost

Persona Upgrade Migration loads about 1.2k tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 66 tokens; SKILL.md has 481 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~66
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.1k

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 passed

The automated check found no risky patterns in SKILL.md.

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 jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 481 words, ~1,196 tokens.

Download SKILL.mdSave it as .claude/skills/persona-upgrade-migration/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
persona-upgrade-migration
description
Migrate between dated Persona API versions using inventory, contract fixtures, dual-read evidence, and rollback. Use when changing Persona-Version. Trigger with: "upgrade Persona API", "migrate Persona version", "update Persona-Version".
allowed-tools
Read, Grep, Write, Edit
compatibility
Requires an authorized Persona environment, current first-party documentation, a reviewed dated API version, and privacy-safe operational evidence.
version
2.0.0
argument-hint
[from-version-to-version]
model
inherit
effort
high
license
MIT
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
saas, persona, migration, api-version, compatibility

Dated Persona API Version Migration

Overview

Treat Persona-Version as a contract migration. Because the request header overrides the key’s configured version and compatible releases can add or reorder data, migrate parsers, webhook handling, and operational evidence together.

Prerequisites

  • Source and target dated API versions
  • Endpoint, resource, event, and consumer inventory
  • Representative redacted fixtures plus a reversible rollout mechanism

Instructions

Step 1: Freeze the baseline

Record API-key configured versions, explicit headers, endpoints, templates, response hashes, events, dashboards, and consumer assumptions.

Step 2: Read the provider delta

Map documented breaking and compatible changes to each request, JSON:API mapper, event handler, policy rule, test, and data export.

Step 3: Harden for additions

Make parsers tolerate new resources, fields, types, event types, and array ordering before switching the header.

Step 4: Build dual-version fixtures

Capture or synthesize equivalent source and target responses for success, error, pagination, inquiry sessions, verifications, and webhooks.

Step 5: Canary the explicit header

Send the target Persona-Version for a bounded cohort and compare transport, resource, event, decision, latency, and quota metrics.

Step 6: Promote with rollback

Change the explicit header and key configuration deliberately, retain source-version compatibility during the observation window, and document the rollback trigger.

Authentication

Test source and target versions with appropriately scoped keys. The explicit request header is authoritative for that request, so accidental fallback to a key default is a gate failure.

Tool Discipline

Use Read and Grep to inspect application configuration, provider documentation, fixtures, schemas, tests, and redacted operational evidence before proposing a change. Use Write or Edit only for an approved implementation, configuration, test, runbook, or redacted receipt. Do not create, resume, approve, decline, redact, rotate, revoke, deploy, or otherwise mutate production Persona resources without explicit operator approval.

Show full SKILL.md (197 more words)Show less

Output

  • Version delta and affected-consumer inventory
  • Dual-version fixture and canary comparison
  • Promotion, observation, rollback, and retirement receipt

Return the environment, resource and event identifiers, API version, template context, source-contract fingerprint, evidence, unresolved risk, rollback state, and final decision without exposing bearer keys, webhook secrets, inquiry session tokens, raw identity documents, or unnecessary PII.

Examples

A parser that assumes a closed verification-type enum is changed to preserve unknown values before the canary. The target version then runs for five percent of traffic while decisions and webhook reconciliation are compared.

Error Handling

FailureResponse
Key and header versions disagreeRecord both and use the reviewed explicit header; remove accidental ambiguity before rollout.
Target response breaks a consumerRoll back the cohort, add a versioned mapper or tolerant parser, and rerun fixtures.
Rollback cannot read new eventsDo not promote until forward-compatible event handling exists.

Validation

Verify the result against the linked first-party evidence, the pinned API version, redacted contract fixtures, an expected failure path, and the documented rollback or manual-disposition path. A successful request is not proof of a successful identity decision.

Resources

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

Files

SKILL.md and 1 other file (references) in skills/.curated/persona-upgrade-migration of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • references/official-docs.md

Open the folder on GitHubat commit cfae287

Compare with similar skills

Persona Upgrade Migration 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.

Persona Upgrade Migration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Persona Upgrade Migration this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.2kAutomated safety check: PassMIT
Monitor CInrwl/nx29k6 repos~4.7kAutomated safety check: PassMIT
Terraform and OpenTofu Guideagentscope-ai/QwenPaw36k6 repos~4.2kAutomated safety check: PassApache-2.0
Vercel Optimize Auditvercel-labs/agent-skills32k8 repos~4.3kAutomated safety check: PassNone
Analyze GitHub Action Logswithastro/astro63k1 repos~1.3kAutomated safety check: PassCustom licence
Openclaw Live Updateropenclaw/openclaw392k—~3.7kAutomated safety check: PassMIT

Similar skills

  • Monitor CI

    nrwl/nx

    Monitor Nx Cloud CI pipeline and handle self-healing fixes. An agent skill from nrwl/nx.

    29k GitHub starsUsed in 6 repos~4.7k tokens
    DevOps & CloudAuto-check passed
  • Terraform and OpenTofu Guide

    agentscope-ai/QwenPaw

    Guidance for writing and testing Terraform and OpenTofu code: module structure, naming, test approaches, CI/CD workflows, state handling and security scanning.

    36k GitHub starsUsed in 6 repos~4.2k tokens
    DevOps & CloudAuto-check passed
  • Vercel Optimize Audit

    vercel-labs/agent-skills

    Official

    Runs a metrics-first audit of a deployed Vercel project, gating investigations on real signals to produce ranked, citation-backed cost and performance recommendations.

    32k GitHub starsUsed in 8 repos~4.3k tokens
    DevOps & CloudAuto-check passed
  • Official

    Analyze recent GitHub Actions workflow runs to identify patterns, mistakes, and improvements.

    63k GitHub starsUsed in 1 repo~1.3k tokens
    DevOps & CloudAuto-check passed
  • Openclaw Live Updater

    openclaw/openclaw

    Maintain the canonical live OpenClaw main checkout, macOS LaunchAgent-managed Gateway, local macOS app, exact-head main CI, and recurring full release validation.

    392k GitHub stars~3.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Docs Learn PR Preview

    netdata/netdata

    Use only when the user explicitly asks to build, run, preview, inspect, or validate learn.netdata.cloud locally using the contents of a PR or documentation branch before merge.

    81k GitHub stars~2k tokensUpdated today
    DevOps & CloudAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Categories

Questions about Persona Upgrade Migration

What does Persona Upgrade Migration do?

Migrate between dated Persona API versions using inventory, contract fixtures, dual-read evidence, and rollback. Persona Upgrade Migration is an agent skill from jeremylongshore/tons-of-skills-marketplace. Migrate between dated Persona API versions using inventory, contract fixtures, dual-read evidence, and rollback.

When should I use Persona Upgrade Migration?

Persona Upgrade Migration fits situations like: changing Persona-Version; with: upgrade Persona API; migrate Persona version; update Persona-Version.

How do I install Persona Upgrade Migration in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill persona-upgrade-migration -a claude-code`. Or copy the skill folder (skills/.curated/persona-upgrade-migration in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/persona-upgrade-migration in your project. Claude Code loads it when a task matches its description.

How do I install Persona Upgrade Migration in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill persona-upgrade-migration -a codex`. Or copy the skill folder (skills/.curated/persona-upgrade-migration in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/persona-upgrade-migration in your project. Codex loads it when a task matches its description.

Can I use Persona Upgrade Migration 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 jeremylongshore/tons-of-skills-marketplace --skill persona-upgrade-migration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/persona-upgrade-migration, .gemini/skills/persona-upgrade-migration, .github/skills/persona-upgrade-migration and .opencode/skills/persona-upgrade-migration in your project.

What does Persona Upgrade Migration need to run?

SKILL.md names no scripts, command-line tools or credentials: Persona Upgrade Migration is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Grep, Write, Edit. Compatibility (from SKILL.md): Requires an authorized Persona environment, current first-party documentation, a reviewed dated API version, and privacy-safe operational evidence..

Does Persona Upgrade Migration access the network?

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

Is Persona Upgrade Migration safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Persona Upgrade Migration use?

Persona Upgrade Migration is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Persona Upgrade Migration use?

About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 890 tokens, read only when the agent opens those files.

What are the alternatives to Persona Upgrade Migration?

Skills that share tags, products or a category with Persona Upgrade Migration: Monitor CI (nrwl/nx, 29k stars), Terraform and OpenTofu Guide (agentscope-ai/QwenPaw, 36k stars), Vercel Optimize Audit (vercel-labs/agent-skills, 32k stars) and Analyze GitHub Action Logs (withastro/astro, 63k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Persona Upgrade Migration?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,827 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 10, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.