netsuite-ai-connector-instructions — Claude Code skill for NetSuite
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.
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-ai-connector-instructions -a claude-codeWhat netsuite-ai-connector-instructions does
The skill loads into a NetSuite AI Service Connector session and applies to every answer. It lays out a fixed tool order: standard reports first, then saved searches, then record lookups and writes, and custom SuiteQL last. The agent is not supposed to jump straight to a hand-written query — if no report or saved search fits, it asks you before trying one.
Inside you get number formatting tables, URL patterns for transactions and entities, the threshold at which an answer should become a React artifact, and a reference of NetSuite record types. Accounting gets its own section: normal balances, double-entry, closed periods. The hard rules are blunt too. Every SuiteQL query needs ROWNUM <= 1000, and a failed ns_createRecord must not be retried automatically — check the record in NetSuite first.
It assumes a live account behind the MCP connector, so without that connection there is nothing for it to steer. The multi-subsidiary and currency parts lean on fields like foreignamount and exchangerate; in a single-currency account those rules rarely come up.
What it helps with
- pick a standard report instead of a hand-written query
- build a dashboard from several metrics
- show amounts as millions and percentages instead of raw numbers
- turn invoice and sales order IDs into clickable links
- avoid breaking records when the agent creates one
Example prompts for the agent
- Show revenue by subsidiary for the quarter
- Find all unpaid invoices for this customer and link them
- Create an invoice from this sales order
How to install netsuite-ai-connector-instructions
1Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-ai-connector-instructions -a claude-code2Manually: put the files in place
~/.claude/skills/netsuite-ai-connector-instructions/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/netsuite-ai-connector-instructions/
1Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-ai-connector-instructions -a codex2Manually: put the files in place
.agents/skills/netsuite-ai-connector-instructions/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-ai-connector-instructions -a cursor2Manually: put the files in place
.cursor/skills/netsuite-ai-connector-instructions/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install oracle/netsuite-suitecloud-sdk netsuite-ai-connector-instructions2Manually: put the files in place
.github/skills/netsuite-ai-connector-instructions/SKILL.md1Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-ai-connector-instructions -a gemini-cli2Platform CLI
gemini skills install https://github.com/oracle/netsuite-suitecloud-sdk --path packages/agent-skills/netsuite-ai-connector-instructionsManually: put the files in place
.devin/skills/netsuite-ai-connector-instructions/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-ai-connector-instructions -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-ai-connector-instructions
How do I install netsuite-ai-connector-instructions in Claude?
Run npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-ai-connector-instructions -a claude-code. The skill file lands at ~/.claude/skills/netsuite-ai-connector-instructions/SKILL.md.
What does netsuite-ai-connector-instructions do?
It teaches the agent the NetSuite tool order, how to format numbers and links, basic accounting logic, and safe SuiteQL use during an MCP connector session.
Why is SuiteQL the last resort?
The skill wants standard reports and saved searches checked first, and a custom query run only after you confirm it, always with ROWNUM <= 1000.
