repairshopr-ticket-comment - SKILL.md Agent Skill

name: repairshopr-ticket-comment description: Add a comment to an existing RepairShopr ticket license: MIT compatibility: opencode metadata: audience: technicians, kiosk applications api: POST /tickets/{id}/comment

What I do

I add a comment to an existing RepairShopr ticket. Can optionally set the comment as hidden (private/internal) and attribute it to a specific technician.

When to use me

Use this when:

Adding the initial customer issue description
Updating ticket status with notes
Adding private/internal notes (hidden from customer)
Recording serial numbers, PINs, or diagnostic info

How to use

Required API base URL:

VITE_REPAIRSHOPR_SUBDOMAIN
VITE_REPAIRSHOPR_API_KEY

Required:

ticketId (integer) - The ticket ID

Parameters:

subject (string) - Comment subject/title
body (string) - Comment content (can be plain text or HTML)
tech (string) - Technician name (e.g., "Jesus Vargas")
user_id (integer) - User ID performing the action
hidden (boolean) - If true, comment is private/internal
sms_body (string) - SMS version of comment
do_not_email (boolean) - Prevent email notification

Example call:

const result = await skill({ name: "repairshopr-ticket-comment" }, {
  ticketId: 12345,
  subject: "Initial Issue",
  body: "Customer reports laptop will not power on. Battery not charging.',
  tech: "Jesus Vargas",
  user_id: 131330,
  hidden: false
})

Response includes:

comment object with id, created_at, subject, body, etc.

Hidden comments

Set hidden: true for:

Serial numbers and system info
Internal diagnostic notes
Anything the customer should not see

Text formatting

Use plain text for simplicity
If comment_format parameter is set on ticket, it may affect formatting
For rich text, pass HTML in body

Notes

Requires "Tickets - Edit" permission
Both subject and body are required unless you're only updating specific fields