generated: '2026-09-04'
method: generated
source: >-
  Generated by API Evangelist from openapi/beacon-roofing-supply-all-api-openapi.yml (the only Beacon
  document that assigns operationIds) plus conventions/, errors/ and scopes/ in this repository. Every
  operationId referenced in every skill was verified present in that document on 2026-09-04. Beacon /
  QXO publishes no skills, no AGENTS.md and no llms.txt of its own — searched 2026-09-04.
specification: Agent Skills
specificationVersion: '0.1'
provider: Beacon Roofing Supply
providerId: beacon-roofing-supply
skill_count: 4
description: >-
  Packaged operating instructions for the four marquee flows of the Beacon Rest Services (Beacon PRO+,
  operated by QXO). Each skill is grounded in real, verified operationIds and carries the runtime rules
  an agent needs and the contract does not state — the missing idempotency, the absent order
  cancellation, the non-IANA 419 status, the overloaded 405, and the absence of any rate-limit signal.
skills:
  - name: beacon-order-materials
    file: beacon-roofing-supply-order-materials.md
    summary: >-
      Catalog search -> account pricing -> cart -> validate and review -> submit a material order.
      Carries the explicit warning that submission is irreversible and un-retryable.
    operations: 24
    write_surface: true
    risk: high
  - name: beacon-sync-catalog
    file: beacon-roofing-supply-sync-catalog.md
    summary: >-
      Bulk catalog / SKU / branch / availability extraction into an ERP or PIM via V3, including the
      Mincron ERP product mapping.
    operations: 7
    write_surface: false
    risk: low
  - name: beacon-track-orders
    file: beacon-roofing-supply-track-orders.md
    summary: >-
      Order history, order detail, delivery tracking, invoices and manufacturer rebates into a
      job-costing ledger. Read-only, and explains that there are no webhooks — everything is polled.
    operations: 14
    write_surface: false
    risk: low
  - name: beacon-authenticate
    file: beacon-roofing-supply-authenticate.md
    summary: >-
      OAuth refresh flow, the V1 cookie session, the apiSiteId multi-site selector, the permission
      model, and the 401-vs-419 distinction.
    operations: 9
    write_surface: false
    risk: low
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com