PlugWiki

angular-migration Skill (wshobson) for Claude: What It Does and How to Install It

Guides Claude through moving an AngularJS app to Angular, with hybrid mode and before and after code for each part.

Installs
11.1K
on skills.sh
Stars
42.1K
on GitHub
Files
1
besides SKILL.md
Updated
Oct 2026
last repo commit

This is a migration guide for Claude from wshobson's agents collection. It compares three strategies (big bang, incremental hybrid and vertical slice). It then shows before and after code for the hybrid setup, controllers, directives, services, dependency injection, routing and forms.

It loads when you upgrade an AngularJS app, plan a framework migration or modernize legacy Angular code. It bundles no scripts. The examples use @angular/upgrade/static (ngUpgrade) and need an Angular project of your own.

Good for

  • Teams with an AngularJS (1.x) app that needs to move to Angular (2+)
  • Tech leads choosing between a rewrite and a step-by-step migration
  • Developers converting directives, services, routing and forms one at a time

Install angular-migration

Claude Code

  1. 1

    Copy this prompt.

    Install the angular-migration skill in Claude Code. Run this command:
    
    /plugin marketplace add wshobson/agents
    /plugin install framework-migration@claude-code-workflows
    
    Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Pick one route. The plugin routes install the whole framework-migration plugin: 2 agents, 3 commands and 4 skills (counted from the plugin folder in the repo tree, which has no hooks or MCP config files). The skills-only routes install just this skill, with no agents or commands. The skill needs an AngularJS project of your own.

From the project README. Source.

What's in the skill

When it loads

Migrate from AngularJS to Angular using hybrid mode, incremental component rewriting, and dependency injection updates. Use when upgrading AngularJS applications, planning framework migrations, or modernizing legacy Angular code.

Sections in SKILL.md

  1. When to Use This Skill
  2. Migration Strategies
  3. 1. Big Bang (Complete Rewrite)
  4. 2. Incremental (Hybrid Approach)
  5. 3. Vertical Slice
  6. Hybrid App Setup
  7. Component Migration
  8. AngularJS Controller → Angular Component
  9. AngularJS Directive → Angular Component
  10. Service Migration
  11. Dependency Injection Changes
  12. Downgrading Angular → AngularJS
  13. Upgrading AngularJS → Angular
  14. Routing Migration
  15. Additional patterns and templates

Key facts

License
MIT
Installs on skills.sh
11,063 (Nov 2, 2026)
Last repo commit
Oct 30, 2026

What it includes

  • Big bang, incremental hybrid and vertical slice

    Each strategy has a note on when it fits: small apps, large apps with continuous delivery, or medium apps with distinct features.

    Try: “Which migration strategy fits our 80-screen AngularJS app that ships every week?”

    Read · Three migration strategies

  • Run AngularJS and Angular side by side with UpgradeModule

    Shows main.ts and app.module.ts that bootstrap the Angular app first and then the AngularJS app.

    Try: “Set up a hybrid bootstrap for our AngularJS app.”

    Write · Hybrid app setup

  • Rewrites a $scope controller as an Angular component

    The before and after example moves $scope functions into component methods.

    Write · Controller to component

  • Rewrites a directive with scope bindings as a component

    The example turns '=' and '&' bindings into @Input and @Output.

    Write · Directive to component

  • Turns a factory that uses $http into an injectable service

    The Angular version uses HttpClient and returns Observables.

    Write · Service migration

  • Downgrade Angular services and upgrade AngularJS ones

    Uses downgradeInjectable to expose a new service to old code, and an InjectionToken to reach an old service from new code.

    Write · Dependency injection both ways

  • Moves $routeProvider routes to RouterModule

    Converts the /users and /users/:id routes in the example to Angular Routes.

    Write · Routing migration

  • AngularJS form to an Angular reactive form (details.md)

    Shows the ng-model form beside a FormBuilder version with required and email validators.

    Write · Forms migration

  • Four phases from setup to cleanup (details.md)

    Setup (1-2 weeks), infrastructure (2-4 weeks), feature migration (varies) and cleanup (1-2 weeks).

    Read · Migration timeline

From the official docs

Permissions

Low risk

The main risk is that Claude rewrites and deletes parts of your app during a large migration. Work on a branch and read each diff.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • Cleanup phase removes AngularJS code

    details.md lists removing AngularJS code and ngUpgrade as the last phase. Review deletions and run your tests before you commit them. github.com

  • The plugin route installs more than this skill

    The framework-migration plugin has 4 skills, 2 agents and 3 commands. The repo tree shows no hooks or MCP config files in its folder. The skills-only routes install only this skill. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details
Turning on read-onlyNo read-only mode. Use version control.
Talks toPackage downloads if you run the Angular CLI or npm install steps the timeline mentions
Scopes
  • Claude edits your app's source files when you ask for a migration step

  • The timeline in references/details.md includes a cleanup phase that removes AngularJS code and ngUpgrade

Questions

What does the angular-migration skill do?

It gives Claude a playbook for moving an AngularJS app to Angular. Claude uses it to pick a strategy, set up hybrid mode and convert controllers, directives, services, routing and forms.

How do I install angular-migration?

Use the install box at the top of this page. It lists the plugin route and two skills-only commands: npx skills add wshobson/agents --skill angular-migration and gh skill install wshobson/agents angular-migration (GitHub CLI 2.90 or later). The skills-only commands skip the plugin's agents and commands.

Which migration strategy does it recommend?

It does not pick one for you. It lists big bang for small or greenfield apps, incremental hybrid for large apps with continuous delivery, and vertical slice for medium apps with distinct features.

Will it migrate my app by itself?

No. SKILL.md is a guide of strategies and code examples. It lists no command or script that converts an app, so the changes come from Claude editing your code.

Does it work for modern Angular versions?

SKILL.md says it covers AngularJS (1.x) to Angular (2+) and updating to the latest Angular versions. It does not name a target version, so tell Claude which one you use.

Is it safe?

Installing it adds a guide and one reference file, with no scripts. The risk is in the edits Claude makes to your app. The timeline in details.md ends with removing AngularJS code and ngUpgrade, so work on a branch and read each diff before you merge.

Is this skill from Anthropic?

No. It is in wshobson/agents, a community collection. The skill sits in the framework-migration plugin there.

Should I install the whole framework-migration plugin?

Only if you want the rest. The README documents a plugin route for Claude Code and Codex. The plugin folder holds 4 skills, 2 agents and 3 commands, and the repo tree shows no hooks or MCP config files in it.

Information

updated Nov 2, 2026

Repository
wshobson/agents
Folder
plugins/framework-migration/skills/angular-migration

wshobson/agentsskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4
  1. angular-migration SKILL.md · github.com
  2. wshobson/agents README · github.com
  3. framework-migration plugin.json · github.com
  4. angular-migration details.md · github.com

Updated Nov 2, 2026.