[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78F460TZMPWAHC35JJQRT08":3,"skill-same:01M78F460TZMPWAHC35JJQRT08":133},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M78F460TZMPWAHC35JJQRT08","ghl-memberships",null,"Build and operate GoHighLevel Memberships via the internal API — courses, chapters with drip\u002Fgating, lessons (text, video, audio, PDF, embed), quizzes with questions, assignments, offers, themes, credentials, enrollment, progress and submissions, plus community groups. Use when the user asks to build a GHL course or membership site, create an onboarding\u002Fclient portal, add quizzes or assignments, enroll or revoke a member, issue a certificate, collect learner-submitted documents, or read course progress.","uxieee\u002Fuxie-ghl-factory","uxieee","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F83715980?v=4","01M78F1K57TCCXME78DK6XTK6S","uxie","01M78F1K5WT9N3WHVE4N532ZWM",12,"MIT","https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: ghl-memberships\ndescription: Build and operate GoHighLevel Memberships via the internal API — courses, chapters with drip\u002Fgating, lessons (text, video, audio, PDF, embed), quizzes with questions, assignments, offers, themes, credentials, enrollment, progress and submissions, plus community groups. Use when the user asks to build a GHL course or membership site, create an onboarding\u002Fclient portal, add quizzes or assignments, enroll or revoke a member, issue a certificate, collect learner-submitted documents, or read course progress.\n---\n\n# GHL Memberships Builder\n\n> **MCP routing:** If the `uxie-ghl-internal-mcp` server is registered in this session, prefer its `build_course` \u002F `list_courses` tools over running this skill's scripts directly — the tools wrap this same engine behind confirmation gates and post-build verification. Fall back to this skill's own scripts when the server is not registered.\n\nWrites to a GHL account via the undocumented internal Memberships API.\n\n## Before any write\n1. Run BOTH gates in `${CLAUDE_PLUGIN_ROOT}\u002Fdocs\u002Fwrite-rails.md`.\n2. Auth: `${CLAUDE_PLUGIN_ROOT}\u002Fdocs\u002Fauth-jwt-capture.md` — **§8 is the Memberships section.**\n   The admin rail is §1 **plus a `sourceid` header**; the member rail is a different token class.\n   Memberships auth is **looser than the workflow builder** — no iframe origin, no `origin`\u002F`referer`.\n   Do not port the workflow CORS handling here.\n\n## Fastest path: compile a whole course from a spec\n\n```bash\nGHL_TOKEN='\u003CLC JWT>' GHL_LOC='\u003ClocationId>' \\\n  node ${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fghl-memberships\u002Fscripts\u002Fbuild-course.mjs \u003Cspec.json> [--dry-run]\n```\n\n`--dry-run` validates the spec without touching the account — **always run it first**.\nSpec format + a worked example: `references\u002Fexample-spec.json` and `references\u002Fcourse-spec.md`.\n\nOne command produces: course → chapters (order, drip, nesting, gating) → lessons (rich HTML body,\nvideo\u002Faudio upload, PDF attachments, external embeds) → quizzes **with questions** → assignments →\nfree offer (draft; published only when the spec says `publish: true`) → branded theme → credential template **attached to auto-issue on completion**\n→ optional enrollment. Then it verifies every item by read-back and prints a teardown command.\n\nRemove: `node scripts\u002Fbuild-course.mjs --delete \u003CproductId>`\n⚠️ **Offers and credential templates do NOT cascade** — delete those separately.\n\n## Prove the API hasn't drifted\n\n```bash\nGHL_TOKEN='\u003CLC JWT>' GHL_LOCATION='\u003ClocationId>' node ${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fghl-memberships\u002Fscripts\u002Fconformance.mjs\n```\n\nRuns the real admin lifecycle live and asserts on **effects, not status codes**\n(grant → member appears → revoke → member gone), re-checks the documented traps, and tears down.\n**21 passed \u002F 0 failed \u002F 4 skipped.** This is an undocumented API that drifts — run this before\ntrusting the reference on any account you haven't touched recently. The 4 skips are member-session\nwrites that cannot run unattended (see Limits).\n\n## Which rail, per job\n\nThe public Courses API (2026-09-24) returned the same courses as the internal rail on the sandbox (2026-10-29).\n\n\u003C!-- rail-ledger:courses -->\n_generated from the rail ledger (mcp-internal\u002Fcatalog\u002Frail-ledger.json) — do not edit; the whole ledger is `ghl-orientation\u002Freferences\u002Frail-ledger.md`._\n\n| Job | Decision | Routed today | Internal | Public |\n|---|---|---|---|---|\n| read | pool-internal | internal | `list_courses` | `courses-v3__list-courses`, `courses-v3__get-course`, `courses-v3__list-categories`, `courses-v3__list-lessons`, `courses-v3__get-lesson`, `courses-v3__list-offers` |\n| create | undecided | internal | `build_course` | `courses-v3__create-course`, `courses-v3__create-category`, `courses-v3__create-lesson`, `courses-v3__create-offer` |\n| edit | undecided | public | `raw_request:PUT \u002Fmembership\u002Flocations\u002F{locationId}\u002Fproducts\u002F{id}`, `raw_request:PUT \u002Fmembership\u002Flocations\u002F{locationId}\u002Fcategories\u002F{id}`, `raw_request:PUT \u002Fmembership\u002Flocations\u002F{locationId}\u002Fposts\u002F{postId}` | `courses-v3__update-course`, `courses-v3__update-category`, `courses-v3__update-lesson`, `courses-v3__sequence-categories`, `courses-v3__sequence-lessons`, `courses-v3__update-offer` |\n| delete | undecided | public | `raw_request:DELETE \u002Fmembership\u002Flocations\u002F{locationId}\u002Fproducts\u002F{id}`, `raw_request:DELETE \u002Fmembership\u002Flocations\u002F{locationId}\u002Fcategories\u002F{id}`, `raw_request:DELETE \u002Fmembership\u002Flocations\u002F{locationId}\u002Fposts\u002F{postId}` | `courses-v3__delete-course`, `courses-v3__delete-category`, `courses-v3__delete-lesson`, `courses-v3__delete-offer` |\n| enrol | undecided | internal | `raw_request:POST \u002Fmembership\u002Fsmart-list\u002Fattach-offer-user` | `courses-v3__create-enrollment`, `courses-v3__delete-enrollment` |\n| bulk | undecided | internal | `raw_request:POST \u002Fmembership\u002Flocations\u002F{locationId}\u002Fassessments\u002Fquiz\u002Fquestions` | `courses-v3__get-quiz-questions`, `courses-v3__upsert-quiz-questions` |\n| logs | undecided | internal | `raw_request:GET \u002Fmembership\u002Flocations\u002F{locationId}\u002Fproducts\u002Fuser-progress\u002F{productId}` | `courses-v3__list-bulk-progress`, `courses-v3__list-enrollments`, `courses-v3__review-assessment` |\n\n- **read:** The memberships skill builds and edits on the internal rail; the public Courses API (2026-09-24) has not been proven on our sandbox yet.\n- **create:** The memberships skill builds and edits on the internal rail; the public Courses API (2026-09-24) has not been proven on our sandbox yet.\n- **edit:** D3 (Xander, 2026-11-06): course editing and deletion are public-only. Sequence and delete were ruled pool-public (orchestrator DECISION, w8-1); the public proofs are in [private capture] and delete.json. The tools below are the internal paths the ruling retires.\n- **delete:** D3 (Xander, 2026-11-06): course editing and deletion are public-only. Sequence and delete were ruled pool-public (orchestrator DECISION, w8-1); the public proofs are in [private capture] and delete.json. The tools below are the internal paths the ruling retires.\n- **enrol:** The memberships skill builds and edits on the internal rail; the public Courses API (2026-09-24) has not been proven on our sandbox yet.\n- **bulk:** The public upsert replaces every question and drops option text (sandbox 2026-11-06); the internal batch add is the one proven on the build path.\n- **logs:** Not run on either rail: needs an enrolled learner and a submission (G4). Grading is observed only in the engine.\n\nInternal only: media, DRM, themes; clone; certificates; analytics.\nPublic only: synchronous enrolment that says alreadyEnrolled; progress and review; import.\n\u003C!-- \u002Frail-ledger:courses -->\n\n## Object model\n\n```\nProduct (course) → Category (chapter, self-nesting) → Post (lesson)\nOffer   = access gate        Theme = per-product design tokens\nCredential template + attachment = certificate\u002Fbadge, auto-issued on completion\n```\n\nA post carries rich-HTML `description` (the body) + ONE primary media + N `post_materials`.\n\n## Engine API (prefer this over hand-rolling requests)\n\n| Module | Use for |\n|---|---|\n| `engine\u002Fapi.mjs` | products, categories, posts, video\u002Faudio upload, PDF materials, offers, theme, `setEmbed`, `parseIframe` |\n| `engine\u002Fmembers.mjs` | invite, magicLink, **grantOffer\u002FrevokeOffer**, publishOffer, productProgress, allMembers, waitForEnrollment |\n| `engine\u002Fassessments.mjs` | quiz + **addQuestions**, assignments, listSubmissions, **grade** |\n| `engine\u002Fcredentials.mjs` | template CRUD, **issue**, listIssued, **attach** (auto-issue on completion) |\n| `engine\u002Fcommunities.mjs` | admin group CRUD + `CommunitiesMember` (portal rail: join, createPost) |\n\n## Traps that will cost you hours\n\n1. **`contentType` is a CLOSED MySQL ENUM: `video | audio | quiz | assignment` — or OMIT it.**\n   GHL has no `text` lesson type. A text lesson is a `video`-typed post with the text in its description: send\n   `contentType: 'video'` explicitly and put the text in `description`. Do not read a `video` read-back on a text\n   lesson as a bug. `text`\u002F`embed`\u002F`html`\u002F`pdf`\u002F`file`\u002F`link` all return\n   `500 Data truncated for column 'content_type'`. There is no embed or PDF *lesson type*.\n2. **Embeds: `POST \u002Fposts` SILENTLY DROPS `embedJson`.** It returns 200 and the embed is simply\n   absent on read-back. **Create the post, then PUT it** (`api.setEmbed()`). The server mints\n   `metaData.embedMediaId` itself — you never create that id, which is why no \"embed media\"\n   endpoint exists.\n3. **`quizId !== postId`.** `POST \u002Fassessments\u002Fquiz` creates it; re-read via\n   `getQuizByPost(postId)` to get the quiz's own id, which is what the questions endpoint wants.\n4. **Auto-issue a certificate is a course-level ATTACHMENT**, not a field on the lesson\n   (`credentials.attach()` → `certificate-attachments`, `eventType: product_complete`).\n5. **The category tree is a PARTIAL projection** — `GET \u002Fcategories?posts=true` omits\n   `post_materials` and `asset_urls`. Verify lessons with `GET \u002Fposts\u002F{id}` or you get false negatives.\n6. **Theme needs TWO calls**: PUT the theme, then PUT `products\u002Fapply-theme` — saving alone does nothing.\n7. **`user-purchase\u002Fno-of-users` lies about enrollment** — it counts purchases, returns 0 for an\n   admin-attached member. Verify with `products\u002Fuser-progress`.\n7b. **The grant's own 200 lies too, and it is the worse of the two.**\n   `POST \u002Fmembership\u002Fsmart-list\u002Fattach-offer-user` answers\n   `200 {ok:true, msg:\"…successfully queued\"}` for an **empty body**, for fabricated ids, and for\n   the wrong key names — proven on the test sub-account, with a nonexistent sibling path answering\n   404 as the control. Two operators have been told a grant was queued and granted nothing. The\n   body is `{contactId, offerId, source:'admin'}` — **singular `contactId`, no `locationId`** (that\n   rides on the `sourceid` header). Then read back: `members.waitForEnrollment(productId,\n   {expectContactIds})`, which looks for **those contacts**. A non-empty check is not a check —\n   it passes on a member who was already there.\n8. **Deletes don't cascade to offers, credential templates, or assessment submissions.**\n   Submissions have no delete route at all.\n9. **assets-drm wants a LEADING SLASH** on the `path` that `signed-url\u002Fupload` returns without.\n   Client supplies `durationInSeconds` (ffprobe).\n10. **Community group list reads are eventually consistent (~1.5 s)** — don't assert a write failed\n    on one immediate re-read.\n11. **A UI Save that \"fires no request\" is usually a lie.** Twice on this surface it was a\n    product-tour overlay (`fd-tour-overlay`, Pendo `#pendo-base`) swallowing the click, or a\n    too-narrow network filter — GHL splits one feature's read and write across `membership\u002F`,\n    `courses\u002F`, `services\u002F` and `clientportal-middleware\u002F`. Re-check with a **host-level** filter\n    before concluding a flow is client-side.\n12. **`createGroup` sends `marketplaceLocationId` (the UI's Discovery switch ON) unless `discovery: false`** (2026-10\n    switch, default ON as in the UI; OFF omits the key — that the group then stays off the marketplace is the switch's\n    stated purpose, not separately observed). Ask the operator which they want for a private client community.\n13. **Moderation keywords live on the ADMIN rail too** — group rows carry `settings.moderationSettings.blockedKeywords`\n    and the admin group PUT writes them (the portal read then shows them, proven 2026-10-30). Read the row and send\n    `settings` back whole with your change. Owner and admin posts are **never held**, so testing a keyword as the\n    owner proves nothing; the held queue and member reports are portal-only (403).\n14. **Notification preferences are one document per member per group**; the portal UI's save also turns the\n    member's `newsletter` push OFF (no push control on that row) — do not copy the UI's body.\n\n## Proof levels — know what you're trusting\n\n- **EXECUTED** (built and sent from code, effect asserted): everything the conformance suite covers,\n  plus contacts, media rails, themes, embeds, credential attach.\n- **OBSERVED only** (transcribed from the UI, never re-issued independently): `assessments.grade()`,\n  learner submission, `user-post-completion`. All member-session-bound; each was driven live through\n  the real portal and verified by read-back, but a field the UI sends and we failed to record would\n  only surface on first use. `grade()` is marked in-source.\n\n## Limits (state these rather than working around them)\n\n- **Paid offers are supported by the engine but need a connected payment integration** (bl-877). On a sandbox with none, a paid create returns `400 Integrations not found`. The enum is `onetime` (or `subscription`); `one_time` and `recurring` return 500. Checkout is unproven. Only `free` is proven end to end.\n- **Members cannot be fully provisioned headlessly** — portal signup is OTP-gated. See auth §8.3 for\n  the softer path (the user record exists before OTP verification).\n- **Whether the credential attachment FIRES on completion is unverified** — it's created and reads\n  `status: active`, but no member has completed a course to watch it issue.\n- **Module-level credential attachment** (`altType: \"category\"`) is implied by the response shape,\n  not verified — `attach()` only exposes product level.\n- Community channel create\u002Fupdate, and pending-invite list\u002Frevoke (403), are uncaptured.\n\n## Editing a course (public rail, ghl-multi)\n\nCourse editing is **public-only** (Xander, D3, 2026-11-06). Use `execute_action` on the ghl-multi server with these action ids. Every\nwrite takes `dry_run: true` first; read the preview; then send the same call with `confirm: true` where the server asks.\nAfter every write, read the course back with the internal `get_course` (one read: title, offers, normalised tree) and compare.\n\n| Job | Action | Notes |\n|---|---|---|\n| change a lesson | `courses-v3__update-lesson` `{productId, lessonId, …fields}` | partial body: only the fields you send change (measured 2026-11-06) |\n| change a chapter | `courses-v3__update-category` `{productId, categoryId, …fields}` | partial body (measured) |\n| change the course | `courses-v3__update-course` `{productId, …fields}` | partial body (measured) |\n| reorder chapters | `courses-v3__sequence-categories` `{productId, ids}` | `ids` lists every chapter in order (measured) |\n| reorder lessons in a chapter | `courses-v3__sequence-lessons` `{productId, categoryId, ids}` | `ids` lists every lesson of that chapter in order (measured) |\n| move a lesson to another chapter | `courses-v3__update-lesson` with `categoryId`, then `sequence-lessons` on the new chapter | two calls, see trap 3 |\n| remove a lesson | `courses-v3__delete-lesson` `{productId, lessonId}` | 204; the lesson then 404s (measured) |\n| remove a chapter | `courses-v3__delete-category` `{productId, categoryId}` | **cascades**: its lessons go with it (trap 2) |\n| remove a course | `courses-v3__delete-course` `{productId}` | 204 (measured on a probe product) |\n| add a lesson or chapter | `courses-v3__create-lesson` \u002F `courses-v3__create-category` | create as `visibility: \"draft\"` unless the user has asked to publish |\n\nTraps (the first three are measured on the sandbox; the rest are from the same runs):\n\n1. **A reorder that names only some lessons is not measured.** Always send every lesson of the chapter in `ids`. What the server\n   does with unnamed lessons is unknown, so do not rely on them keeping their place.\n2. **Deleting a chapter deletes its lessons.** Before `delete-category`, list the chapter's lessons (`get_course`) and say so to\n   the user. The internal route also cascades (measured), so this is not a rail difference.\n3. **A cross-chapter move is two writes, and the lesson keeps its old number.** `update-lesson` with `categoryId` moves the\n   lesson but does not renumber it (measured). Follow it with `sequence-lessons` on the new chapter, naming every lesson in order,\n   or the moved lesson can collide with an existing number.\n4. **Do not use the internal whole-document PUT for these edits.** The internal routes take the full object (the engine sends it\n   whole), so an edit there is a read-modify-write of the whole object. The public routes merge a partial body (measured).\n5. **Deleting an offer reads back as a ghost.** `courses-v3__delete-offer` returns 204, but a later `get-offer` returns 200\n   with an empty body. Verify an offer removal with `get_course` (the offers list), not with `get-offer` (bl-801).\n6. **Do not use `courses-v3__upsert-quiz-questions` to edit questions.** It replaces the whole question set (measured: two\n   questions gone when one was sent) and the option text is not read back. To add questions, use `edit_quiz_questions` (below).\n7. **Gated, do not run without the owner's go:** publishing a course, chapter, lesson, offer or channel (the spec's `visibility:\n   \"published\"` or any `*-publish`); any paid offer; any enrolment or grant that e-mails a member (G4). A dry run of these is fine.\n\n## Granting and revoking access\n\n- Internal: `set_course_access {locationId, contactId, offerId, action: grant|revoke, confirm}`. Preview first (no account call; `sends` says\n  whether a grant e-mails the member: `unknown` for a grant, not yet measured; `false` for a revoke). Confirmed, it reads the course membership, sends\n  the change, reads it again, and reports `granted`, `already-had`, `revoked`, `already-absent` or `queued-unconfirmed`. Trust the outcome, never the 200.\n- Public: `courses-v3__create-enrollment` (201 new, 200 `alreadyEnrolled`), `courses-v3__delete-enrollment` (revoke), `courses-v3__list-enrollments` (read back).\n- **A draft offer still grants access.** A public enrol into a free draft offer answered 201 and read back (bl-833). Do not treat an offer's draft\n  status as a guard. Never put anything confidential in an offer, and treat its id as public (an unauthenticated GET of `\u002Fmembership\u002Foffers\u002F{id}`\n  returns the draft, with the location and feature flags, bl-321).\n- A grant or enrol may e-mail the member. Every send is a gated action (G4) for a real student. Check the preview `sends` before confirming.\n\n## Progress and completion\n\n- Internal: `get_course_progress {locationId, courseId, email?}` walks every page and returns each student's course percent (`completedPercentage`),\n  the user's e-mail and `lastLogin`, plus a per-course summary. `complete: false` (with `failure`) means the walk did not finish: do not read a\n  partial list as the whole course. The internal route gives **no lesson counts**, so `completedLessons` is null there.\n- `lastActivity` on that tool is the last **login**, not the last lesson. Do not read it as lesson activity.\n- Public (ghl-multi): `courses-v3__list-bulk-progress {contactId, productIds}` returns `totalLessons` and `completedLessons` for a student, and\n  `courses-v3__list-category-progress` and `courses-v3__list-completions` give per-chapter progress and completions.\n- **Caveat (bl-834):** on the sandbox the public bulk route returned `totalLessons: 0` for a student on a course with 6 lessons. The likely cause is that\n  the lessons were draft (a count of published lessons only). This is untested: it needs a published lesson, which is a gated publish. Until it is settled,\n  do not trust a `0\u002F0` lesson count without checking the lessons' visibility first.\n\n## Quiz questions and grading\n\n- **Add questions in a batch:** `edit_quiz_questions {locationId, quizId, add: [{title, questionType, explanation?, options: [{statement, isCorrect}]}], confirm?}`.\n  `quizId` is the **quiz** id (the one `GET …\u002Fassessments\u002Fquiz\u002F{postId}` returns), not the lesson id. Preview first (no write). A single-choice question\n  needs exactly one correct option; duplicate question text in one batch is refused before anything is sent.\n- **The batch write replaces the whole question set** (measured on the sandbox, 2026-11-07: a one-question add to a quiz holding one question left two,\n  and the stored one was gone). So a confirmed `edit_quiz_questions` re-posts every stored question in full, then the additions, and it is refused\n  before any POST when a stored question's option text cannot be read. It reads the quiz again on a separate request and reports `added` only when that\n  read matches the expected set by content (question ids change on every save, so they are not compared, and a question id kept from before an edit is stale); otherwise `unverified`, with the full before list. A failed batch POST is read back the same way (the route replaces, so a failed POST may still have changed the set): the result carries `postFailed` with the HTTP status, and the after read.\n  Its `replace` argument is refused. Do not reach for `upsert-quiz-questions` (trap 6).\n- **Grade a submission (public):** `courses-v3__list-assessments {productId, status?, pageSize?, pageNumber?}`, `courses-v3__get-assessment {productId,\n  assessmentId}`, and `courses-v3__review-assessment` (PUT) with body `{status: passed | failed | processing, score?, feedback?}`. A grade is visible to\n  the learner. Only a submitted attempt can be graded, so the grading route needs a learner who has submitted in the portal.\n- **Not exposed:** the internal `Assessments.grade()` is observed only (transcribed from the admin UI) and needs a member session. Do not present it as a tool.\n- **Not yet proven on the sandbox:** a learner's quiz or assignment submission and its grade. That leg needs a portal session and is tracked on the\n  backlog (bl-842), not run in this build.\n\n## Communities: paid channels and plans (know about)\n\n- Announced 2026-11-02: **paid channels** and **multiple pricing plans** in Communities. Nothing here reads a paid flag, a plan or a price: the admin rail's group and location records carry no such key, and channel paid flags sit behind the PORTAL_USER scope.\n- **Every write is unproven.** Creating a paid channel, creating or editing a pricing plan, and connecting a payment provider for Communities are all paid actions and gated. Do not run them to \"test\" the route.\n- Know-about only: which surface shows what, and what is still open, is in the corpus page `70-research\u002F2026-11-06-communities-paid-channels-and-know-about.md`.\n- Course video analytics and the Discover Courses & Offers storefront have no route taught here; the courses analytics routes in the endpoint index are proven for dashboards, not for video watch data.\n\n## Routes with a proven raw_request write (settings, CSS and code, instructor fields, portal users)\n\nThese operations have no typed tool. Each one was proven on the sandbox (the write, then a read on a separate request, then a restore), so the\nroute and body shape below are evidence, not a guess. Send them with `raw_request {locationId, method, path, body, confirm: true}`. Preview first\nwhere the tool offers it, and never send a body whose keys you have not read first: several of these writes replace the whole object.\n\n- **Course CSS, custom code and header\u002Ffooter (product document):** `PUT \u002Fmembership\u002Flocations\u002F{locationId}\u002Fproducts\u002F{productId}` with the FULL product\n  object (read it with `GET` on the same path first). The custom fields are `customCss`, `customJs`, `customHeader`, `customFooter`. Proven: set to a TEST\n  value, read back on a separate GET, restored to `null`. Clearing a field back to `null` works; an empty string is not the same and is not used.\n- **Instructor name, title, bio and heading (customization):** `PUT \u002Fmembership\u002Flocations\u002F{locationId}\u002Fproducts\u002Fcustomizations\u002F{customizationId}`, with\n  the customization record read first (`GET \u002Fmembership\u002Flocations\u002F{locationId}\u002Fproducts\u002F{productId}`, the `customizations` block). Proven: name, title and\n  bio set and read back, the heading read back unchanged, then restored.\n- **Portal settings (portal banner text, app permissions, and the other portal-settings keys):** `PUT \u002Fclientclub\u002Fportal-settings\u002F{locationId}` with the\n  full document. The keys the GET carries must equal the read value, except the one test field. Keys the GET does not carry are sent only as the form's\n  own defaults. Proven for `portalBannerText` and for app permissions: set, read back on a separate GET, restored. Once a portal name is set the UI\n  cannot clear it (an empty name is refused before any request), so a name is a one-way write on a sandbox.\n- **Invite a user to the client portal:** `POST \u002Fclientclub\u002F{locationId}\u002Fusers\u002Finvite` with `{locationId, email: [address]}`; returns `201` with `{success: true}`. Proven: the portal settings read (`invitedUsers`) went from absent to a count of 1 on two separate reads after the invite. The invite e-mails the address: send it only with an approval that names the address, and read the user back afterwards.\n- **Course delete (irreversible; deletes the object):** `DELETE \u002Fmembership\u002Flocations\u002F{locationId}\u002Fproducts\u002F{id}`. It deletes the course. Deleting a product does not delete its offers, so clean up the offers separately. Proven: the course is gone from the list on a separate read after the delete. Delete only a TEST-CONF course you created for the test.\n- **Offer delete (accepted, not applied):** `DELETE \u002Fmembership\u002Flocations\u002F{locationId}\u002Foffers\u002F{id}` returns 200 `{ok:1}`, but the offer stays on the product record on a separate read (the course Offers list shows nothing). Do not rely on it to delete an offer: the delete is accepted but not applied, the same finding as the public delete-offer route.\n- **Course comment (edit and delete):** `PUT \u002Fmembership\u002Flocations\u002F{locationId}\u002Fcomments\u002F{commentId}` edits a comment; `DELETE \u002Fmembership\u002Flocations\u002F{locationId}\u002Fcomments\u002F{commentId}` removes it. Read the comment first with `GET` on the same path and send the full object on the PUT. Proven: set and read back on a separate GET, then restored.\n- **Lesson video (upload, then attach):** the assets-drm upload first (`POST \u002Fassets-drm\u002Fassets\u002Fsigned-url\u002Fupload` with `{source:\"courses\", entityId:\"{locationId}\", type:\"videos\", mimeType:\"video\u002Fmp4\"}`, then `PUT` the raw bytes to the signed URL, then `POST \u002Fassets-drm\u002Fassets` for the `assetsLicenseId`). Then `POST \u002Fmembership\u002Flocations\u002F{locationId}\u002Fvideos` with `{url, title, postId:\"{lessonId}\", assetsLicenseId, id}`. Note: the `path` returned by the upload needs a leading slash before the assets call.\n- **Course theme (save, then apply):** `PUT \u002Fcourses\u002Flocations\u002F{locationId}\u002Fproduct-themes\u002F{productId}\u002Ftheme\u002F{themeId}` saves the full `themeData` tree. Without the next step the course keeps its old theme: `PUT \u002Fmembership\u002Flocations\u002F{locationId}\u002Fproducts\u002Fapply-theme\u002F{productId}?template_id=NeoClassic` (empty body) applies it. Proven: the UI save and the apply both returned 200; a replay of the theme save (weight bold, read back on a separate GET, then restored) was read back; the product customization was unchanged after the apply.\n- **Community group (create):** `POST \u002Fcommunities\u002F{locationId}\u002Fgroups` with `{name, slug, description, locationId, marketplaceLocationId, branding:{}}` returns 201. Creating a group does not list it on the Gokollab marketplace: the listing is a separate outward step and is not done here.\n- **Portal notification preference (toggle, saves on change):** `POST \u002Fclientclub\u002Fnotification-preferences\u002F{locationId}` with `{category, notifications:{EXPIRE_CERTIFICATE:{config:{email, sms}, email_template}}, locationId}`; returns `201`. The page has no save button: unchecking sends the POST. Read the current value first on the page (the GET behind the page is not in the catalogue, so this row does not name it). Proven: the page read (200), the change (201), and the restore (201, same route, email set back to 1).\n- **Member grade (assignment review):** `PUT \u002Fcourses\u002Flocations\u002F{locationId}\u002Fassessments\u002F{submissionId}\u002Freview` with `{score, status:\"passed\"|\"failed\", feedback}`; returns `200` with `{error:false, updated:true}`. Note the `\u002Fcourses` path, not `\u002Fmembership`. Proven: the grade save returned 200, and an admin read of the same submission on a separate request showed it.\n- **Course site details (title and the site-info save):** `PUT \u002Fmembership\u002Flocations\u002F{locationId}\u002Fsettings\u002Fsite-info\u002F{siteInfoId}` carries the title. Proven: the title was set to a TEST value and read back on a separate GET, then restored to empty and read back. The same restore save also sent `PUT \u002Fmembership\u002Flocations\u002F{locationId}\u002Fsettings\u002Fdomain\u002F{id}` and `PUT ...\u002Fsettings\u002Fbuilder-settings\u002F{id}` with their values unchanged (200 each); those two routes are not proven as writes.\n- **Course duplicate (clone; leaves a new course):** `POST \u002Fmembership\u002Flocations\u002F{locationId}\u002Fproducts\u002Fclone\u002F{productId}` with `{locations: [locationId]}` returns the new `productIds`. Proven: the clone was read back on a separate GET (its title carried the \"- Clone\" suffix). The clone is a new course, so it stays as residue on a sandbox; delete it only by its own id.\nNot covered here: the course analytics dashboards (their data comes from read-only summary queries that the catalogue does not carry yet), the course\nanalytics progress view (no proven write), and learner-side rendering. Those stay as the corpus describes them.\n\n## Credential templates (certificates): list, create, designer save, delete\n\nProven on the sandbox with a read on a separate request after each write. The template is the credential's design; a credential is issued from it.\n\n- **List templates:** `GET \u002Fcertificates\u002Flocations\u002F{locationId}\u002Ftemplates` → `{templates: [{_id, title, ...}]}`.\n- **Create a template:** `POST \u002Fcertificates\u002Flocations\u002F{locationId}\u002Ftemplates` with `{title, ...}`, `confirm: true`. Returns `201`. Read it back on a separate\n  list GET (`_id` and `title`). Create only with an explicit approval naming the type. A created template stays as residue unless it is deleted with the route below.\n- **Designer save (title and canvas fields):** `PATCH \u002Fcertificates\u002Flocations\u002F{locationId}\u002Ftemplates\u002F{templateId}` with `{locationId, title, ...}`; send the body keys you change.\n  Proven: the title change read back on a separate list GET. Rules measured on the sandbox: the endpoint refuses an empty `title` (send the unchanged\n  title with every PATCH); the merge keeps keys you omit; the designer's `templateJson` cannot be cleared back to an empty string through this route\n  (a restore to `\"\"` is stored as the two-character string `\"\"`, not the empty value). Read the template first and send the exact before value for any\n  key you restore.\n- **Delete a template:** `DELETE \u002Fcertificates\u002Flocations\u002F{locationId}\u002Ftemplates\u002F{templateId}`, with confirm. It returns `200` with\n  `type: TEMPLATE_DELETED`. Read back on a separate list GET: the id is gone. Delete only a template you created for the test, by its own id.\n\n## Full reference\n\n`references\u002Fcourse-spec.md` — spec format.\nSemantics and capture evidence: the corpus surface `knowledge\u002Fcorpus\u002Fmemberships-courses\u002F`, the\nsource of truth for anything this file summarises. The **endpoint index** is `search_endpoints`\non the internal MCP: every `\u002Fmembership\u002F*`, `\u002Fcourses\u002F*`, `\u002Fcertificates\u002F*` and `\u002Fclientclub\u002F*`\nroute, mined from the memberships front-end's own source — most never exercised here.\n`describe_endpoint` gives the exact `raw_request`, and `raw_request` sends the `sourceid` this\nsurface's front-end pins. The engine modules above remain the way to WRITE: a catalogued route is\na path, not a proven write.\n","# GHL Memberships Builder\n\n> **MCP routing:** If the `uxie-ghl-internal-mcp` server is registered in this session, prefer its `build_course` \u002F `list_courses` tools over running this skill's scripts directly — the tools wrap this same engine behind confirmation gates and post-build verification. Fall back to this skill's own scripts when the server is not registered.\n\nWrites to a GHL account via the undocumented internal Memberships API.\n\n## Before any write\n1. Run BOTH gates in `${CLAUDE_PLUGIN_ROOT}\u002Fdocs\u002Fwrite-rails.md`.\n2. Auth: `${CLAUDE_PLUGIN_ROOT}\u002Fdocs\u002Fauth-jwt-capture.md` — **§8 is the Memberships section.**\n   The admin rail is §1 **plus a `sourceid` header**; the member rail is a different token class.\n   Memberships auth is **looser than the workflow builder** — no iframe origin, no `origin`\u002F`referer`.\n   Do not port the workflow CORS handling here.\n\n## Fastest path: compile a whole course from a spec\n\n```bash\nGHL_TOKEN='\u003CLC JWT>' GHL_LOC='\u003ClocationId>' \\\n  node ${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fghl-memberships\u002Fscripts\u002Fbuild-course.mjs \u003Cspec.json> [--dry-run]\n```\n\n`--dry-run` validates the spec without touching the account — **always run it first**.\nSpec format + a worked example: `references\u002Fexample-spec.json` and `references\u002Fcourse-spec.md`.\n\nOne command produces: course → chapters (order, drip, nesting, gating) → lessons (rich HTML body,\nvideo\u002Faudio upload, PDF attachments, external embeds) → quizzes **with questions** → assignments →\nfree offer (draft; published only when the spec says `publish: true`) → branded theme → credential template **attached to auto-issue on completion**\n→ optional enrollment. Then it verifies every item by read-back and prints a teardown command.\n\nRemove: `node scripts\u002Fbuild-course.mjs --delete \u003CproductId>`\n⚠️ **Offers and credential templates do NOT cascade** — delete those separately.\n\n## Prove the API hasn't drifted\n\n```bash\nGHL_TOKEN='\u003CLC JWT>' GHL_LOCATION='\u003ClocationId>' node ${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fghl-memberships\u002Fscripts\u002Fconformance.mjs\n```\n\nRuns the real admin lifecycle live and asserts on **effects, not status codes**\n(grant → member appears → revoke → member gone), re-checks the documented traps, and tears down.\n**21 passed \u002F 0 failed \u002F 4 skipped.** This is an undocumented API that drifts — run this before\ntrusting the reference on any account you haven't touched recently. The 4 skips are member-session\nwrites that cannot run unattended (see Limits).\n\n## Which rail, per job\n\nThe public Courses API (2026-09-24) returned the same courses as the internal rail on the sandbox (2026-10-29).\n\n\u003C!-- rail-ledger:courses -->\n_generated from the rail ledger (mcp-internal\u002Fcatalog\u002Frail-ledger.json) — do not edit; the whole ledger is `ghl-orientation\u002Freferences\u002Frail-ledger.md`._\n\n| Job | Decision | Routed today | Internal | Public |\n|---|---|---|---|---|\n| read | pool-internal | internal | `list_courses` | `courses-v3__list-courses`, `courses-v3__get-course`, `courses-v3__list-categories`, `courses-v3__list-lessons`, `courses-v3__get-lesson`, `courses-v3__list-offers` |\n| create | undecided | internal | `build_course` | `courses-v3__create-course`, `courses-v3__create-category`, `courses-v3__create-lesson`, `courses-v3__create-offer` |\n| edit | undecided | public | `raw_request:PUT \u002Fmembership\u002Flocations\u002F{locationId}\u002Fproducts\u002F{id}`, `raw_request:PUT \u002Fmembership\u002Flocations\u002F{locationId}\u002Fcategories\u002F{id}`, `raw_request:PUT \u002Fmembership\u002Flocations\u002F{locationId}\u002Fposts\u002F{postId}` | `courses-v3__update-course`, `courses-v3__update-category`, `courses-v3__update-lesson`, `courses-v3__sequence-categories`, `courses-v3__sequence-lessons`, `courses-v3__update-offer` |\n| delete | undecided | public | `raw_request:DELETE \u002Fmembership\u002Flocations\u002F{locationId}\u002Fproducts\u002F{id}`, `raw_request:DELETE \u002Fmembership\u002Flocations\u002F{locationId}\u002Fcategories\u002F{id}`, `raw_request:DELETE \u002Fmembership\u002Flocations\u002F{locationId}\u002Fposts\u002F{postId}` | `courses-v3__delete-course`, `courses-v3__delete-category`, `courses-v3__delete-lesson`, `courses-v3__delete-offer` |\n| enrol | undecided | internal | `raw_request:POST \u002Fmembership\u002Fsmart-list\u002Fattach-offer-user` | `courses-v3__create-enrollment`, `courses-v3__delete-enrollment` |\n| bulk | undecided | internal | `raw_request:POST \u002Fmembership\u002Flocations\u002F{locationId}\u002Fassessments\u002Fquiz\u002Fquestions` | `courses-v3__get-quiz-questions`, `courses-v3__upsert-quiz-questions` |\n| logs | undecided | internal | `raw_request:GET \u002Fmembership\u002Flocations\u002F{locationId}\u002Fproducts\u002Fuser-progress\u002F{productId}` | `courses-v3__list-bulk-progress`, `courses-v3__list-enrollments`, `courses-v3__review-assessment` |\n\n- **read:** The memberships skill builds and edits on the internal rail; the public Courses API (2026-09-24) has not been proven on our sandbox yet.\n- **create:** The memberships skill builds and edits on the internal rail; the public Courses API (2026-09-24) has not been proven on our sandbox yet.\n- **edit:** D3 (Xander, 2026-11-06): course editing and deletion are public-only. Sequence and delete were ruled pool-public (orchestrator DECISION, w8-1); the public proofs are in [private capture] and delete.json. The tools below are the internal paths the ruling retires.\n- **delete:** D3 (Xander, 2026-11-06): course editing and deletion are public-only. Sequence and delete were ruled pool-public (orchestrator DECISION, w8-1); the public proofs are in [private capture] and delete.json. The tools below are the internal paths the ruling retires.\n- **enrol:** The memberships skill builds and edits on the internal rail; the public Courses API (2026-09-24) has not been proven on our sandbox yet.\n- **bulk:** The public upsert replaces every question and drops option text (sandbox 2026-11-06); the internal batch add is the one proven on the build path.\n- **logs:** Not run on either rail: needs an enrolled learner and a submission (G4). Grading is observed only in the engine.\n\nInternal only: media, DRM, themes; clone; certificates; analytics.\nPublic only: synchronous enrolment that says alreadyEnrolled; progress and review; import.\n\u003C!-- \u002Frail-ledger:courses -->\n\n## Object model\n\n```\nProduct (course) → Category (chapter, self-nesting) → Post (lesson)\nOffer   = access gate        Theme = per-product design tokens\nCredential template + attachment = certificate\u002Fbadge, auto-issued on completion\n```\n\nA post carries rich-HTML `description` (the body) + ONE primary media + N `post_materials`.\n\n## Engine API (prefer this over hand-rolling requests)\n\n| Module | Use for |\n|---|---|\n| `engine\u002Fapi.mjs` | products, categories, posts, video\u002Faudio upload, PDF materials, offers, theme, `setEmbed`, `parseIframe` |\n| `engine\u002Fmembers.mjs` | invite, magicLink, **grantOffer\u002FrevokeOffer**, publishOffer, productProgress, allMembers, waitForEnrollment |\n| `engine\u002Fassessments.mjs` | quiz + **addQuestions**, assignments, listSubmissions, **grade** |\n| `engine\u002Fcredentials.mjs` | template CRUD, **issue**, listIssued, **attach** (auto-issue on completion) |\n| `engine\u002Fcommunities.mjs` | admin group CRUD + `CommunitiesMember` (portal rail: join, createPost) |\n\n## Traps that will cost you hours\n\n1. **`contentType` is a CLOSED MySQL ENUM: `video | audio | quiz | assignment` — or OMIT it.**\n   GHL has no `text` lesson type. A text lesson is a `video`-typed post with the text in its description: send\n   `contentType: 'video'` explicitly and put the text in `description`. Do not read a `video` read-back on a text\n   lesson as a bug. `text`\u002F`embed`\u002F`html`\u002F`pdf`\u002F`file`\u002F`link` all return\n   `500 Data truncated for column 'content_type'`. There is no embed or PDF *lesson type*.\n2. **Embeds: `POST \u002Fposts` SILENTLY DROPS `embedJson`.** It returns 200 and the embed is simply\n   absent on read-back. **Create the post, then PUT it** (`api.setEmbed()`). The server mints\n   `metaData.embedMediaId` itself — you never create that id, which is why no \"embed media\"\n   endpoint exists.\n3. **`quizId !== postId`.** `POST \u002Fassessments\u002Fquiz` creates it; re-read via\n   `getQuizByPost(postId)` to get the quiz's own id, which is what the questions endpoint wants.\n4. **Auto-issue a certificate is a course-level ATTACHMENT**, not a field on the lesson\n   (`credentials.attach()` → `certificate-attachments`, `eventType: product_complete`).\n5. **The category tree is a PARTIAL projection** — `GET \u002Fcategories?posts=true` omits\n   `post_materials` and `asset_urls`. Verify lessons with `GET \u002Fposts\u002F{id}` or you get false negatives.\n6. **Theme needs TWO calls**: PUT the theme, then PUT `products\u002Fapply-theme` — saving alone does nothing.\n7. **`user-purchase\u002Fno-of-users` lies about enrollment** — it counts purchases, returns 0 for an\n   admin-attached member. Verify with `products\u002Fuser-progress`.\n7b. **The grant's own 200 lies too, and it is the worse of the two.**\n   `POST \u002Fmembership\u002Fsmart-list\u002Fattach-offer-user` answers\n   `200 {ok:true, msg:\"…successfully queued\"}` for an **empty body**, for fabricated ids, and for\n   the wrong key names — proven on the test sub-account, with a nonexistent sibling path answering\n   404 as the control. Two operators have been told a grant was queued and granted nothing. The\n   body is `{contactId, offerId, source:'admin'}` — **singular `contactId`, no `locationId`** (that\n   rides on the `sourceid` header). Then read back: `members.waitForEnrollment(productId,\n   {expectContactIds})`, which looks for **those contacts**. A non-empty check is not a check —\n   it passes on a member who was already there.\n8. **Deletes don't cascade to offers, credential templates, or assessment submissions.**\n   Submissions have no delete route at all.\n9. **assets-drm wants a LEADING SLASH** on the `path` that `signed-url\u002Fupload` returns without.\n   Client supplies `durationInSeconds` (ffprobe).\n10. **Community group list reads are eventually consistent (~1.5 s)** — don't assert a write failed\n    on one immediate re-read.\n11. **A UI Save that \"fires no request\" is usually a lie.** Twice on this surface it was a\n    product-tour overlay (`fd-tour-overlay`, Pendo `#pendo-base`) swallowing the click, or a\n    too-narrow network filter — GHL splits one feature's read and write across `membership\u002F`,\n    `courses\u002F`, `services\u002F` and `clientportal-middleware\u002F`. Re-check with a **host-level** filter\n    before concluding a flow is client-side.\n12. **`createGroup` sends `marketplaceLocationId` (the UI's Discovery switch ON) unless `discovery: false`** (2026-10\n    switch, default ON as in the UI; OFF omits the key — that the group then stays off the marketplace is the switch's\n    stated purpose, not separately observed). Ask the operator which they want for a private client community.\n13. **Moderation keywords live on the ADMIN rail too** — group rows carry `settings.moderationSettings.blockedKeywords`\n    and the admin group PUT writes them (the portal read then shows them, proven 2026-10-30). Read the row and send\n    `settings` back whole with your change. Owner and admin posts are **never held**, so testing a keyword as the\n    owner proves nothing; the held queue and member reports are portal-only (403).\n14. **Notification preferences are one document per member per group**; the portal UI's save also turns the\n    member's `newsletter` push OFF (no push control on that row) — do not copy the UI's body.\n\n## Proof levels — know what you're trusting\n\n- **EXECUTED** (built and sent from code, effect asserted): everything the conformance suite covers,\n  plus contacts, media rails, themes, embeds, credential attach.\n- **OBSERVED only** (transcribed from the UI, never re-issued independently): `assessments.grade()`,\n  learner submission, `user-post-completion`. All member-session-bound; each was driven live through\n  the real portal and verified by read-back, but a field the UI sends and we failed to record would\n  only surface on first use. `grade()` is marked in-source.\n\n## Limits (state these rather than working around them)\n\n- **Paid offers are supported by the engine but need a connected payment integration** (bl-877). On a sandbox with none, a paid create returns `400 Integrations not found`. The enum is `onetime` (or `subscription`); `one_time` and `recurring` return 500. Checkout is unproven. Only `free` is proven end to end.\n- **Members cannot be fully provisioned headlessly** — portal signup is OTP-gated. See auth §8.3 for\n  the softer path (the user record exists before OTP verification).\n- **Whether the credential attachment FIRES on completion is unverified** — it's created and reads\n  `status: active`, but no member has completed a course to watch it issue.\n- **Module-level credential attachment** (`altType: \"category\"`) is implied by the response shape,\n  not verified — `attach()` only exposes product level.\n- Community channel create\u002Fupdate, and pending-invite list\u002Frevoke (403), are uncaptured.\n\n## Editing a course (public rail, ghl-multi)\n\nCourse editing is **public-only** (Xander, D3, 2026-11-06). Use `execute_action` on the ghl-multi server with these action ids. Every\nwrite takes `dry_run: true` first; read the preview; then send the same call with `confirm: true` where the server asks.\nAfter every write, read the course back with the internal `get_course` (one read: title, offers, normalised tree) and compare.\n\n| Job | Action | Notes |\n|---|---|---|\n| change a lesson | `courses-v3__update-lesson` `{productId, lessonId, …fields}` | partial body: only the fields you send change (measured 2026-11-06) |\n| change a chapter | `courses-v3__update-category` `{productId, categoryId, …fields}` | partial body (measured) |\n| change the course | `courses-v3__update-course` `{productId, …fields}` | partial body (measured) |\n| reorder chapters | `courses-v3__sequence-categories` `{productId, ids}` | `ids` lists every chapter in order (measured) |\n| reorder lessons in a chapter | `courses-v3__sequence-lessons` `{productId, categoryId, ids}` | `ids` lists every lesson of that chapter in order (measured) |\n| move a lesson to another chapter | `courses-v3__update-lesson` with `categoryId`, then `sequence-lessons` on the new chapter | two calls, see trap 3 |\n| remove a lesson | `courses-v3__delete-lesson` `{productId, lessonId}` | 204; the lesson then 404s (measured) |\n| remove a chapter | `courses-v3__delete-category` `{productId, categoryId}` | **cascades**: its lessons go with it (trap 2) |\n| remove a course | `courses-v3__delete-course` `{productId}` | 204 (measured on a probe product) |\n| add a lesson or chapter | `courses-v3__create-lesson` \u002F `courses-v3__create-category` | create as `visibility: \"draft\"` unless the user has asked to publish |\n\nTraps (the first three are measured on the sandbox; the rest are from the same runs):\n\n1. **A reorder that names only some lessons is not measured.** Always send every lesson of the chapter in `ids`. What the server\n   does with unnamed lessons is unknown, so do not rely on them keeping their place.\n2. **Deleting a chapter deletes its lessons.** Before `delete-category`, list the chapter's lessons (`get_course`) and say so to\n   the user. The internal route also cascades (measured), so this is not a rail difference.\n3. **A cross-chapter move is two writes, and the lesson keeps its old number.** `update-lesson` with `categoryId` moves the\n   lesson but does not renumber it (measured). Follow it with `sequence-lessons` on the new chapter, naming every lesson in order,\n   or the moved lesson can collide with an existing number.\n4. **Do not use the internal whole-document PUT for these edits.** The internal routes take the full object (the engine sends it\n   whole), so an edit there is a read-modify-write of the whole object. The public routes merge a partial body (measured).\n5. **Deleting an offer reads back as a ghost.** `courses-v3__delete-offer` returns 204, but a later `get-offer` returns 200\n   with an empty body. Verify an offer removal with `get_course` (the offers list), not with `get-offer` (bl-801).\n6. **Do not use `courses-v3__upsert-quiz-questions` to edit questions.** It replaces the whole question set (measured: two\n   questions gone when one was sent) and the option text is not read back. To add questions, use `edit_quiz_questions` (below).\n7. **Gated, do not run without the owner's go:** publishing a course, chapter, lesson, offer or channel (the spec's `visibility:\n   \"published\"` or any `*-publish`); any paid offer; any enrolment or grant that e-mails a member (G4). A dry run of these is fine.\n\n## Granting and revoking access\n\n- Internal: `set_course_access {locationId, contactId, offerId, action: grant|revoke, confirm}`. Preview first (no account call; `sends` says\n  whether a grant e-mails the member: `unknown` for a grant, not yet measured; `false` for a revoke). Confirmed, it reads the course membership, sends\n  the change, reads it again, and reports `granted`, `already-had`, `revoked`, `already-absent` or `queued-unconfirmed`. Trust the outcome, never the 200.\n- Public: `courses-v3__create-enrollment` (201 new, 200 `alreadyEnrolled`), `courses-v3__delete-enrollment` (revoke), `courses-v3__list-enrollments` (read back).\n- **A draft offer still grants access.** A public enrol into a free draft offer answered 201 and read back (bl-833). Do not treat an offer's draft\n  status as a guard. Never put anything confidential in an offer, and treat its id as public (an unauthenticated GET of `\u002Fmembership\u002Foffers\u002F{id}`\n  returns the draft, with the location and feature flags, bl-321).\n- A grant or enrol may e-mail the member. Every send is a gated action (G4) for a real student. Check the preview `sends` before confirming.\n\n## Progress and completion\n\n- Internal: `get_course_progress {locationId, courseId, email?}` walks every page and returns each student's course percent (`completedPercentage`),\n  the user's e-mail and `lastLogin`, plus a per-course summary. `complete: false` (with `failure`) means the walk did not finish: do not read a\n  partial list as the whole course. The internal route gives **no lesson counts**, so `completedLessons` is null there.\n- `lastActivity` on that tool is the last **login**, not the last lesson. Do not read it as lesson activity.\n- Public (ghl-multi): `courses-v3__list-bulk-progress {contactId, productIds}` returns `totalLessons` and `completedLessons` for a student, and\n  `courses-v3__list-category-progress` and `courses-v3__list-completions` give per-chapter progress and completions.\n- **Caveat (bl-834):** on the sandbox the public bulk route returned `totalLessons: 0` for a student on a course with 6 lessons. The likely cause is that\n  the lessons were draft (a count of published lessons only). This is untested: it needs a published lesson, which is a gated publish. Until it is settled,\n  do not trust a `0\u002F0` lesson count without checking the lessons' visibility first.\n\n## Quiz questions and grading\n\n- **Add questions in a batch:** `edit_quiz_questions {locationId, quizId, add: [{title, questionType, explanation?, options: [{statement, isCorrect}]}], confirm?}`.\n  `quizId` is the **quiz** id (the one `GET …\u002Fassessments\u002Fquiz\u002F{postId}` returns), not the lesson id. Preview first (no write). A single-choice question\n  needs exactly one correct option; duplicate question text in one batch is refused before anything is sent.\n- **The batch write replaces the whole question set** (measured on the sandbox, 2026-11-07: a one-question add to a quiz holding one question left two,\n  and the stored one was gone). So a confirmed `edit_quiz_questions` re-posts every stored question in full, then the additions, and it is refused\n  before any POST when a stored question's option text cannot be read. It reads the quiz again on a separate request and reports `added` only when that\n  read matches the expected set by content (question ids change on every save, so they are not compared, and a question id kept from before an edit is stale); otherwise `unverified`, with the full before list. A failed batch POST is read back the same way (the route replaces, so a failed POST may still have changed the set): the result carries `postFailed` with the HTTP status, and the after read.\n  Its `replace` argument is refused. Do not reach for `upsert-quiz-questions` (trap 6).\n- **Grade a submission (public):** `courses-v3__list-assessments {productId, status?, pageSize?, pageNumber?}`, `courses-v3__get-assessment {productId,\n  assessmentId}`, and `courses-v3__review-assessment` (PUT) with body `{status: passed | failed | processing, score?, feedback?}`. A grade is visible to\n  the learner. Only a submitted attempt can be graded, so the grading route needs a learner who has submitted in the portal.\n- **Not exposed:** the internal `Assessments.grade()` is observed only (transcribed from the admin UI) and needs a member session. Do not present it as a tool.\n- **Not yet proven on the sandbox:** a learner's quiz or assignment submission and its grade. That leg needs a portal session and is tracked on the\n  backlog (bl-842), not run in this build.\n\n## Communities: paid channels and plans (know about)\n\n- Announced 2026-11-02: **paid channels** and **multiple pricing plans** in Communities. Nothing here reads a paid flag, a plan or a price: the admin rail's group and location records carry no such key, and channel paid flags sit behind the PORTAL_USER scope.\n- **Every write is unproven.** Creating a paid channel, creating or editing a pricing plan, and connecting a payment provider for Communities are all paid actions and gated. Do not run them to \"test\" the route.\n- Know-about only: which surface shows what, and what is still open, is in the corpus page `70-research\u002F2026-11-06-communities-paid-channels-and-know-about.md`.\n- Course video analytics and the Discover Courses & Offers storefront have no route taught here; the courses analytics routes in the endpoint index are proven for dashboards, not for video watch data.\n\n## Routes with a proven raw_request write (settings, CSS and code, instructor fields, portal users)\n\nThese operations have no typed tool. Each one was proven on the sandbox (the write, then a read on a separate request, then a restore), so the\nroute and body shape below are evidence, not a guess. Send them with `raw_request {locationId, method, path, body, confirm: true}`. Preview first\nwhere the tool offers it, and never send a body whose keys you have not read first: several of these writes replace the whole object.\n\n- **Course CSS, custom code and header\u002Ffooter (product document):** `PUT \u002Fmembership\u002Flocations\u002F{locationId}\u002Fproducts\u002F{productId}` with the FULL product\n  object (read it with `GET` on the same path first). The custom fields are `customCss`, `customJs`, `customHeader`, `customFooter`. Proven: set to a TEST\n  value, read back on a separate GET, restored to `null`. Clearing a field back to `null` works; an empty string is not the same and is not used.\n- **Instructor name, title, bio and heading (customization):** `PUT \u002Fmembership\u002Flocations\u002F{locationId}\u002Fproducts\u002Fcustomizations\u002F{customizationId}`, with\n  the customization record read first (`GET \u002Fmembership\u002Flocations\u002F{locationId}\u002Fproducts\u002F{productId}`, the `customizations` block). Proven: name, title and\n  bio set and read back, the heading read back unchanged, then restored.\n- **Portal settings (portal banner text, app permissions, and the other portal-settings keys):** `PUT \u002Fclientclub\u002Fportal-settings\u002F{locationId}` with the\n  full document. The keys the GET carries must equal the read value, except the one test field. Keys the GET does not carry are sent only as the form's\n  own defaults. Proven for `portalBannerText` and for app permissions: set, read back on a separate GET, restored. Once a portal name is set the UI\n  cannot clear it (an empty name is refused before any request), so a name is a one-way write on a sandbox.\n- **Invite a user to the client portal:** `POST \u002Fclientclub\u002F{locationId}\u002Fusers\u002Finvite` with `{locationId, email: [address]}`; returns `201` with `{success: true}`. Proven: the portal settings read (`invitedUsers`) went from absent to a count of 1 on two separate reads after the invite. The invite e-mails the address: send it only with an approval that names the address, and read the user back afterwards.\n- **Course delete (irreversible; deletes the object):** `DELETE \u002Fmembership\u002Flocations\u002F{locationId}\u002Fproducts\u002F{id}`. It deletes the course. Deleting a product does not delete its offers, so clean up the offers separately. Proven: the course is gone from the list on a separate read after the delete. Delete only a TEST-CONF course you created for the test.\n- **Offer delete (accepted, not applied):** `DELETE \u002Fmembership\u002Flocations\u002F{locationId}\u002Foffers\u002F{id}` returns 200 `{ok:1}`, but the offer stays on the product record on a separate read (the course Offers list shows nothing). Do not rely on it to delete an offer: the delete is accepted but not applied, the same finding as the public delete-offer route.\n- **Course comment (edit and delete):** `PUT \u002Fmembership\u002Flocations\u002F{locationId}\u002Fcomments\u002F{commentId}` edits a comment; `DELETE \u002Fmembership\u002Flocations\u002F{locationId}\u002Fcomments\u002F{commentId}` removes it. Read the comment first with `GET` on the same path and send the full object on the PUT. Proven: set and read back on a separate GET, then restored.\n- **Lesson video (upload, then attach):** the assets-drm upload first (`POST \u002Fassets-drm\u002Fassets\u002Fsigned-url\u002Fupload` with `{source:\"courses\", entityId:\"{locationId}\", type:\"videos\", mimeType:\"video\u002Fmp4\"}`, then `PUT` the raw bytes to the signed URL, then `POST \u002Fassets-drm\u002Fassets` for the `assetsLicenseId`). Then `POST \u002Fmembership\u002Flocations\u002F{locationId}\u002Fvideos` with `{url, title, postId:\"{lessonId}\", assetsLicenseId, id}`. Note: the `path` returned by the upload needs a leading slash before the assets call.\n- **Course theme (save, then apply):** `PUT \u002Fcourses\u002Flocations\u002F{locationId}\u002Fproduct-themes\u002F{productId}\u002Ftheme\u002F{themeId}` saves the full `themeData` tree. Without the next step the course keeps its old theme: `PUT \u002Fmembership\u002Flocations\u002F{locationId}\u002Fproducts\u002Fapply-theme\u002F{productId}?template_id=NeoClassic` (empty body) applies it. Proven: the UI save and the apply both returned 200; a replay of the theme save (weight bold, read back on a separate GET, then restored) was read back; the product customization was unchanged after the apply.\n- **Community group (create):** `POST \u002Fcommunities\u002F{locationId}\u002Fgroups` with `{name, slug, description, locationId, marketplaceLocationId, branding:{}}` returns 201. Creating a group does not list it on the Gokollab marketplace: the listing is a separate outward step and is not done here.\n- **Portal notification preference (toggle, saves on change):** `POST \u002Fclientclub\u002Fnotification-preferences\u002F{locationId}` with `{category, notifications:{EXPIRE_CERTIFICATE:{config:{email, sms}, email_template}}, locationId}`; returns `201`. The page has no save button: unchecking sends the POST. Read the current value first on the page (the GET behind the page is not in the catalogue, so this row does not name it). Proven: the page read (200), the change (201), and the restore (201, same route, email set back to 1).\n- **Member grade (assignment review):** `PUT \u002Fcourses\u002Flocations\u002F{locationId}\u002Fassessments\u002F{submissionId}\u002Freview` with `{score, status:\"passed\"|\"failed\", feedback}`; returns `200` with `{error:false, updated:true}`. Note the `\u002Fcourses` path, not `\u002Fmembership`. Proven: the grade save returned 200, and an admin read of the same submission on a separate request showed it.\n- **Course site details (title and the site-info save):** `PUT \u002Fmembership\u002Flocations\u002F{locationId}\u002Fsettings\u002Fsite-info\u002F{siteInfoId}` carries the title. Proven: the title was set to a TEST value and read back on a separate GET, then restored to empty and read back. The same restore save also sent `PUT \u002Fmembership\u002Flocations\u002F{locationId}\u002Fsettings\u002Fdomain\u002F{id}` and `PUT ...\u002Fsettings\u002Fbuilder-settings\u002F{id}` with their values unchanged (200 each); those two routes are not proven as writes.\n- **Course duplicate (clone; leaves a new course):** `POST \u002Fmembership\u002Flocations\u002F{locationId}\u002Fproducts\u002Fclone\u002F{productId}` with `{locations: [locationId]}` returns the new `productIds`. Proven: the clone was read back on a separate GET (its title carried the \"- Clone\" suffix). The clone is a new course, so it stays as residue on a sandbox; delete it only by its own id.\nNot covered here: the course analytics dashboards (their data comes from read-only summary queries that the catalogue does not carry yet), the course\nanalytics progress view (no proven write), and learner-side rendering. Those stay as the corpus describes them.\n\n## Credential templates (certificates): list, create, designer save, delete\n\nProven on the sandbox with a read on a separate request after each write. The template is the credential's design; a credential is issued from it.\n\n- **List templates:** `GET \u002Fcertificates\u002Flocations\u002F{locationId}\u002Ftemplates` → `{templates: [{_id, title, ...}]}`.\n- **Create a template:** `POST \u002Fcertificates\u002Flocations\u002F{locationId}\u002Ftemplates` with `{title, ...}`, `confirm: true`. Returns `201`. Read it back on a separate\n  list GET (`_id` and `title`). Create only with an explicit approval naming the type. A created template stays as residue unless it is deleted with the route below.\n- **Designer save (title and canvas fields):** `PATCH \u002Fcertificates\u002Flocations\u002F{locationId}\u002Ftemplates\u002F{templateId}` with `{locationId, title, ...}`; send the body keys you change.\n  Proven: the title change read back on a separate list GET. Rules measured on the sandbox: the endpoint refuses an empty `title` (send the unchanged\n  title with every PATCH); the merge keeps keys you omit; the designer's `templateJson` cannot be cleared back to an empty string through this route\n  (a restore to `\"\"` is stored as the two-character string `\"\"`, not the empty value). Read the template first and send the exact before value for any\n  key you restore.\n- **Delete a template:** `DELETE \u002Fcertificates\u002Flocations\u002F{locationId}\u002Ftemplates\u002F{templateId}`, with confirm. It returns `200` with\n  `type: TEMPLATE_DELETED`. Read back on a separate list GET: the id is gone. Delete only a template you created for the test, by its own id.\n\n## Full reference\n\n`references\u002Fcourse-spec.md` — spec format.\nSemantics and capture evidence: the corpus surface `knowledge\u002Fcorpus\u002Fmemberships-courses\u002F`, the\nsource of truth for anything this file summarises. The **endpoint index** is `search_endpoints`\non the internal MCP: every `\u002Fmembership\u002F*`, `\u002Fcourses\u002F*`, `\u002Fcertificates\u002F*` and `\u002Fclientclub\u002F*`\nroute, mined from the memberships front-end's own source — most never exercised here.\n`describe_endpoint` gives the exact `raw_request`, and `raw_request` sends the `sourceid` this\nsurface's front-end pins. The engine modules above remain the way to WRITE: a catalogued route is\na path, not a proven write.\n",{"name":5,"description":7},"main","35d05921ecd17673183702dca9c1bb7d2c961f71","plugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships",5,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory","https:\u002F\u002Fgithub.com\u002Fuxieee","2026-11-13 05:11:02",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add uxieee\u002Fuxie-ghl-factory --skill ghl-memberships",{"tool":37,"command":38},"bunx","bunx skills add uxieee\u002Fuxie-ghl-factory --skill ghl-memberships",{"tool":40,"command":41},"pnpm","pnpm dlx skills add uxieee\u002Fuxie-ghl-factory --skill ghl-memberships","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002FSKILL.md",true,[45,51,55,59,63,67,71,75,79,83,87,91,95,101,105,109,113,117,121,125,129],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"engine\u002Fapi.mjs","SCRIPT","脚本",13560,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Fengine\u002Fapi.mjs",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"engine\u002Fapi.test.mjs",7216,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Fengine\u002Fapi.test.mjs",{"path":56,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":57,"sourceHtmlUrl":58},"engine\u002Fassessments.mjs",9559,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Fengine\u002Fassessments.mjs",{"path":60,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":61,"sourceHtmlUrl":62},"engine\u002Fassessments.test.mjs",8575,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Fengine\u002Fassessments.test.mjs",{"path":64,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":65,"sourceHtmlUrl":66},"engine\u002Fauth.mjs",3858,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Fengine\u002Fauth.mjs",{"path":68,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":69,"sourceHtmlUrl":70},"engine\u002Fcommunities.mjs",6181,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Fengine\u002Fcommunities.mjs",{"path":72,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":73,"sourceHtmlUrl":74},"engine\u002Fcommunities.test.mjs",1066,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Fengine\u002Fcommunities.test.mjs",{"path":76,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":77,"sourceHtmlUrl":78},"engine\u002Fcourse-builder.mjs",25818,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Fengine\u002Fcourse-builder.mjs",{"path":80,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":81,"sourceHtmlUrl":82},"engine\u002Fcourse-builder.test.mjs",12619,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Fengine\u002Fcourse-builder.test.mjs",{"path":84,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":85,"sourceHtmlUrl":86},"engine\u002Fcredentials.mjs",6370,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Fengine\u002Fcredentials.mjs",{"path":88,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":89,"sourceHtmlUrl":90},"engine\u002Fmembers.mjs",8363,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Fengine\u002Fmembers.mjs",{"path":92,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":93,"sourceHtmlUrl":94},"engine\u002Fmembers.test.mjs",5628,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Fengine\u002Fmembers.test.mjs",{"path":96,"resourceType":97,"resourceTypeDesc":98,"sizeBytes":99,"sourceHtmlUrl":100},"references\u002Fcourse-spec.md","REFERENCE","参考文档",5388,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Freferences\u002Fcourse-spec.md",{"path":102,"resourceType":97,"resourceTypeDesc":98,"sizeBytes":103,"sourceHtmlUrl":104},"references\u002Fexample-spec.json",3777,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Freferences\u002Fexample-spec.json",{"path":106,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":107,"sourceHtmlUrl":108},"scripts\u002Fbuild-course.mjs",3824,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Fscripts\u002Fbuild-course.mjs",{"path":110,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":111,"sourceHtmlUrl":112},"scripts\u002Fbuild-course.test.mjs",606,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Fscripts\u002Fbuild-course.test.mjs",{"path":114,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":115,"sourceHtmlUrl":116},"scripts\u002Fcli-gateway.mjs",2708,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Fscripts\u002Fcli-gateway.mjs",{"path":118,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":119,"sourceHtmlUrl":120},"scripts\u002Fcli-gateway.test.mjs",1723,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Fscripts\u002Fcli-gateway.test.mjs",{"path":122,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":123,"sourceHtmlUrl":124},"scripts\u002Fconformance-flags.mjs",637,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Fscripts\u002Fconformance-flags.mjs",{"path":126,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":127,"sourceHtmlUrl":128},"scripts\u002Fconformance-flags.test.mjs",1722,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Fscripts\u002Fconformance-flags.test.mjs",{"path":130,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":131,"sourceHtmlUrl":132},"scripts\u002Fconformance.mjs",25596,"https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-memberships\u002Fscripts\u002Fconformance.mjs",[134,141,148,155,162,169],{"skillNo":135,"name":136,"nameZh":6,"description":137,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":138,"categories":139,"keywords":140,"publishedAt":19},"01M78F5XMBPT6K5KN5H7JWWYRH","ghl-workflow-specialist","Senior GoHighLevel workflow architect — designs automations (nurture, speed-to-lead, no-show recovery, internal ops, data hygiene, routing) grounded in the full trigger\u002Faction catalog and known anti-patterns, and reviews or fixes live workflows. Use when the user asks what automation to set up for X, wants a workflow designed, or asks why a live workflow is not getting through, is failing, or whether an A\u002FB test is done. Recons + reads the client brief before proposing anything. Once approved, the build itself goes to create-ghl-workflow.","https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-workflow-specialist\u002FSKILL.md",[],[],{"skillNo":142,"name":143,"nameZh":6,"description":144,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":145,"categories":146,"keywords":147,"publishedAt":19},"01M78F5PXJXRMGCK95MAPVBHAJ","ghl-workflow-fast-forward","Fast-forward contacts parked at a GoHighLevel \u002F HighLevel workflow WAIT step to the next step — the builder's \"Action statistics → move to next step\" control, driven via the internal API. Use to accelerate end-to-end workflow testing (drive a multi-day wait ladder to completion in minutes instead of waiting real time), to unstick contacts stranded at a wait, or when the user says \"fast-forward this wait\", \"skip the wait\", \"move parked\u002Fstuck contacts to the next step\", \"requeue stuck contacts\", \"test this long delay without waiting days\", or gives an app.gohighlevel.com workflow URL and asks to push contacts past a wait. This MUTATES live enrollments (it fires whatever steps come next, i.e. real SMS\u002Femail to real people) — it is a WRITE skill and follows the plugin's write-rails. It is the mutating counterpart to the read-only get-ghl-workflow-logs.","https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-workflow-fast-forward\u002FSKILL.md",[],[],{"skillNo":149,"name":150,"nameZh":6,"description":151,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":152,"categories":153,"keywords":154,"publishedAt":19},"01M78F5GZERF2S6CMHXWQYQEHZ","ghl-voice-ai","Build and configure GoHighLevel Voice AI phone agents — the prompt, the voice, the actions (appointment booking, call\u002Fagent transfer, contact-field extraction, SMS, workflows, custom API), knowledge bases, MCP servers, working hours, and outbound consent. Use when the user says 'set up a voice agent', 'build a phone agent', 'my AI should answer calls', 'book appointments over the phone', 'outbound calling', 'the agent isn't transferring calls', 'change the voice', or names a Voice AI agent. Internal API — the public rail exposes only how the agent sounds, not what it does.","https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-voice-ai\u002FSKILL.md",[],[],{"skillNo":156,"name":157,"nameZh":6,"description":158,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":159,"categories":160,"keywords":161,"publishedAt":19},"01M78F5A7S9450G94K3Z7P0HWK","ghl-system-conventions","House conventions for building GoHighLevel systems — workflow naming and structure, tag\u002Ffield\u002Fcustom-value discipline, pipeline and opportunity decisions, copy rules, and the pre-build approval document the operator signs off before anything gets created. Account-agnostic, for ANY GHL sub-account. Use whenever designing, building, editing, reviewing, or discussing GHL workflows, automations, pipelines, stages, opportunities, tags, custom fields, custom values, calendars, or AI agents — even if the user never says \"conventions\" or \"standards\". Load it BEFORE proposing a design or creating any GHL object, so the proposal already looks the way the operator wants it.","https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-system-conventions\u002FSKILL.md",[],[],{"skillNo":163,"name":164,"nameZh":6,"description":165,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":166,"categories":167,"keywords":168,"publishedAt":19},"01M78F54ZQZ21VS3JQJ21QVGWS","ghl-snapshots","GoHighLevel snapshots — capturing a sub-account's assets into a reusable snapshot, refreshing one, curating what it carries, and checking load conflicts. Use when a task involves creating or updating a snapshot, deciding what an account template should include, asking why a snapshot came out empty or is stuck processing, or planning a rollout onto other sub-accounts. Read it BEFORE calling any \u002Fsnapshots path by raw_request — two of the write endpoints silently do the wrong thing.","https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-snapshots\u002FSKILL.md",[],[],{"skillNo":170,"name":171,"nameZh":6,"description":172,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":173,"categories":174,"keywords":175,"publishedAt":19},"01M78F4Y7ZHHJ1DMV11TC1CPVW","ghl-reverse-engineering","Map a GoHighLevel internal surface exhaustively — enumerate every screen, panel, control and save path a feature has, capture the real request behind each one, prove what each field does by differential, and write the result into the corpus. Use when the user wants to understand how a GHL feature works under the hood, extend an engine to an object the public API can't reach, re-sweep a surface that already has partial coverage, or asks to reverse-engineer \u002F sniff \u002F capture \u002F trace anything internal. GHL permits inspecting your own account's traffic. This is a MAPPING skill, not a lookup: it finishes when the surface is exhausted, not when the first endpoint is found.","https:\u002F\u002Fgithub.com\u002Fuxieee\u002Fuxie-ghl-factory\u002Fblob\u002Fmain\u002Fplugins\u002Fuxie-ghl-factory\u002Fskills\u002Fghl-reverse-engineering\u002FSKILL.md",[],[]]