vega-multi-tv-migration Skill (AmazonAppDev): TV Monorepo

Makes Claude migrate a Vega OS (Fire TV) app into a React Native monorepo that also targets Android TV and Apple TV.

Installs: 11K; on skills.sh
Stars: 6; on GitHub
Files: 15; besides SKILL.md
Updated: Sep 2026; last repo commit

vega-multi-tv-migration walks Claude through three phases: analysis of your codebase, implementation of a Yarn monorepo with shared, vega and expotv packages, and platform support for Android TV and Apple TV. A decision tree picks the starting phase. SKILL.md says the target is 70-85% code reuse across Android TV, Apple TV and Vega OS.

It triggers on migrating a Vega or Fire TV app, building a multi-platform TV app, or setting up Yarn workspaces for TV apps. It rewrites project structure and runs yarn and Expo commands in your repo. It bundles 3 reference files and 11 template files.

Good for

React Native developers with an existing Vega OS or Fire TV app
Teams adding Android TV or Apple TV to a TV app
Developers setting up Yarn workspaces for shared TV code

Install vega-multi-tv-migration

Claude Code

Copy this prompt.

Install the vega-multi-tv-migration skill in Claude Code. Run this command:

npx skills add AmazonAppDev/devices-agent-skills --skill vega-multi-tv-migration

Then check that it loaded and tell me how to use it.

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

Requires Node.js.

The README documents three routes: the GitHub CLI (gh skill install), the skills CLI and a manual copy of the folder. The commands here install only vega-multi-tv-migration. The gh command with --agent claude-code is our edit of the README's placeholder example. The skill has you restructure a React Native project into a Yarn monorepo and run yarn commands, so there is no Claude app upload route. The references expect Yarn 4 and Node.js 20 or newer (PHASE2_IMPLEMENTATION.md troubleshooting table).

From the project README. Source.

What's in the skill

When it loads

Migrate Vega OS (Amazon Fire TV) applications to multi-platform React Native monorepo supporting Android TV, Apple TV, and other platforms. Covers analysis, implementation, and native module integration. Use when migrating TV apps to support multiple platforms or building new multi-platform TV applications.

Sections in SKILL.md

Overview
When to Apply
Phase Priority Guide
Quick Decision Tree
Quick Reference
Critical: Project Structure
Critical: Dependency Classification
High: VMRP Configuration
References
Phase 1: Analysis (analysis-)
Phase 2: Implementation (impl-)
Phase 3: Platform Support (platform-)
Templates
Problem → Skill Mapping
Workflow
Attribution

Key facts

