angular-migration

Overview

What is angular-migration?

angular-migration is a specialized skill designed to help frontend developers migrate legacy AngularJS (1.x) applications to modern Angular (2+) frameworks. It provides guidance on hybrid app setups, incremental component rewriting, dependency injection modernization, and routing migration. This skill is essential for teams looking to upgrade, refactor, or modernize their AngularJS codebase without disrupting ongoing development.

Who should use this skill?

• Frontend developers and teams maintaining AngularJS applications
• Organizations planning a phased or complete migration to Angular
• Developers seeking best practices for hybrid AngularJS/Angular apps
• Teams aiming to modernize legacy code while minimizing risk

Problems solved by angular-migration

• Enables gradual migration from AngularJS to Angular using proven strategies
• Supports hybrid app architectures for large or complex projects
• Guides on converting directives to Angular components
• Helps update dependency injection and routing systems to modern standards

How to Use

Installation Steps

1. Install the skill directly with:

   npx skills add https://github.com/wshobson/agents --skill angular-migration

2. Start by reviewing the SKILL.md file for a high-level migration overview and workflow.

3. Explore supporting files such as README.md, AGENTS.md, metadata.json, and any rules/, resources/, or scripts/ directories for detailed migration steps and helper scripts.

Migration Strategies Supported

• Big Bang (Complete Rewrite): Rewrite the entire app in Angular, suitable for small or greenfield projects.
• Incremental (Hybrid Approach): Run AngularJS and Angular side-by-side using ngUpgrade, ideal for large apps or continuous delivery environments.
• Vertical Slice: Migrate features one at a time, allowing new features in Angular while maintaining legacy code in AngularJS—best for medium-sized apps or when features are clearly separated.

Adapting the Workflow

• Use the provided migration strategies as a template, but tailor the approach to your project's size, complexity, and delivery needs.
• Leverage hybrid app setup examples to bootstrap both AngularJS and Angular codebases together during migration.

FAQ

When is angular-migration the right choice?

Use angular-migration when you need to upgrade an existing AngularJS application to Angular, especially if you want to minimize risk and downtime by migrating incrementally or maintaining a hybrid app during the transition.

What files should I review first?

Start with SKILL.md for a summary of migration strategies and best practices. Then check README.md and any scripts or rules directories for implementation details.

Does angular-migration provide code samples?

Yes, the skill includes hybrid app setup examples and outlines for component conversion and dependency injection updates. Review the repository files for practical code snippets.

Is this skill suitable for small or large projects?

angular-migration supports both complete rewrites (for small projects) and incremental migrations (for large or complex apps), making it flexible for various project sizes.

Where can I find more resources?

Open the Files tab in the repository to access all supporting documentation, references, and helper scripts for a comprehensive migration workflow.