Alarm Card

An Alarm Card covers one alarm or HMI error code: what it means, what usually causes it in the field, how to clear it, and what to do when it comes back. It starts from the code and text the Technician sees on the display, so InSkill GPT can match the card to the alarm the moment it is reported. For how Alarm Cards fit with the other card types, see Field Cards.

This page shows a complete Alarm Card, explains what each section captures, and then shows how to create one with the InSkill Field Card Creator skill.

📘

Note

The example is built from fictional AZ Copper Works records and the AZ Machine Works AM-650 manuals. Its pictures are illustrations marked For demo purposes only.

The Example Card

What Each Section Covers

An Alarm Card leads with the alarm exactly as the display shows it, then explains it before telling the Technician what to do.

Example Questions

These questions were asked in Ask on Copilot (Truck) with the card uploaded, and InSkill GPT answered them correctly. Use them to check the card after you upload it.

How to Create an Alarm Card

Alarm Cards are created in Claude with the InSkill Field Card Creator skill. It takes the alarm definition from the maker's fault code reference and the causes from the records, ordered by how often each one was found.

Follow these five stages in order:

1. Gather the source data
2. Run the skill
3. Review the card
4. Upload to InSkill
5. Test the card in Ask

Gather the source data

Collect every record of the alarm: operator reports, tech notes, telematics or HMI alarm history, and work orders. Add the maker's fault code reference and the diagnostic procedure for the alarm.

The source for this example is a page of handwritten tech notes:

The skill reads the handwriting and gives every entry a source ID:

Two more records came from the typed field log:

id,date,shift,unit,tech,area,entry
E0023,2026-08-24,Day,B43113,RT,Brakes,"AM-3021 red, 268 F, on the loaded haul to Dump 1. EHL out of the FLOAT detent. Operator stopped as instructed by the CD-7 and let the oil cool. Lever returned to FLOAT; operator briefed."
E0031,2026-09-14,Night,B43113,RT,Brakes,"AM-3021 amber on the Ramp 2 descent. HaulTrak speed-by-grade showed service brake use instead of the retarder. Operator coached."

The manuals used were the AMW-SM-650-25 Service Manual (brake cooling on page 14, the AM-3021 procedure on page 34, and the fault code on page 38) and the AMW-MP-650-25 Maintenance and Parts Manual (test panel on page 35, parts on page 56).

Run the skill

In Claude, attach the notes, the field log, the manuals and the customer logo, and use a prompt like this:

Use the InSkill Field Card Creator skill.

Create an alarm card for AM-3021 Brake Cooling Oil Temperature High on the AMW
AM-650 haul truck.
- Copilot: Copilot (Truck)
- Site: AZ Copper Works (prefix ACW)
- Keep the card generic to the AM-650: no unit numbers; note model-year differences
- Source: the attached handwritten tech notes and field log, July to September 2026
- Take the alarm text, set condition and response from the fault code reference in
  the attached AMW-SM-650-25 Service Manual, and cite the page
- Order the causes by how often each appears in the records
- Header: the attached AZ Machine Works logo

Review the card

Before you upload the card, check:

• Every page reads cleanly, no heading is stranded at the bottom of a page, and the card ID fits the header.
• Every field value appears in the source records, and every source ID on the card exists.
• Every value taken from the manual cites its page.
• The To be confirmed list names every gap, and who should close it.
• The settings file has InSkill GPT Answers, App and Web all on.

Upload to InSkill

Field cards are uploaded with InSkill GPT Answers, App and Web all on. With App and Web off, InSkill GPT still uses a card, but doesn't show it as a resource in the answer.

1. Open the copilot, here Copilot (Truck), and open its Resources tab.
2. Click Bulk Upload and add the PDF.
3. Under Configure defaults for uploaded files, leave Published on. Under Visibility, leave App, Web and InSkill GPT Answers selected. Under InSkill GPT, leave Searchable and Parse selected.
4. Click Create 1 Resources, then Done.
5. Open the new resource and set Name, Keywords and Description from the settings file. Leave Prompt empty. Click Save. See Editing Resource Attributes.

📘

Note

Claude can do step 5 for you through the InSkill MCP Server: ask it to apply the .inskill.json settings file to the uploaded resource.

In this example the resource name is Field Card (Alarm) | AM-3021 Brake cooling oil temperature high.

Test the card in Ask

Ask the example questions in Ask on the copilot and check the answers against the card.

Output Reference

Files

The skill writes two files for each card:

The skill writes the card in English, even when the source records are in another language. It writes another language version, for example ACW-AZMachineWorks-AM650-Truck-E-001-ES.pdf, only when you ask for one. On request, it also delivers a kit with the template, builder, content files and images, so the card can be rebuilt after edits.

Card ID

Every card ID follows the pattern <Site>-<Brand>-<Model>-<MachineType>-<Code>-<Number>, and each language version adds a suffix:

Value tags

Every value on the card is tagged so Technicians and InSkill GPT know how far to trust it:

Status, version and review

Settings file

The settings file for this Alarm Card:

{
  "card_id": "ACW-AZMachineWorks-AM650-Truck-E-001",
  "resource_title": "Field Card (Alarm) | AM-3021 Brake cooling oil temperature high",
  "language": "en",
  "base_language": "en",
  "is_base": true,
  "translation_group": "ACW-AZMachineWorks-AM650-Truck-E-001",
  "card_type": "alarm",
  "status": "field",
  "version": "0.1",
  "review_date": "2027-01-29",
  "owner": "To be assigned",
  "copilot": "Copilot (Truck)",
  "visibility": {"vis_mvn": true, "vis_web": true, "vis_app": true},
  "keywords": ["AM-3021", "brake cooling oil temperature high", "brake temp high", "hot brakes", "brake oil hot", "reduce speed select lower gear", "wet brakes", "retarder", "FLOAT detent", "EHL float", "hoist lever float", "TP-7", "brake cooling filter", "brake oil cooler", "cooler fins", "650-3310-00", "AM-650"],
  "mvn_desc": "AM-3021 Brake cooling oil temperature high. Alarm card for the AMW AM-650 rigid haul truck.",
  "source_entries": "E0007, E0013, E0018, E0023, E0027, E0031, E0033 (AZ Copper Works field log, Jul–Sep 2026, fictional demo data). Manuals: SM pp. 14, 33–34, 38; MP pp. 12, 35, 56. SM = AMW-SM-650-25 Rev. A Service Manual, MP = AMW-MP-650-25 Rev. A Maintenance and Parts Manual.",
  "file": "ACW-AZMachineWorks-AM650-Truck-E-001-EN.pdf"
}