Skip to main content
skill CX Codex

netsuite-suitescript-upgrade — Claude Code skill: migration and setup

This skill assesses SuiteScript 1.0, 2.0, and 2.x migrations, converts scripts to 2.1, and checks the result. Use it when updating a NetSuite codebase.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-suitescript-upgrade -a claude-code
Open on GitHub

What netsuite-suitescript-upgrade does

The analysis mode estimates migration complexity. Conversion moves a script to SuiteScript 2.1 and modernizes its JavaScript; explanation mode covers API mappings and migration concepts, while validation checks for leftover 1.0 patterns and conversion mistakes. Reference material covers API and object mappings, alternatives for unmapped APIs, entry point changes, and behavioral differences.

Run /netsuite-suitescript-upgrade with a mode and file path. Use convert to update a script and validate to inspect the result. Conversion supports --dry-run to preview changes without writing files and --annotated to include numbered notes. SuiteScript 2.1 is the target, including when the source uses 2.0 or 2.x.

What it helps with

  • estimate the effort to migrate SuiteScript
  • move a SuiteScript 1.0 file to version 2.1
  • upgrade a SuiteScript 2.0 or 2.x script
  • check a converted file for remaining 1.0 patterns
  • look up a 2.1 replacement for an nlapi* or nlobj* API

Example prompts for the agent

  • Assess the migration for /SuiteScripts/my_ue.js with /netsuite-suitescript-upgrade analyze.
  • Convert /SuiteScripts/my_ue.js to SuiteScript 2.1 with /netsuite-suitescript-upgrade convert.
  • Check /SuiteScripts/my_ue_v2.js for migration issues with /netsuite-suitescript-upgrade validate.

How to install netsuite-suitescript-upgrade

1Skills CLI (Vercel)

npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-suitescript-upgrade -a claude-code

2Manually: put the files in place

~/.claude/skills/netsuite-suitescript-upgrade/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/netsuite-suitescript-upgrade/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about netsuite-suitescript-upgrade

How do I install netsuite-suitescript-upgrade in Claude Code?

Run npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-suitescript-upgrade -a claude-code. The skill file is at ~/.claude/skills/netsuite-suitescript-upgrade/SKILL.md.

What does netsuite-suitescript-upgrade do?

It assesses migrations, converts SuiteScript 1.0, 2.0, and 2.x scripts to 2.1, explains API mappings, and checks converted code.

Can I preview a conversion without changing files?

Yes. Add --dry-run to the convert command to display the proposed changes without writing files.

Similar skills

All skills for Programming languages →

From the same set11

netsuite-suitescript-records-reference Reference data covering 272 NetSuite record types and fields for SuiteScript. Validates internal IDs, data types, and search filters before writing code. CX Codex +1 1,000installs netsuite-sdf-roles-and-permissions Writes and reviews NetSuite SDF role XML and deployment permissions, returning exact permkey and permlevel values. CX Codex +1 884installs netsuite-sdf-project-documentation Generates technical documentation for NetSuite SDF projects. It parses scripts, manifests, and XML objects to build architecture diagrams and deployment guides. CX Codex +1 833installs netsuite-uif-spa-reference Look up NetSuite UIF types and APIs while building or debugging SPA components. The skill points the agent to definitions for core and UI component packages. CX Codex +1 790installs netsuite-ai-connector-instructions This skill sets the tool order, output format and SuiteQL safety rules for an AI working against a live NetSuite account over the MCP connector. CX Codex +1 778installs netsuite-owasp-secure-coding Equips AI agents with OWASP Top 10 (2021) secure coding rules for JavaScript and SuiteScript 2.1. Useful for auditing RESTlets and stopping injections. CX Codex +1 771installs netsuite-sdf-safe-guide Generate Object XML for SuiteScript files and review code or deployment settings. Useful when building a NetSuite SDF project or investigating a deployment error. CX Codex +1 604installs netsuite-suitescript-learning Interactive training tool for NetSuite SuiteScript and SDF. It teaches SAFE Guide standards, inspects code files, adds inline educational notes, and generates practice quizzes. CX Codex +1 457installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor