@numericoach/gskills-admin-cli 0.1.8 → 0.1.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -38,6 +38,15 @@ gskills-admin cache invalidate --instance <instanceId> --scope pages --languages
38
38
  gskills-admin cache invalidate --instance <instanceId> --scope menu-bundle --yes --output json
39
39
  ```
40
40
 
41
+ CRUD help includes cache hints for resources that can leave deploy views stale after a raw write:
42
+
43
+ ```bash
44
+ gskills-admin pages help --output json
45
+ gskills-admin topics help --output json
46
+ ```
47
+
48
+ Use the listed `cache.scopes` with `gskills-admin cache invalidate` after create, update, or delete when the end-user view must reflect the change immediately.
49
+
41
50
  Operational helpers are available for the admin-only flows agents should not improvise:
42
51
 
43
52
  ```bash
@@ -53,14 +62,16 @@ gskills-admin ambassadors label --instance <instanceId> --language fr --output j
53
62
 
54
63
  Feedback reply bodies are file-based on purpose. Production replies are multi-line, and `send-reply` rejects inline body text to avoid shell parsing surprises.
55
64
 
56
- Raw project and analytics data can be read through resources such as `project-data`, `ticket-sla-rules`, `analytics`, `quiz-attempts`, `user-paths`, `chromebook-progress`, and `user-learning-paths`.
65
+ Raw project and analytics data can be read or adjusted through resources such as `project-data`, `ticket-sla-rules`, `analytics`, `quiz-attempts`, `user-paths`, `chromebook-progress`, `user-badges`, `user-learning-paths`, and `user-learning-path-item-completions`.
57
66
 
58
67
  ## Agent skill
59
68
 
60
- Install the bundled skills so AI agents know the auth model, resource map, output modes, sync workflow, content-authoring standards, and recurring DB-backed ops runbooks.
69
+ Install the bundled skills so AI agents know the auth model, resource map, output modes, sync workflow, content-authoring standards, recurring DB-backed ops runbooks, GSkills vocabulary, and recurring customer playbooks.
61
70
 
62
71
  ```bash
63
72
  gskills-admin skills install --target ~/.codex/skills
73
+ gskills-admin skills install --name gskills-vocabulary --target ~/.codex/skills
74
+ gskills-admin skills install --name gskills-customer-playbooks --target ~/.codex/skills
64
75
  gskills-admin skills install --name gskills-feedback-db-ops --target ~/.codex/skills
65
76
  ```
66
77
 
@@ -334,7 +334,8 @@ var resources = [
334
334
  aliases: ["page", "content"],
335
335
  defaultFields: ["id", "name", "slug", "language", "instanceId", "disabled", "archived", "alphaProgramIds", "updatedAt"],
336
336
  syncable: true,
337
- dangerousDelete: true
337
+ dangerousDelete: true,
338
+ cacheScopes: ["pages", "pages-knowledge"]
338
339
  },
339
340
  {
340
341
  name: "topics",
@@ -343,7 +344,8 @@ var resources = [
343
344
  aliases: ["topic", "applications", "category-apps", "categories", "thematics", "thematic"],
344
345
  defaultFields: ["id", "name", "slug", "language", "instanceId", "disabled", "archived", "alphaProgramIds", "updatedAt"],
345
346
  syncable: true,
346
- dangerousDelete: true
347
+ dangerousDelete: true,
348
+ cacheScopes: ["applications", "pages", "pages-knowledge"]
347
349
  },
348
350
  {
349
351
  name: "resources",
@@ -352,7 +354,8 @@ var resources = [
352
354
  aliases: ["resource", "ebooks", "e-books", "webinars", "magazines"],
353
355
  defaultFields: ["id", "title", "type", "language", "instanceId", "isActive", "disabled", "archived", "alphaProgramIds", "updatedAt"],
354
356
  syncable: true,
355
- dangerousDelete: true
357
+ dangerousDelete: true,
358
+ cacheScopes: ["pages-knowledge"]
356
359
  },
357
360
  {
358
361
  name: "internal-knowledge",
@@ -361,7 +364,8 @@ var resources = [
361
364
  aliases: ["knowledge", "knowledges"],
362
365
  defaultFields: ["id", "title", "language", "instanceId", "isActive", "isAIAllowed", "disabled", "archived", "alphaProgramIds", "updatedAt"],
363
366
  syncable: true,
364
- dangerousDelete: true
367
+ dangerousDelete: true,
368
+ cacheScopes: ["pages-knowledge"]
365
369
  },
366
370
  {
367
371
  name: "learning-paths",
@@ -370,7 +374,8 @@ var resources = [
370
374
  aliases: ["learning-path", "paths", "path"],
371
375
  defaultFields: ["id", "name", "slug", "language", "instanceId", "isActive", "mandatory", "disabled", "archived", "alphaProgramIds", "updatedAt"],
372
376
  syncable: true,
373
- dangerousDelete: true
377
+ dangerousDelete: true,
378
+ cacheScopes: ["pages", "pages-knowledge"]
374
379
  },
375
380
  {
376
381
  name: "changelogs",
@@ -387,7 +392,8 @@ var resources = [
387
392
  aliases: ["chromebook", "chromebook-game", "chromebook-exercise", "chromebook-games"],
388
393
  defaultFields: ["id", "title", "language", "instanceId", "type", "order", "isActive", "parentId", "sourceExerciseId", "updatedAt"],
389
394
  instanceField: "instanceId",
390
- dangerousDelete: true
395
+ dangerousDelete: true,
396
+ cacheScopes: ["pages", "pages-knowledge"]
391
397
  },
392
398
  {
393
399
  name: "chromebook-steps",
@@ -396,7 +402,8 @@ var resources = [
396
402
  aliases: ["chromebook-step", "chromebook-exercise-steps"],
397
403
  defaultFields: ["id", "exerciseId", "stepNumber", "title", "language", "contentType", "order", "updatedAt"],
398
404
  instanceField: null,
399
- dangerousDelete: true
405
+ dangerousDelete: true,
406
+ cacheScopes: ["pages", "pages-knowledge"]
400
407
  },
401
408
  {
402
409
  name: "project-data",
@@ -438,7 +445,8 @@ var resources = [
438
445
  label: "Instances",
439
446
  aliases: ["instance"],
440
447
  defaultFields: ["id", "name", "URL", "licenceType", "alphaProgramKeys", "createdAt", "updatedAt"],
441
- dangerousDelete: true
448
+ dangerousDelete: true,
449
+ cacheScopes: ["all"]
442
450
  },
443
451
  {
444
452
  name: "alpha-programs",
@@ -454,7 +462,8 @@ var resources = [
454
462
  aliases: ["quiz"],
455
463
  defaultFields: ["id", "title", "language", "instanceId", "mandatory", "isActive", "disabled", "archived", "alphaProgramIds", "updatedAt"],
456
464
  syncable: true,
457
- dangerousDelete: true
465
+ dangerousDelete: true,
466
+ cacheScopes: ["pages", "pages-knowledge"]
458
467
  },
459
468
  {
460
469
  name: "badges",
@@ -463,7 +472,8 @@ var resources = [
463
472
  aliases: ["badge"],
464
473
  defaultFields: ["id", "name", "language", "instanceId", "disabled", "archived", "alphaProgramIds", "updatedAt"],
465
474
  syncable: true,
466
- dangerousDelete: true
475
+ dangerousDelete: true,
476
+ cacheScopes: ["pages", "pages-knowledge"]
467
477
  },
468
478
  {
469
479
  name: "feedbacks",
@@ -505,7 +515,8 @@ var resources = [
505
515
  aliases: ["ambassador", "champions", "champion", "experts", "expert"],
506
516
  defaultFields: ["id", "userId", "active", "descriptionAmbassador", "contactContent", "createdOn"],
507
517
  instanceField: null,
508
- dangerousDelete: true
518
+ dangerousDelete: true,
519
+ cacheScopes: ["pages"]
509
520
  },
510
521
  {
511
522
  name: "tags",
@@ -514,7 +525,8 @@ var resources = [
514
525
  aliases: ["tag"],
515
526
  defaultFields: ["id", "name", "normalizedName", "color", "scope", "ownerInstanceId", "createdAt", "updatedAt"],
516
527
  instanceField: "ownerInstanceId",
517
- dangerousDelete: true
528
+ dangerousDelete: true,
529
+ cacheScopes: ["pages", "pages-knowledge"]
518
530
  },
519
531
  {
520
532
  name: "tag-assignments",
@@ -522,7 +534,8 @@ var resources = [
522
534
  label: "Tag assignments",
523
535
  aliases: ["tag-assignment"],
524
536
  defaultFields: ["id", "tagId", "instanceId", "entityType", "entityId", "createdAt", "updatedAt"],
525
- dangerousDelete: true
537
+ dangerousDelete: true,
538
+ cacheScopes: ["pages", "pages-knowledge"]
526
539
  },
527
540
  {
528
541
  name: "menus",
@@ -531,7 +544,8 @@ var resources = [
531
544
  aliases: ["menu", "menu-items"],
532
545
  defaultFields: ["id", "name", "url", "pageId", "parentId", "instanceId", "disabled", "archived", "alphaProgramIds", "updatedAt"],
533
546
  syncable: true,
534
- dangerousDelete: true
547
+ dangerousDelete: true,
548
+ cacheScopes: ["menu-bundle"]
535
549
  },
536
550
  {
537
551
  name: "menu-sections",
@@ -540,7 +554,8 @@ var resources = [
540
554
  aliases: ["menu-instances"],
541
555
  defaultFields: ["id", "name", "order", "instanceId", "disabled", "archived", "alphaProgramIds"],
542
556
  syncable: true,
543
- dangerousDelete: true
557
+ dangerousDelete: true,
558
+ cacheScopes: ["menu-bundle"]
544
559
  },
545
560
  {
546
561
  name: "workflows",
@@ -549,14 +564,16 @@ var resources = [
549
564
  aliases: ["workflow"],
550
565
  defaultFields: ["id", "name", "triggerType", "isActive", "instanceId", "disabled", "archived", "alphaProgramIds", "updatedAt"],
551
566
  syncable: true,
552
- dangerousDelete: true
567
+ dangerousDelete: true,
568
+ cacheScopes: ["pages", "pages-knowledge"]
553
569
  },
554
570
  {
555
571
  name: "feature-flags",
556
572
  delegate: "featureFlagAssignment",
557
573
  label: "Feature flags",
558
574
  aliases: ["feature-flag", "flags"],
559
- defaultFields: ["id", "featureKey", "targetType", "targetId", "active", "variant", "updatedAt"]
575
+ defaultFields: ["id", "featureKey", "targetType", "targetId", "active", "variant", "updatedAt"],
576
+ cacheScopes: ["all"]
560
577
  },
561
578
  {
562
579
  name: "groups",
@@ -564,7 +581,8 @@ var resources = [
564
581
  label: "Manual groups",
565
582
  aliases: ["group", "manual-groups", "manual-group"],
566
583
  defaultFields: ["id", "name", "description", "instanceId", "isRevert", "createdAt", "updatedAt"],
567
- dangerousDelete: true
584
+ dangerousDelete: true,
585
+ cacheScopes: ["menu-bundle"]
568
586
  },
569
587
  {
570
588
  name: "org-units",
@@ -572,7 +590,8 @@ var resources = [
572
590
  label: "Org units",
573
591
  aliases: ["org-unit", "ou", "ous"],
574
592
  defaultFields: ["id", "name", "code", "type", "googleOuId", "parentId", "instanceId", "instanceCountryParentId", "createdAt", "updatedAt"],
575
- dangerousDelete: true
593
+ dangerousDelete: true,
594
+ cacheScopes: ["menu-bundle"]
576
595
  },
577
596
  {
578
597
  name: "user-org-units",
@@ -581,7 +600,8 @@ var resources = [
581
600
  aliases: ["user-org-unit", "ou-memberships"],
582
601
  defaultFields: ["userId", "orgUnitId", "primary", "assignedAt"],
583
602
  instanceField: null,
584
- dangerousDelete: true
603
+ dangerousDelete: true,
604
+ cacheScopes: ["menu-bundle"]
585
605
  },
586
606
  {
587
607
  name: "ou-admin-scopes",
@@ -598,7 +618,8 @@ var resources = [
598
618
  label: "Entity restriction rules",
599
619
  aliases: ["entity-rules", "content-restriction-rules", "restrictions"],
600
620
  defaultFields: ["id", "instanceId", "entityId", "restrictionMode", "categoryIds", "learningPathRestrictionMode", "learningPathIds", "alphaAllPrograms", "alphaProgramIds", "updatedAt"],
601
- dangerousDelete: true
621
+ dangerousDelete: true,
622
+ cacheScopes: ["menu-bundle", "pages", "pages-knowledge", "applications"]
602
623
  },
603
624
  {
604
625
  name: "users",
@@ -615,7 +636,8 @@ var resources = [
615
636
  aliases: ["access-pass", "passes"],
616
637
  defaultFields: ["id", "userId", "type", "startAt", "expireAt", "givenAt", "createdAt", "updatedAt"],
617
638
  instanceField: "user.instanceID",
618
- dangerousDelete: true
639
+ dangerousDelete: true,
640
+ cacheScopes: ["menu-bundle"]
619
641
  },
620
642
  {
621
643
  name: "analytics",
@@ -687,6 +709,7 @@ var resourceHelpRows = () => resources.map((resource) => ({
687
709
  resource: resource.name,
688
710
  db: resource.delegate,
689
711
  sync: resource.syncable ? "yes" : "no",
712
+ cacheScopes: resource.cacheScopes?.join(", ") || "",
690
713
  aliases: resource.aliases.join(", ")
691
714
  }));
692
715
  // ../../src/cli/commands.ts
@@ -1469,7 +1492,9 @@ var schemaHelp = () => ({
1469
1492
  name: resource.name,
1470
1493
  aliases: resource.aliases,
1471
1494
  defaultFields: resource.defaultFields,
1472
- syncable: Boolean(resource.syncable)
1495
+ syncable: Boolean(resource.syncable),
1496
+ cacheScopes: resource.cacheScopes ?? [],
1497
+ cacheNote: resource.cacheScopes?.length ? "After create/update/delete, visible deploy content may stay stale until these cache scopes are invalidated." : "No deploy-cache scope is listed for this raw resource. Still verify visible product state after writes."
1473
1498
  }))
1474
1499
  });
1475
1500
  var authHelp = () => ({
@@ -1484,6 +1509,8 @@ var skillsHelp = () => ({
1484
1509
  usage: [
1485
1510
  "gskills-admin skills install",
1486
1511
  "gskills-admin skills install --target ~/.codex/skills",
1512
+ "gskills-admin skills install --name gskills-vocabulary",
1513
+ "gskills-admin skills install --name gskills-customer-playbooks",
1487
1514
  "gskills-admin skills install --name gskills-feedback-db-ops",
1488
1515
  "gskills-admin skills path"
1489
1516
  ],
@@ -1593,6 +1620,11 @@ var resourceHelp = (resource) => ({
1593
1620
  `gskills-admin ${resource.name} delete <id> --force --confirm-delete ${resource.name}:<id>`
1594
1621
  ],
1595
1622
  defaultFields: resource.defaultFields,
1623
+ cache: {
1624
+ scopes: resource.cacheScopes ?? [],
1625
+ invalidate: resource.cacheScopes?.length ? `gskills-admin cache invalidate --instance <instanceId> --scope ${resource.cacheScopes[0]} --dry-run` : null,
1626
+ note: resource.cacheScopes?.length ? "After create/update/delete, deploy views may still show cached content. Dry-run and invalidate the relevant scope, then verify the visible page." : "No deploy-cache scope is listed for this raw resource. If the write affects visible content indirectly, use cache scopes to choose a broader invalidation."
1627
+ },
1596
1628
  deleteWarning: "Delete permanently removes production data and requires an exact --confirm-delete token."
1597
1629
  });
1598
1630
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@numericoach/gskills-admin-cli",
3
- "version": "0.1.8",
3
+ "version": "0.1.9",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "description": "Admin-only CLI for GSkills super-admin operations.",
@@ -9,6 +9,11 @@ Use this skill when you need to operate GSkills as a super admin from an agent.
9
9
 
10
10
  The CLI is intentionally boring. It logs in through GSkills Auth, calls GSkills API routes, and never asks an agent for a database URL.
11
11
 
12
+ Also install and use the companion skills:
13
+
14
+ - `gskills-vocabulary` when explaining work to admins or writing user-facing summaries.
15
+ - `gskills-customer-playbooks` when the task names a recurring GSkills customer.
16
+
12
17
  ## Install
13
18
 
14
19
  ```bash
@@ -54,6 +59,16 @@ gskills-admin pages update <id> --data '{"disabled":false}' --dry-run --output j
54
59
 
55
60
  5. Apply the exact same command without `--dry-run` only after the payload is correct.
56
61
 
62
+ 6. For visible content changes, check the resource cache hint and refresh cache when needed.
63
+
64
+ ```bash
65
+ gskills-admin pages help --output json
66
+ gskills-admin cache invalidate --instance <instanceId> --scope pages --dry-run --output json
67
+ gskills-admin cache invalidate --instance <instanceId> --scope pages --yes --output json
68
+ ```
69
+
70
+ CRUD help exposes `cache.scopes` for resources that are known to feed deploy caches. After create, update, or delete, the database can be correct while the end-user view is still stale. Use the narrowest listed scope first. Use `all` only when the changed setting affects many deploy surfaces or when the narrow scope did not clear the visible stale state.
71
+
57
72
  Deletes are stricter than other writes. They require both `--force` and an exact confirmation token.
58
73
 
59
74
  ```bash
@@ -258,6 +273,17 @@ gskills-admin cache invalidate --instance <instanceId> --scope menu-bundle --yes
258
273
  gskills-admin cache invalidate --instance <instanceId> --scope all --yes --output json
259
274
  ```
260
275
 
276
+ CRUD resources that expose `cache.scopes` in `gskills-admin <resource> help --output json` should be treated as cached. After a raw write on one of those resources, dry-run the cache invalidation plan, apply it with `--yes`, then re-check the visible product surface.
277
+
278
+ Typical mapping:
279
+
280
+ - courses, tutorials, granules, modules, quizzes, badges, parcours, Chromebook content: `pages`
281
+ - base de connaissance pages and knowledge-facing resources: `pages-knowledge`
282
+ - applications: `applications`, often with `pages` or `pages-knowledge`
283
+ - menus: `menu-bundle`
284
+ - content restrictions and group visibility: usually `menu-bundle`, sometimes `pages`, `pages-knowledge`, or `applications`
285
+ - broad instance settings or feature flags: `all`
286
+
261
287
  ## Feedback Emails
262
288
 
263
289
  Use `send-reply` for the normal email available from the feedback detail dialog. It uses the `GSkillsEmail` template, sends to the feedback user, stores a `FeedbackReply`, updates `repliedAt`, and writes admin logs.
@@ -415,6 +441,36 @@ gskills-admin quiz-attempts list --where '{"user":{"instanceID":"<instanceId>"}}
415
441
 
416
442
  Prefer these read paths for analytics investigation. They are intentionally raw enough to match UI analytics data without giving the agent a DB URL.
417
443
 
444
+ ## User Activity Raw Ops
445
+
446
+ The CLI intentionally exposes user activity as raw authenticated resources, not as a magic repair wizard.
447
+
448
+ Supported raw activity surfaces:
449
+
450
+ - `user-paths`: course, tutorial, granule, or module completion rows.
451
+ - `quiz-attempts`: quiz attempts and completion state.
452
+ - `user-badges`: awarded badges.
453
+ - `user-learning-paths`: parcours progress and completion.
454
+ - `user-learning-path-item-completions`: completed items inside a parcours.
455
+ - `chromebook-progress`: Chromebook game exercise progress.
456
+ - `analytics`: raw activity events used by analytics surfaces.
457
+
458
+ When a super admin asks whether an agent can inspect or fix activity, the answer is yes through these raw resources. Read the user, instance, content row, and existing activity rows first. Use `--dry-run` before writes, then re-read the changed rows.
459
+
460
+ Examples:
461
+
462
+ ```bash
463
+ gskills-admin users list --where '{"email":"user@example.com"}' --fields id,email,name,instanceID --output json
464
+ gskills-admin user-paths list --where '{"userId":"<userId>"}' --output json
465
+ gskills-admin quiz-attempts list --where '{"userId":"<userId>"}' --output json
466
+ gskills-admin user-badges list --where '{"userId":"<userId>"}' --output json
467
+ gskills-admin user-learning-paths list --where '{"userId":"<userId>"}' --output json
468
+ gskills-admin user-learning-path-item-completions list --where '{"userId":"<userId>"}' --output json
469
+ gskills-admin chromebook-progress list --where '{"userId":"<userId>"}' --output json
470
+ ```
471
+
472
+ Raw fixes are allowed, but do not pretend a single row always covers the whole product behavior. For example, a quiz completion can also matter for a parcours, a badge, a workflow, points, or analytics. If the user asked for a visible result, verify the visible result after the raw write.
473
+
418
474
  ## Cache Scope Choice
419
475
 
420
476
  Prefer the narrowest scope:
@@ -0,0 +1,180 @@
1
+ ---
2
+ name: gskills-customer-playbooks
3
+ description: Use when a GSkills task names a recurring customer and the agent needs operational memory about that customer, common requests, likely checks, sync patterns, access quirks, or communication sources.
4
+ ---
5
+
6
+ # GSkills Customer Playbooks
7
+
8
+ Use this skill when the user names a recurring GSkills customer. This is operational memory, not live proof. If the answer or action matters in production, re-check current DB rows, admin logs, sync logs, Slack, Gmail, Google Chat, or the app before acting.
9
+
10
+ ## General Defaults
11
+
12
+ - Start from the customer instance, not from a generic global theory.
13
+ - For broken syncs, compare the target instance against global and against a working synced sibling when useful.
14
+ - For feedbacks, inspect the feedback row, user, instance, and admin logs before explaining the cause.
15
+ - For access issues, check user instance, access passes, auth mode, domain or account allowlists, then logs.
16
+ - For client wording, use the real thread or channel when available.
17
+ - Use `gskills-vocabulary` before writing human-facing summaries.
18
+
19
+ ## Air Liquide
20
+
21
+ Air Liquide is the heavy recurring customer. Expect large content volume, customized content, language constraints, and auth or Google Admin setup work.
22
+
23
+ Common work:
24
+
25
+ - Broad content synchronisation from global, often with thousands of items.
26
+ - Large diffs with many `SKIPPED_CUSTOMIZED` items. This is normal, not automatically a failure.
27
+ - Page, quiz, parcours, menu, resource, badge, and internal knowledge parity checks after sync.
28
+ - Feedback instance attribution and page-family parity repairs.
29
+ - Access-denied work around expired access passes or domain allowlists.
30
+ - Okta setup and auth callback checks.
31
+ - Google Admin users, groups, and OU checks. Users and groups have worked before while OU access required scope/config follow-up.
32
+ - Locale and wording work, especially Quebec French.
33
+ - Short natural client-facing email drafts from the actual thread.
34
+
35
+ Known context:
36
+
37
+ - Customer id used during Google Admin checks: `C028v0b9g`.
38
+ - Known Google Chat space: `Air Liquide x Numericoach - GSkills`, `spaces/AAQAc2CT1qI`.
39
+ - Harold OUSSET was a known user whose display name required surname-first parsing.
40
+ - Air Liquide syncs should usually start with `sync logs`, then `sync diff`, then a narrow or preset run.
41
+
42
+ ## HASAP
43
+
44
+ HASAP often appears in feedback and content visibility work.
45
+
46
+ Common work:
47
+
48
+ - Webinar content, parcours updates, invitations, user imports, and client-side launch follow-up.
49
+ - Badge visibility and badge delivery repairs.
50
+ - Google Forms badge issues where the page trigger stayed the same but the badge target changed.
51
+ - Quiz completion and answer submission investigations.
52
+ - Page sync visibility issues where disabled or archived state and sync logs mattered.
53
+
54
+ Known context:
55
+
56
+ - Known Google Chat space: `GSkills_Hasap_x_Numericoach`, `spaces/AAQAxJEETeI`.
57
+ - The recurring badge pitfall is workflow deduplication. A same-page `QUIZ_COMPLETED` execution can block a new badge action if only the badge target changed.
58
+ - Do not explain HASAP sync issues from the URL alone. Use prod data, the exact sync run, `LogsUser`, and the page or parcours family.
59
+
60
+ ## FM LOGISTIC Google & Co
61
+
62
+ FM Logistic work is usually about resources, webinars, and visibility rules.
63
+
64
+ Known fixed facts:
65
+
66
+ - Instance name: `FM LOGISTIC Google & Co`.
67
+ - Instance id: `cmgtgrz02000t04l501wbp459`.
68
+ - Instance slug: `fm-logistic`.
69
+ - Main language: `fr`.
70
+
71
+ Common work:
72
+
73
+ - Add or audit webinar replays.
74
+ - Upload Drive recordings to GCS-backed GSkills resources.
75
+ - Keep AI webinars restricted to the right audience.
76
+ - Verify the end-user webinar page and custom video player.
77
+
78
+ Important rule:
79
+
80
+ - AI webinars should keep the French `IA` application/category attached.
81
+ - FM has a manual group named `Groupe AVEC IA` with inverted visibility. Do not add a broad active application like Google Workspace unless the user explicitly wants broader access.
82
+
83
+ Use the `fm-logistic-webinar-ingestion` skill for detailed webinar work.
84
+
85
+ ## LGCF
86
+
87
+ LGCF often appears in technical rollout, Google Group access, feedback, and success-story work.
88
+
89
+ Common work:
90
+
91
+ - Google Chat and Gmail context checks before drafting client replies.
92
+ - Security group or Google Group behavior.
93
+ - Progression quiz feedback.
94
+ - Leaderboard and adjusted-points investigations, especially when unavailable quiz history changes visible ranking.
95
+ - Success-story outreach drafts.
96
+
97
+ Known context:
98
+
99
+ - Known Google Chat space: `LGCF & Numericoach | GSkills Technique IT`, `spaces/AAQACgXH1kQ`.
100
+ - A known feedback case involved leaderboard ordering versus raw points. Verify whether the complaint is raw progress, visible ranking, adjusted points, or course activity before digging.
101
+
102
+ ## V&B
103
+
104
+ V&B has appeared in feedback triage around evaluation quiz behavior.
105
+
106
+ Common work:
107
+
108
+ - Quiz or evaluation feedback checks.
109
+ - Treat as a feedback-backed investigation. Verify the exact feedback row and current quiz state before describing the issue.
110
+
111
+ ## Seine Yonne
112
+
113
+ Seine Yonne has appeared in access/login diagnosis.
114
+
115
+ Common work:
116
+
117
+ - Granular account allowlist checks.
118
+ - Login denial troubleshooting.
119
+
120
+ Known context:
121
+
122
+ - One prior issue was that `dmoindrot@farmidable.fr` was not in `accountGranular`, while `dmoindrot@seineyonne.fr` was.
123
+ - Do not collapse similar emails into one access story.
124
+
125
+ ## Euromaster
126
+
127
+ Euromaster has appeared in sync and broad repair work.
128
+
129
+ Common work:
130
+
131
+ - Page-only or pages plus parcours synchronisation.
132
+ - Post-sync verification.
133
+ - Data repair blast-radius checks.
134
+
135
+ ## Commune de Divonne-les-Bains, AS de Pic, 360 Courtage
136
+
137
+ These have appeared as new-client style pushes.
138
+
139
+ Common work:
140
+
141
+ - Broad first synchronisation from global.
142
+ - High created counts are expected.
143
+ - Run `client-content` diff first, then apply, then verify menus and deploy cache.
144
+
145
+ ## Nickel Banque
146
+
147
+ Nickel Banque has appeared in feedback instance selection and page-family parity context.
148
+
149
+ Common work:
150
+
151
+ - Feedback routing or instance attribution checks.
152
+ - Verify the actual route context, target instance, and content family before repairing.
153
+
154
+ ## Terega
155
+
156
+ Terega has appeared as a one-off client synchronisation target.
157
+
158
+ Common work:
159
+
160
+ - Treat as normal client-content sync unless the live logs say otherwise.
161
+ - Resolve the instance id and check recent sync logs before applying.
162
+
163
+ ## Euralis, Orqual, Groupe Kiosque, UTT Yarns
164
+
165
+ These have appeared in broad data repair blast-radius checks.
166
+
167
+ Common work:
168
+
169
+ - Verify current state before touching anything.
170
+ - Do not infer a recurring product rule only because they were touched by a previous multi-instance repair.
171
+
172
+ ## Instance Mere And Global
173
+
174
+ Global is the source of truth for shared content.
175
+
176
+ Common work:
177
+
178
+ - Create or update global courses, tutorials, granules, modules, quizzes, parcours, badges, menus, resources, and base de connaissance content.
179
+ - Compare global to a client instance before sync.
180
+ - Keep client customizations intact unless the user explicitly wants to overwrite or repair them.
@@ -0,0 +1,97 @@
1
+ ---
2
+ name: gskills-vocabulary
3
+ description: Use when an agent explains GSkills operations to admins, writes summaries after CLI work, drafts messages about GSkills entities, or translates raw CLI/database concepts into the product vocabulary.
4
+ ---
5
+
6
+ # GSkills Vocabulary
7
+
8
+ Use this skill whenever you talk to a human about GSkills operations. The CLI is not the story. It is just a way for an authorized agent to contact GSkills servers.
9
+
10
+ ## Core Rule
11
+
12
+ Never make the conversation sound technical unless the user explicitly asks for implementation details.
13
+
14
+ Good:
15
+
16
+ - "J'ai demandé a GSkills de mettre a jour le parcours."
17
+ - "Je vais verifier les feedbacks et l'activite de l'utilisateur."
18
+ - "Le contenu est pret a etre pousse vers Air Liquide."
19
+
20
+ Avoid with non-dev admins:
21
+
22
+ - "J'ai appele l'API."
23
+ - "J'ai modifie une ressource CRUD."
24
+ - "La table Prisma a ete update."
25
+ - "Le payload JSON a ete envoye."
26
+ - "Le CLI a mute la row."
27
+
28
+ Commands, ids, JSON, and table names are fine in command blocks or agent notes. Translate them before speaking to admins.
29
+
30
+ ## Product Vocabulary
31
+
32
+ - `learning path` means `parcours` in French.
33
+ - `category app`, `category application`, and `thematic` are spoken as `application`.
34
+ - `page` is usually not spoken as `page`. Prefer the pedagogical word that fits the context: `cours`, `tutoriel`, `granule`, or `module`.
35
+ - `tickets` are `feedbacks`.
36
+ - `base de co` and `base de connaissance` mean the end-user internal knowledge area. It regroups tutorial content, internal knowledge videos, webinars, documents, guides, and other resources.
37
+ - `internal knowledge` is `base de connaissance` or `contenu de base de connaissance` depending on the sentence.
38
+ - `resources` are `ressources`, such as webinars, replays, guides, documents, magazines, or useful links.
39
+ - `access pass` is an `acces`.
40
+ - `entity`, `group`, `org unit`, and `Google group` should become `groupe`, `groupe Google`, or `OU` depending on the real object.
41
+ - `feature flag` should usually become `parametre`, `option`, or `activation`.
42
+ - `workflow` should usually become `automatisation`.
43
+ - `cache invalidate` should become `rafraichir le cache` or `rafraichir le contenu`.
44
+ - `sync` should become `synchronisation` or `pousser le contenu`.
45
+ - `global` is the source instance or `instance mere`, not a customer.
46
+ - `instance` can stay `instance` with internal admins, but for clients prefer `espace client` or the client name.
47
+
48
+ ## Speaking About Activity
49
+
50
+ Use product words:
51
+
52
+ - `user-paths` means completed courses, tutorials, granules, or modules.
53
+ - `quiz-attempts` means quiz attempts and quiz completion.
54
+ - `user-badges` means badges obtained by the user.
55
+ - `user-learning-paths` means parcours progress.
56
+ - `user-learning-path-item-completions` means completed steps inside a parcours.
57
+ - `chromebook-progress` means Chromebook game progress.
58
+
59
+ Do not tell a non-dev admin "I updated user-paths". Say the user is now marked as having completed the course, then mention the technical row only if the user asks for proof.
60
+
61
+ ## Examples
62
+
63
+ Technical note:
64
+
65
+ ```text
66
+ Updated user-paths row cm... with isAchieved=true.
67
+ ```
68
+
69
+ Admin-facing wording:
70
+
71
+ ```text
72
+ J'ai marque le cours comme termine pour l'utilisateur et j'ai reverifie son activite.
73
+ ```
74
+
75
+ Technical note:
76
+
77
+ ```text
78
+ Ran sync diff with preset client-content.
79
+ ```
80
+
81
+ Admin-facing wording:
82
+
83
+ ```text
84
+ J'ai compare le contenu a pousser avant de lancer la synchronisation.
85
+ ```
86
+
87
+ Technical note:
88
+
89
+ ```text
90
+ Invalidated pages cache.
91
+ ```
92
+
93
+ Admin-facing wording:
94
+
95
+ ```text
96
+ J'ai rafraichi le contenu pour que les changements remontent cote utilisateur.
97
+ ```