netsuite-sdf-safe-guide — Claude Code skill for SDF checks
Generate Object XML for SuiteScript files and review code or deployment settings. Useful when building a NetSuite SDF project or investigating a deployment error.
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-sdf-safe-guide -a claude-codeWhat netsuite-sdf-safe-guide does
The skill examines a SuiteCloud Development Framework project. It can scan /SuiteScripts/ for JavaScript files and create Object XML when a file has a valid @NScriptType annotation and no matching XML already exists. It can also review existing XML and deployment configuration.
For SuiteScript reviews, it checks areas such as governance limits, security, N/query usage, and batch processing. It can also help inspect manifest.xml and deploy.xml. A file without a valid @NScriptType annotation won't qualify for Object XML generation.
Invoke it with /netsuite-sdf-safe-guide, or configure Claude Code to preload it through .claude/settings.local.json. Its guidance focuses on SuiteScript 2.1, with references to 2.0 and 1.0 where the differences matter.
What it helps with
- generate Object XML for eligible files in
/SuiteScripts/ - review deployment XML settings
- spot SuiteScript governance issues
- investigate an SDF deployment failure
Example prompts for the agent
- Generate Object XML for eligible scripts in
/SuiteScripts/. - Review this SuiteScript file for issues and governance limits.
- Check my deployment XML for incorrect settings.
How to install netsuite-sdf-safe-guide
1Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-sdf-safe-guide -a claude-code2Manually: put the files in place
~/.claude/skills/netsuite-sdf-safe-guide/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/netsuite-sdf-safe-guide/
1Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-sdf-safe-guide -a codex2Manually: put the files in place
.agents/skills/netsuite-sdf-safe-guide/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-sdf-safe-guide -a cursor2Manually: put the files in place
.cursor/skills/netsuite-sdf-safe-guide/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install oracle/netsuite-suitecloud-sdk netsuite-sdf-safe-guide2Manually: put the files in place
.github/skills/netsuite-sdf-safe-guide/SKILL.md1Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-sdf-safe-guide -a gemini-cli2Platform CLI
gemini skills install https://github.com/oracle/netsuite-suitecloud-sdk --path packages/agent-skills/netsuite-sdf-safe-guideManually: put the files in place
.devin/skills/netsuite-sdf-safe-guide/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-sdf-safe-guide -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-sdf-safe-guide
How do I install netsuite-sdf-safe-guide in Claude Code?
Run npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-sdf-safe-guide -a claude-code. The skill file is placed at ~/.claude/skills/netsuite-sdf-safe-guide/SKILL.md.
What does netsuite-sdf-safe-guide do?
It generates Object XML for SuiteScript and reviews code, XML, and SDF configuration. Its code checks cover governance, security, and common pitfalls.
Which files qualify for Object XML generation?
The skill scans .js files under /SuiteScripts/ and checks for a valid @NScriptType annotation. It skips files that already have corresponding XML or lack a valid script type.
