smartsuite-patterns

Enforces SmartSuite API rules for choices, UUIDs, and dry-run safety.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/elevanaltd/oa --skill smartsuite-patterns
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: smartsuite-patterns
Source: https://github.com/elevanaltd/oa/tree/main/.claude/skills/smartsuite-patterns
Command: npx skills add https://github.com/elevanaltd/oa --skill smartsuite-patterns

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Incorrect SmartSuite API usage, especially with choices vs. options, can lead to irreversible UUID corruption and data loss, while inconsistent field formats cause validation errors, jeopardizing data integrity.

Core Features & Use Cases

  • UUID Corruption Prevention: Enforces the critical rule of using choices (with existing UUIDs) and never options to prevent permanent data destruction in select fields.
  • Critical Field Format Rules: Provides strict guidelines for linked records (must be arrays), select/status fields (use option codes), and formula/rollup fields (read-only), ensuring correct data manipulation.
  • Dry-Run Safety Pattern: Mandates using dryRun: true for all create/update operations to verify output before irreversible changes, protecting against accidental data modification.
  • Use Case: When updating a SmartSuite field with new options, use this skill to ensure you correctly use choices with existing UUIDs and perform a dryRun first to prevent data corruption, saving critical data.

Quick Start

Update a SmartSuite field, ensuring you use choices instead of options to preserve existing UUIDs.