repairshopr-setting - SKILL.md Agent Skill

name: repairshopr-setting description: Retrieve account and system settings from RepairShopr license: MIT compatibility: opencode metadata: audience: administrators, integrators api: GET /settings, GET /settings/tabs, GET /settings/printing

What I do

I retrieve various system settings from RepairShopr. This includes account-level configurations, UI tab visibility, business hours, locale settings, and printing configurations. These are read-only settings.

When to use me

Use this when:

You need to know account configuration (currency, date format, time zone)
Checking which features/tabs are enabled in your account
Getting business hours for appointment scheduling
Accessing printing settings for PDF generation
Building integrations that need to respect account locale

How to use

Required API base URL:

VITE_REPAIRSHOPR_SUBDOMAIN
VITE_REPAIRSHOPR_API_KEY

Permissions: Likely requires admin or similar; not explicitly documented for each endpoint.

Get General Settings (GET /settings) Returns comprehensive account settings.

Get Tabs Settings (GET /settings/tabs) Returns which top-level navigation tabs are enabled/visible.

Get Printing Settings (GET /settings/printing) Returns printing-related settings such as messaging channel and registers.

Example call:

// Get all settings
const settings = await skill({ name: "repairshopr-setting" })

// Get tabs configuration
const tabs = await skill({ name: "repairshopr-setting" }, 
  {}, { method: 'GET', endpoint: '/tabs' }
)

// Get printing settings
const printing = await skill({ name: "repairshopr-setting" }, 
  {}, { method: 'GET', endpoint: '/printing' }
)

Response includes (from main /settings):

{
  "customers": { "required_fields": null, "customer_fields": [], "customer_field_answers": [] },
  "assets": { "asset_types": [], "asset_type_fields": [], "asset_type_field_answers": [] },
  "locale": {
    "iso_code": "en",
    "currency_symbol": "$",
    "date_format": "mm-dd-yy",
    "time_format": "hh:mm tt",
    "time_zone": "America/Los_Angeles",
    "time_offset": "-08:00"
  },
  "ticket": {
    "ticket_types": [],
    "ticket_type_fields": [],
    "problem_types": ["Virus", "TuneUp", "Hardware", "Software", "Other"],
    "priorities": ["", "0 Urgent", "1 High", "2 Normal", "3 Low"]
  },
  "business_hours_enabled": true,
  "business_hours": [
    { "day": "Monday", "start": "09:00", "end": "17:00", "closed": false },
    // ...
  ],
  "default_holiday_calendar": "USA",
  "msp_addon": null
}

From /tabs: object with boolean flags for each feature area (msp_dashboard, customers, assets, tickets, invoices, etc.)

From /printing: object with messaging_channel, registers array.

Important

These are read-only endpoints; cannot modify settings via API
Locale settings are crucial for date/number formatting in client applications
Business hours can be used for appointment availability calculations
Tab visibility reflects your account's enabled modules
Time zone info helps with datetime conversions

Related skills

repairshopr-appointment - Uses business hours for scheduling
repairshopr-ticket - Ticket types/priorities from settings
Any skill needing locale awareness