A Claude Agent Skill that teaches Claude about the HL Connect API — Hal Leonard's platform for selling Hal Leonard digital products through your own online store.
With this skill installed, anyone integrating or evaluating HL Connect can ask questions in plain language and get accurate answers about the Catalog API, the asynchronous purchase/fulfillment flow, the vendor Dashboard, authentication and tokens, sandbox vs live environments, refunds/access revocation, and the official Python / JavaScript / PHP SDKs.
The skill stays current by re-checking the live OpenAPI schema (/doc/json) daily whenever an exact API detail is needed.
/plugin marketplace add HLConnect/hlconnect-skill
/plugin install hlconnect@hlconnect
Pull future updates with /plugin marketplace update.
Add this repository as a plugin marketplace, then enable the hlconnect skill. You can also download the skills/hlconnect folder and add it as a local skill.
- What HL Connect is and how the integration works
- How to import and sync the catalog (cursor pagination, history)
- The purchase flow: validate → register → poll → deliver → revoke
- Order statuses, error codes, and access lifecycle
- Dashboard usage: tokens, API explorer, order monitoring
- Environments (sandbox vs live) and authentication
- The official Python / JavaScript / PHP SDKs
.claude-plugin/marketplace.json # makes the repo installable as a plugin marketplace
skills/hlconnect/ # the skill
SKILL.md
reference/ # product + API knowledge
The OpenAPI schema is the source of truth, and the SDKs are generated from it. The skill caches the schema and re-fetches it when older than 24h before quoting an exact API detail. See skills/hlconnect/SKILL.md.