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.
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-suitescript-upgrade -a claude-codeWhat 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.jswith/netsuite-suitescript-upgrade analyze. - Convert
/SuiteScripts/my_ue.jsto SuiteScript 2.1 with/netsuite-suitescript-upgrade convert. - Check
/SuiteScripts/my_ue_v2.jsfor 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-code2Manually: put the files in place
~/.claude/skills/netsuite-suitescript-upgrade/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/netsuite-suitescript-upgrade/
1Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-suitescript-upgrade -a codex2Manually: put the files in place
.agents/skills/netsuite-suitescript-upgrade/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-suitescript-upgrade -a cursor2Manually: put the files in place
.cursor/skills/netsuite-suitescript-upgrade/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install oracle/netsuite-suitecloud-sdk netsuite-suitescript-upgrade2Manually: put the files in place
.github/skills/netsuite-suitescript-upgrade/SKILL.md1Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-suitescript-upgrade -a gemini-cli2Platform CLI
gemini skills install https://github.com/oracle/netsuite-suitecloud-sdk --path packages/agent-skills/netsuite-suitescript-upgradeManually: put the files in place
.devin/skills/netsuite-suitescript-upgrade/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-suitescript-upgrade -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.