lens-upgrade

Plans Lens module upgrades and routes legacy topologies to migration paths.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/crisweber2600/Lens.Core.Src --skill lens-upgrade-crisweber2600
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lens-upgrade
Source: https://github.com/crisweber2600/Lens.Core.Src/tree/main/_bmad/lens-work/skills/lens-upgrade
Command: npx skills add https://github.com/crisweber2600/Lens.Core.Src --skill lens-upgrade-crisweber2600

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Upgrading a Lens module without checking schema and version compatibility can break repository topology or leave legacy layouts in an inconsistent state. This Skill inspects the current module configuration, decides whether an in-place upgrade is safe, and routes legacy layouts to the proper migration path instead of guessing. ## Core Features & Use Cases - Compatibility Detection: Loads module config from the control repository and detects the current schema, version, and topology state. - Upgrade Decision Routing: Produces a deterministic decision of no-op, in-place upgrade, or handoff to the legacy migration route. - Structured Action Plans: Emits an upgrade or migration action plan plus a compatibility report, with a dry_run mode that plans without mutating state. - Use Case: A maintainer points the Skill at their control and governance repositories, runs it in dry-run mode, and receives a report showing the detected schema, the chosen upgrade route, blocking issues, and the suggested next command. ## Quick Start Ask the assistant to check whether the Lens module in your control repository can be upgraded in place or needs a legacy migration, using dry-run mode first.

Frequently Asked Questions about lens-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if a Lens module can be upgraded in place?

Provide the absolute paths to your control and governance repositories. The Skill loads the module configuration, detects the schema and topology state, and returns a decision of no-op, in-place upgrade, or legacy migration route.

How to plan a module migration without changing any state?

Set the dry_run input to true. The Skill emits the planned upgrade or migration actions and a compatibility report without mutating any repository state, so you can review the plan before approving execution.

What inputs are required for a Lens module upgrade check?

Two inputs are required: control_repo and governance_repo, both absolute paths to readable, synchronized repositories. Optional inputs are dry_run for plan-only mode and target_version to validate against an explicit version.

What happens when the module schema has no migration path?

An unsupported schema combination with no migration path is a hard-stop error. The Skill halts and reports the blocking issue rather than applying any upgrade actions, since it never proceeds when preconditions fail.

Does the upgrade process write directly to the governance repository?

No. The Skill explicitly prohibits direct governance writes. It only orchestrates compatibility checks, plans migration or upgrade actions, and reports deterministic next steps for follow-up execution.