plain-upgrade
Upgrades Plain packages and applies required migration changes. Use when updating to newer package versions.
Best use case
plain-upgrade is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Upgrades Plain packages and applies required migration changes. Use when updating to newer package versions.
Teams using plain-upgrade should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/plain-upgrade/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How plain-upgrade Compares
| Feature / Agent | plain-upgrade | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Upgrades Plain packages and applies required migration changes. Use when updating to newer package versions.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Upgrade Plain Packages ## 1. Run the upgrade ``` uv run plain upgrade [package-names...] ``` This will show which packages were upgraded (e.g., `plain-postgres: 0.1.0 -> 0.2.0`). ## 2. Apply code changes for each upgraded package For each package that was upgraded: 1. Run `uv run plain changelog <package> --from <old-version> --to <new-version>` 2. Read the "Upgrade instructions" section 3. If it says "No changes required", skip to next package 4. Apply any required code changes ## 3. Update agent rules and skills Run `uv run plain agent install` to sync any updated rules and skills from the upgraded packages. ## 4. Validate 1. Run `uv run plain fix` to fix formatting 2. Run `uv run plain check` to validate (linting, preflight, migrations, tests) ## Guidelines - Process ALL packages before testing - DO NOT commit any changes - Keep code changes minimal and focused - Report any issues or conflicts encountered
Related Skills
plainx-release
Releases plainx packages with version suggestions, changelog generation, and git tagging. Use when releasing a package to PyPI.
plain-postgres-doctor
Check overall database health — schema correctness and operational health. Use when asked to check the database, validate schema, optimize indexes, or diagnose Postgres problems.
plain-portal
Open a remote Python shell on a production machine via encrypted tunnel. Use when you need to inspect production data, debug issues, run queries, or transfer files.
plain-optimize
Captures and analyzes performance traces to identify slow queries and N+1 problems. Use when a page is slow, there are too many queries, or the user asks about performance.
plain-install
Installs Plain packages and guides through setup steps. Use when adding new packages to a project.
plain-guide
Answer questions about the Plain framework by researching docs and source code. Use when asked "how do I...", "does Plain support...", or "how does X work?" questions.
plain-bug
Submit a bug report for the Plain framework. Use when the user wants to report a bug, error, or unexpected behavior. Collects context and creates a GitHub issue.
release
Releases Plain packages with intelligent version suggestions and parallel release notes generation. Use when releasing packages to PyPI.
future
Navigate and manage the future/ directory — view dependency graphs, filter by arc, find unblocked futures, and identify what to work on next. Use when deciding what to work on, exploring planned work, or checking dependencies between futures.
explainer
Create explainer videos with narration and AI-generated visuals. Triggers on: "解说视频", "explainer video", "explain this as a video", "tutorial video", "introduce X (video)", "解释一下XX（视频形式）".
account-upgrade
账号升级与权限说明 skill。用于处理配额不足、绑定账号、会员权益、PDF 不可用、升级方案和 API Key 入口说明。当用户说“怎么升级”“为什么不能导出 PDF”“绑定账号”时使用。
skill-rails-upgrade
Analyze Rails apps and provide upgrade assessments