Author: AmazonAppDev GitHub organization. The repo LICENSE names Amazon; the skill folder LICENSE names "Vega Skills"
License: MIT (repo LICENSE and the skill folder's own LICENSE; README says MIT)
Installs on skills.sh: 11,007 (Nov 2, 2026)
GitHub stars: 6 (Nov 2, 2026)
Last repo commit: Sep 21, 2026
What it includes: 16 files including SKILL.md: its own LICENSE, 3 references and 11 templates. Two templates are Metro .js config files.
Needs: Yarn 4 and Node.js 20 or newer, per the PHASE2_IMPLEMENTATION.md troubleshooting table
Works in: Agents the README names for gh skill install: claude-code, kiro-cli, cursor, codex and github-copilot; the skills CLI route also works
Part of: The devices-agent-skills repo, which holds 2 skills in its git tree

What it includes

Analyzes the codebase, classifies dependencies and plans the migration
Details are in references/PHASE1_ANALYSIS.md.
Read · Phase 1: analysis
Scaffolds the monorepo, migrates code and sets up VMRP and Metro
Includes yarn init -2, yarn set version stable and yarn install, per PHASE2_IMPLEMENTATION.md.
Runs code · Phase 2: implementation
Adds Android TV and Apple TV with an Expo TV package
Runs yarn expotv:prebuild, expotv:android and expotv:ios.
Runs code · Phase 3: platform support
Picks the start phase from whether you have an app, an analysis and a monorepo
Read · Decision tree
Metro resolution, duplicate React versions, VMRP and TypeScript path errors
A problem-to-file table in SKILL.md maps each issue to a reference.
Write · Configuration help
11 files: package.json, tsconfig, .yarnrc.yml, Metro and Expo configs, checklist
Write · Templates
assets/templates/VALIDATION_CHECKLIST.md for verifying each phase
Read · Validation checklist
A shell script Claude creates to set TVOS_DEPLOYMENT_TARGET to 15.1
PHASE3_PLATFORM_SUPPORT.md says to apply it only if you see deployment target errors.
Runs code · fix-tvos-deployment.sh

From the official docs

Permissions

Medium risk

vega-multi-tv-migration restructures your project and runs yarn and Expo commands, including templates that remove folders. Our advice: use a git branch with everything committed.

What it can do

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

Watch out for

It restructures your project and installs packages
Phase 2 initializes Yarn 4, creates the monorepo folders, migrates code and runs yarn install. Commit your work first and use a branch. github.com
The Expo template regenerates native folders
The expotv package.json template runs npx expo prebuild --clean and then ./scripts/fix-tvos-deployment.sh. Its clean script is rm -rf node_modules android ios .expo. Check these before you run them. github.com
It creates and runs a shell script that edits Xcode files
PHASE3 tells Claude to create packages/expotv/scripts/fix-tvos-deployment.sh. It runs sed -i on project.pbxproj in the ios folder and in Pods to set TVOS_DEPLOYMENT_TARGET to 15.1. github.com
The root template runs a clean command
The root package.json template has a clean script that runs yarn workspaces foreach --all run clean ; rm -rf node_modules. github.com

Technical details

Turning on read-only	No read-only switch.
Talks to	npm registry via yarn install
Sign-in and keys	SKILL.md names no account, key or token.
Scopes	Claude restructures your project into packages/shared, packages/vega and packages/expotv Runs yarn, expo and shell commands in your repo Installs npm dependencies

Questions

What does vega-multi-tv-migration do?

It makes Claude migrate a Vega OS (Fire TV) React Native app into a monorepo that also builds for Android TV and Apple TV. It works in three phases: analysis, implementation and platform support.

How do I install it?

Use the install box at the top. The README documents the GitHub CLI, the skills CLI and a manual folder copy. The box installs only this skill.

Do I need an existing Vega app?

No. The decision tree says that if you are starting from scratch you skip Phase 1 and begin with Phase 2.

What tools does it expect?

The references expect Yarn 4 and Node.js 20 or newer, and a project that can run yarn commands. Phase 3 uses Expo prebuild for Android TV and Apple TV.

Is it official Amazon software?

It sits in the AmazonAppDev GitHub organization, whose description reads "Sample code, assets, and public projects associated with Amazon Developer". The repo LICENSE names Amazon as copyright holder. The README says the repo holds skills for open-source frameworks, and points to Amazon Devices Builder Tools for Amazon-specific SDK skills.

What else is in the repo?

The README lists one more skill, rn-tv-ui-best-practices, for React Native TV UI practices such as focus management and remote navigation. The repo has 2 skills in its git tree.

Does it work in the Claude app?

No upload route is offered, because the skill restructures a project and runs yarn commands. The install box covers Claude Code, Codex and the skills CLI.

Is it safe?

It rewrites your project layout and runs yarn and Expo commands, including an Expo prebuild with --clean in the template. Our advice: run it on a git branch with everything committed.

Information

updated Nov 2, 2026

Repository: amazonappdev/devices-agent-skills
Folder: skills/vega-multi-tv-migration

amazonappdev/devices-agent-skills skills.sh

Sources

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

Show all 6

vega-multi-tv-migration SKILL.md · github.com
README · github.com
PHASE2_IMPLEMENTATION.md · github.com
repo LICENSE · github.com
skill LICENSE · github.com
skills.sh listing · skills.sh