netsuite-sdf-roles-and-permissions — Claude Code skill for NetSuite
Writes and reviews NetSuite SDF role XML and deployment permissions, returning exact permkey and permlevel values.
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-sdf-roles-and-permissions -a claude-codeWhat netsuite-sdf-roles-and-permissions does
This skill answers NetSuite permission questions with concrete values instead of guesses. While you author customrole XML or review a <permkey> block in an SDF object, it resolves the exact internal ID and picks a matching access level.
Two references ship with it: references/permissions.json holds standard IDs and display-name aliases, and references/permission-index.md indexes them by category and business scenario. Standard permissions carry the prefixes ADMI_, LIST_, REGT_, REPO_ and TRAN_. Custom record permissions work differently — their permkey is a script ID such as customrecord_invoice_batch, so validate it against your project XML rather than the reference file.
Levels are meant to stay small: VIEW for reading and search, CREATE to add records without touching existing ones, EDIT to create and update, FULL to delete or administer broadly. The skill treats FULL as an exception you have to justify. For a script execution role it refuses to recommend the built-in Administrator for production, so any config leaning on that role is worth a second look. Each answer names the permkey, the level, why that level is enough, and flags where the skill inferred from a use case without confirming against project XML.
What it helps with
- map a NetSuite UI permission label to its exact internal ID
- pick the smallest
permlevelfor an integration role - tell a standard permission apart from a custom record script ID
- strip duplicate
<permkey>entries from one role definition - build a script execution role without the built-in Administrator
Example prompts for the agent
- Generate
customroleXML for a role that only needs to view sales orders - Check the
<permkey>values in this SDF object and flag any that miss the reference - What
permleveldoes an integration role need to work with customer invoices?
How to install netsuite-sdf-roles-and-permissions
1Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-sdf-roles-and-permissions -a claude-code2Manually: put the files in place
~/.claude/skills/netsuite-sdf-roles-and-permissions/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/netsuite-sdf-roles-and-permissions/
1Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-sdf-roles-and-permissions -a codex2Manually: put the files in place
.agents/skills/netsuite-sdf-roles-and-permissions/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-sdf-roles-and-permissions -a cursor2Manually: put the files in place
.cursor/skills/netsuite-sdf-roles-and-permissions/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install oracle/netsuite-suitecloud-sdk netsuite-sdf-roles-and-permissions2Manually: put the files in place
.github/skills/netsuite-sdf-roles-and-permissions/SKILL.md1Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-sdf-roles-and-permissions -a gemini-cli2Platform CLI
gemini skills install https://github.com/oracle/netsuite-suitecloud-sdk --path packages/agent-skills/netsuite-sdf-roles-and-permissionsManually: put the files in place
.devin/skills/netsuite-sdf-roles-and-permissions/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-sdf-roles-and-permissions -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-roles-and-permissions
How do I install netsuite-sdf-roles-and-permissions in Claude?
Run npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-sdf-roles-and-permissions -a claude-code. The skill file then lands at ~/.claude/skills/netsuite-sdf-roles-and-permissions/SKILL.md.
What does netsuite-sdf-roles-and-permissions do?
It resolves exact permkey and permlevel values for NetSuite SDF roles and deployments, validates them against bundled references, and keeps recommendations at least privilege.
How do custom record permissions differ from standard ones?
Standard permissions live in references/permissions.json and use the ADMI_, LIST_, REGT_, REPO_ and TRAN_ prefixes. A custom record's permkey is its script ID, like customrecord_invoice_batch, so check it against your project XML.