opencode-skills-collection 4.1.0 → 4.1.2

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.
Files changed (219) hide show
  1. package/README.md +46 -42
  2. package/bundled-skills/.antigravity-install-manifest.json +127 -1
  3. package/bundled-skills/360-feedback-system/SKILL.md +481 -0
  4. package/bundled-skills/access-matrix/SKILL.md +338 -0
  5. package/bundled-skills/accounting-audit-system-builder/SKILL.md +302 -0
  6. package/bundled-skills/accounting-audit-system-builder/references/catalog.md +114 -0
  7. package/bundled-skills/accounting-software-selection/SKILL.md +427 -0
  8. package/bundled-skills/accounting-software-selection/references/build-artifacts.md +362 -0
  9. package/bundled-skills/accounting-software-selection/references/common-pitfalls.md +44 -0
  10. package/bundled-skills/accounting-software-selection/references/field-reference.md +93 -0
  11. package/bundled-skills/accounting-software-selection/references/select-options.md +202 -0
  12. package/bundled-skills/admin-access-register/SKILL.md +381 -0
  13. package/bundled-skills/advanced-analytics-dashboard/SKILL.md +318 -0
  14. package/bundled-skills/ai-image-generation-studio/SKILL.md +259 -0
  15. package/bundled-skills/ai-logo-maker/SKILL.md +259 -0
  16. package/bundled-skills/ai-multilingual-dubbing/SKILL.md +259 -0
  17. package/bundled-skills/ai-photo-restyler/SKILL.md +259 -0
  18. package/bundled-skills/ai-podcast-voiceover/SKILL.md +259 -0
  19. package/bundled-skills/alumni-re-hire-tracker/SKILL.md +314 -0
  20. package/bundled-skills/announcement-board/SKILL.md +336 -0
  21. package/bundled-skills/antigravity-maintainer-batch-release/SKILL.md +48 -3
  22. package/bundled-skills/asset-it-management/SKILL.md +407 -0
  23. package/bundled-skills/attendance/SKILL.md +331 -0
  24. package/bundled-skills/audit-log/SKILL.md +314 -0
  25. package/bundled-skills/audit-preparation/SKILL.md +416 -0
  26. package/bundled-skills/beatra/SKILL.md +260 -0
  27. package/bundled-skills/board-governance/SKILL.md +360 -0
  28. package/bundled-skills/brand-growth-system-builder/SKILL.md +360 -0
  29. package/bundled-skills/brand-kit-print-collateral/SKILL.md +498 -0
  30. package/bundled-skills/buddy-program-manager/SKILL.md +329 -0
  31. package/bundled-skills/budget-cash-flow/SKILL.md +352 -0
  32. package/bundled-skills/busabase/SKILL.md +118 -0
  33. package/bundled-skills/business-email-template/SKILL.md +480 -0
  34. package/bundled-skills/business-email-template/references/common-pitfalls.md +30 -0
  35. package/bundled-skills/business-website-setup/SKILL.md +489 -0
  36. package/bundled-skills/business-website-setup/references/common-pitfalls.md +32 -0
  37. package/bundled-skills/candidate-talent-pool/SKILL.md +359 -0
  38. package/bundled-skills/capacity-workload-planner/SKILL.md +354 -0
  39. package/bundled-skills/changelog-entry/SKILL.md +141 -0
  40. package/bundled-skills/clients-accounts/SKILL.md +398 -0
  41. package/bundled-skills/code-of-conduct/SKILL.md +488 -0
  42. package/bundled-skills/code-of-conduct/references/common-pitfalls.md +31 -0
  43. package/bundled-skills/company-email-accounts/SKILL.md +404 -0
  44. package/bundled-skills/competency-matrix/SKILL.md +335 -0
  45. package/bundled-skills/contract-document-renewal/SKILL.md +396 -0
  46. package/bundled-skills/course-upskilling-requests/SKILL.md +354 -0
  47. package/bundled-skills/credit-cycle-analysis/SKILL.md +303 -0
  48. package/bundled-skills/credit-cycle-analysis/references/best-practices.md +35 -0
  49. package/bundled-skills/credit-cycle-analysis/references/common-pitfalls.md +5 -0
  50. package/bundled-skills/credit-cycle-analysis/references/examples.md +34 -0
  51. package/bundled-skills/credit-cycle-analysis/references/field-reference.md +47 -0
  52. package/bundled-skills/credit-cycle-analysis/references/how-it-works.md +494 -0
  53. package/bundled-skills/credit-cycle-analysis/references/security-notes.md +16 -0
  54. package/bundled-skills/credit-cycle-analysis/references/select-options.md +32 -0
  55. package/bundled-skills/csv-manual-export/SKILL.md +499 -0
  56. package/bundled-skills/csv-manual-export/references/common-pitfalls.md +19 -0
  57. package/bundled-skills/culture-retention/SKILL.md +346 -0
  58. package/bundled-skills/data-export-engine/SKILL.md +308 -0
  59. package/bundled-skills/data-privacy-controls/SKILL.md +317 -0
  60. package/bundled-skills/day-book/SKILL.md +499 -0
  61. package/bundled-skills/day-book/references/best-practices.md +32 -0
  62. package/bundled-skills/day-book/references/common-pitfalls.md +58 -0
  63. package/bundled-skills/day-book/references/field-reference.md +45 -0
  64. package/bundled-skills/day-book/references/how-it-works.md +7 -0
  65. package/bundled-skills/day-book/references/related-skills.md +18 -0
  66. package/bundled-skills/day-book/references/relations.md +14 -0
  67. package/bundled-skills/day-book/references/reusable-prompt.md +50 -0
  68. package/bundled-skills/day-book/references/security-safety-notes.md +19 -0
  69. package/bundled-skills/day-book/references/select-options.md +38 -0
  70. package/bundled-skills/dei-dashboard/SKILL.md +307 -0
  71. package/bundled-skills/design-theme-guide/SKILL.md +472 -0
  72. package/bundled-skills/disciplinary-pip-tracker/SKILL.md +345 -0
  73. package/bundled-skills/document-management-system/SKILL.md +328 -0
  74. package/bundled-skills/ecommerce-listing-image-set/SKILL.md +259 -0
  75. package/bundled-skills/employee-suggestion-hub/SKILL.md +322 -0
  76. package/bundled-skills/esop-equity-tracker/SKILL.md +331 -0
  77. package/bundled-skills/events-activities/SKILL.md +355 -0
  78. package/bundled-skills/expense-accounting/SKILL.md +496 -0
  79. package/bundled-skills/expense-accounting/references/common-pitfalls.md +41 -0
  80. package/bundled-skills/expense-accounting/references/related-skills.md +11 -0
  81. package/bundled-skills/expense-accounting/references/reusable-prompt.md +36 -0
  82. package/bundled-skills/expense-management/SKILL.md +351 -0
  83. package/bundled-skills/free-design-resources/SKILL.md +480 -0
  84. package/bundled-skills/free-design-resources/references/common-pitfalls.md +44 -0
  85. package/bundled-skills/free-design-resources/references/related-skills.md +24 -0
  86. package/bundled-skills/free-design-resources/references/reusable-prompt.md +12 -0
  87. package/bundled-skills/gamification-engine/SKILL.md +307 -0
  88. package/bundled-skills/gbp-local-seo-intent/SKILL.md +466 -0
  89. package/bundled-skills/gbp-local-seo-intent/references/best-practices.md +41 -0
  90. package/bundled-skills/gbp-local-seo-intent/references/common-pitfalls.md +40 -0
  91. package/bundled-skills/gbp-local-seo-intent/references/related-skills.md +17 -0
  92. package/bundled-skills/gbp-local-seo-intent/references/reusable-prompt.md +11 -0
  93. package/bundled-skills/gbp-local-seo-intent/references/security-safety-notes.md +27 -0
  94. package/bundled-skills/health-wellness/SKILL.md +334 -0
  95. package/bundled-skills/intern-program/SKILL.md +354 -0
  96. package/bundled-skills/internal-communication/SKILL.md +318 -0
  97. package/bundled-skills/inventory-stock-reconciliation/SKILL.md +470 -0
  98. package/bundled-skills/inventory-stock-reconciliation/references/best-practices.md +18 -0
  99. package/bundled-skills/inventory-stock-reconciliation/references/common-pitfalls.md +42 -0
  100. package/bundled-skills/inventory-stock-reconciliation/references/related-skills.md +13 -0
  101. package/bundled-skills/inventory-stock-reconciliation/references/relations.md +8 -0
  102. package/bundled-skills/inventory-stock-reconciliation/references/reusable-prompt.md +31 -0
  103. package/bundled-skills/inventory-stock-reconciliation/references/security-safety-notes.md +17 -0
  104. package/bundled-skills/inventory-stock-reconciliation/references/select-options.md +45 -0
  105. package/bundled-skills/invoices-billing/SKILL.md +385 -0
  106. package/bundled-skills/issue-grievance-tracker/SKILL.md +400 -0
  107. package/bundled-skills/json-schema-manual/SKILL.md +309 -0
  108. package/bundled-skills/json-schema-manual/references/best-practices.md +9 -0
  109. package/bundled-skills/json-schema-manual/references/common-pitfalls.md +25 -0
  110. package/bundled-skills/json-schema-manual/references/input-modules.md +203 -0
  111. package/bundled-skills/json-schema-manual/references/related-skills.md +8 -0
  112. package/bundled-skills/json-schema-manual/references/reusable-prompt.md +10 -0
  113. package/bundled-skills/json-schema-manual/references/security-safety-notes.md +13 -0
  114. package/bundled-skills/knowledge-base/SKILL.md +318 -0
  115. package/bundled-skills/kpi-tracker/SKILL.md +345 -0
  116. package/bundled-skills/learning-career-development/SKILL.md +349 -0
  117. package/bundled-skills/leave-management/SKILL.md +341 -0
  118. package/bundled-skills/legal-compliance-vault/SKILL.md +324 -0
  119. package/bundled-skills/linktree-link-hub/SKILL.md +453 -0
  120. package/bundled-skills/logo-image-design/SKILL.md +459 -0
  121. package/bundled-skills/loki-mode/examples/todo-app-generated/backend/package-lock.json +3 -3
  122. package/bundled-skills/loki-mode/examples/todo-app-generated/backend/package.json +2 -1
  123. package/bundled-skills/mentorship-program/SKILL.md +332 -0
  124. package/bundled-skills/mirrord/SKILL.md +90 -0
  125. package/bundled-skills/monthly-closing-statements/SKILL.md +488 -0
  126. package/bundled-skills/monthly-closing-statements/references/related-skills.md +17 -0
  127. package/bundled-skills/monthly-closing-statements/references/reusable-prompt.md +8 -0
  128. package/bundled-skills/music-generation-studio/SKILL.md +259 -0
  129. package/bundled-skills/notification-reminder-hub/SKILL.md +324 -0
  130. package/bundled-skills/notion-manual-import/SKILL.md +376 -0
  131. package/bundled-skills/notion-manual-import/references/best-practices.md +10 -0
  132. package/bundled-skills/notion-manual-import/references/common-pitfalls.md +26 -0
  133. package/bundled-skills/notion-manual-import/references/input-modules.md +203 -0
  134. package/bundled-skills/notion-manual-import/references/related-skills.md +7 -0
  135. package/bundled-skills/notion-manual-import/references/reusable-prompt.md +8 -0
  136. package/bundled-skills/notion-manual-import/references/security-safety-notes.md +15 -0
  137. package/bundled-skills/observability-cloud-planning/SKILL.md +487 -0
  138. package/bundled-skills/observability-cloud-planning/references/common-pitfalls.md +39 -0
  139. package/bundled-skills/observability-cloud-planning/references/related-skills.md +20 -0
  140. package/bundled-skills/observability-cloud-planning/references/reusable-prompt.md +12 -0
  141. package/bundled-skills/observability-cloud-planning/references/security-safety-notes.md +30 -0
  142. package/bundled-skills/offboarding-exit/SKILL.md +343 -0
  143. package/bundled-skills/offer-appointment/SKILL.md +351 -0
  144. package/bundled-skills/okr-system/SKILL.md +355 -0
  145. package/bundled-skills/omentir-linkedin-outreach/SKILL.md +96 -0
  146. package/bundled-skills/onboarding-playbook/SKILL.md +292 -0
  147. package/bundled-skills/organization-design/SKILL.md +324 -0
  148. package/bundled-skills/party-ledger-reconciliation/SKILL.md +411 -0
  149. package/bundled-skills/payment-accounting/SKILL.md +421 -0
  150. package/bundled-skills/payments-received/SKILL.md +315 -0
  151. package/bundled-skills/payroll-finance/SKILL.md +351 -0
  152. package/bundled-skills/people-directory/SKILL.md +459 -0
  153. package/bundled-skills/performance-management/SKILL.md +367 -0
  154. package/bundled-skills/petty-cash-management/SKILL.md +448 -0
  155. package/bundled-skills/policy-acknowledgement/SKILL.md +314 -0
  156. package/bundled-skills/policy-library/SKILL.md +327 -0
  157. package/bundled-skills/poster-design-studio/SKILL.md +259 -0
  158. package/bundled-skills/pre-boarding/SKILL.md +326 -0
  159. package/bundled-skills/presentation-deck/SKILL.md +491 -0
  160. package/bundled-skills/presentation-deck/references/related-skills.md +19 -0
  161. package/bundled-skills/presentation-deck/references/reusable-prompt.md +11 -0
  162. package/bundled-skills/probation-tracker/SKILL.md +347 -0
  163. package/bundled-skills/product-photo-studio/SKILL.md +259 -0
  164. package/bundled-skills/project-based-performance/SKILL.md +323 -0
  165. package/bundled-skills/projects-work-management/SKILL.md +368 -0
  166. package/bundled-skills/promotion-upgrade-requests/SKILL.md +377 -0
  167. package/bundled-skills/purchase-accounting/SKILL.md +414 -0
  168. package/bundled-skills/receipt-accounting/SKILL.md +424 -0
  169. package/bundled-skills/recognition-rewards/SKILL.md +324 -0
  170. package/bundled-skills/recruitment-pipeline/SKILL.md +399 -0
  171. package/bundled-skills/remote-work-tracker/SKILL.md +306 -0
  172. package/bundled-skills/reports-analytics/SKILL.md +320 -0
  173. package/bundled-skills/salary-benchmarking/SKILL.md +318 -0
  174. package/bundled-skills/salary-wage-accounting/SKILL.md +412 -0
  175. package/bundled-skills/sales-accounting/SKILL.md +494 -0
  176. package/bundled-skills/sales-accounting/references/common-pitfalls.md +28 -0
  177. package/bundled-skills/sales-accounting/references/related-skills.md +13 -0
  178. package/bundled-skills/sales-accounting/references/reusable-prompt.md +8 -0
  179. package/bundled-skills/seo-directory-backlinks/SKILL.md +484 -0
  180. package/bundled-skills/seo-directory-backlinks/references/common-pitfalls.md +36 -0
  181. package/bundled-skills/seo-directory-backlinks/references/related-skills.md +15 -0
  182. package/bundled-skills/seo-directory-backlinks/references/reusable-prompt.md +11 -0
  183. package/bundled-skills/since-cutoff/SKILL.md +68 -0
  184. package/bundled-skills/skill-gap-analysis/SKILL.md +338 -0
  185. package/bundled-skills/social-media-setup/SKILL.md +477 -0
  186. package/bundled-skills/social-media-setup/references/common-pitfalls.md +34 -0
  187. package/bundled-skills/social-media-setup/references/related-skills.md +19 -0
  188. package/bundled-skills/social-media-setup/references/reusable-prompt.md +11 -0
  189. package/bundled-skills/social-media-setup/references/security-safety-notes.md +27 -0
  190. package/bundled-skills/sop-company-wiki/SKILL.md +324 -0
  191. package/bundled-skills/source-document-filing/SKILL.md +368 -0
  192. package/bundled-skills/spreadsheet-manual-build/SKILL.md +493 -0
  193. package/bundled-skills/spreadsheet-manual-build/references/best-practices.md +9 -0
  194. package/bundled-skills/spreadsheet-manual-build/references/common-pitfalls.md +22 -0
  195. package/bundled-skills/spreadsheet-manual-build/references/related-skills.md +8 -0
  196. package/bundled-skills/spreadsheet-manual-build/references/reusable-prompt.md +9 -0
  197. package/bundled-skills/spreadsheet-manual-build/references/security-safety-notes.md +16 -0
  198. package/bundled-skills/stakeholder-investor-reports/SKILL.md +303 -0
  199. package/bundled-skills/suno-lyrics-to-song/SKILL.md +259 -0
  200. package/bundled-skills/talking-avatar-video/SKILL.md +260 -0
  201. package/bundled-skills/tax-register/SKILL.md +363 -0
  202. package/bundled-skills/tds-booking-payment/SKILL.md +405 -0
  203. package/bundled-skills/team-calendar/SKILL.md +312 -0
  204. package/bundled-skills/telegram/assets/boilerplate/nodejs/package-lock.json +3 -3
  205. package/bundled-skills/telegram/assets/boilerplate/nodejs/package.json +1 -0
  206. package/bundled-skills/template-library/SKILL.md +304 -0
  207. package/bundled-skills/time-tracking/SKILL.md +353 -0
  208. package/bundled-skills/vendor-contractor-management/SKILL.md +327 -0
  209. package/bundled-skills/viral-video-teardown-remake/SKILL.md +260 -0
  210. package/bundled-skills/voice-cloning-studio/SKILL.md +260 -0
  211. package/bundled-skills/voiceover-narration-studio/SKILL.md +259 -0
  212. package/bundled-skills/whatsapp-cloud-api/assets/boilerplate/nodejs/package-lock.json +3 -3
  213. package/bundled-skills/whatsapp-cloud-api/assets/boilerplate/nodejs/package.json +1 -0
  214. package/dist/skill-pointer/index.d.ts +2 -1
  215. package/dist/skill-pointer/index.js +2 -1
  216. package/dist/skill-pointer/pointer-generator.d.ts +4 -2
  217. package/dist/skill-pointer/pointer-generator.js +4 -2
  218. package/package.json +1 -1
  219. package/skills_index.json +4312 -0
@@ -0,0 +1,318 @@
1
+ ---
2
+ name: advanced-analytics-dashboard
3
+ description: 'Dashboard metric register: metric, source module, formula, period, value, target, trend, owner and last-updated, as CSV, SQL, JSON Schema or Notion on request. Use for KPI dashboards.'
4
+ category: business
5
+ risk: safe
6
+ source: self
7
+ source_type: self
8
+ date_added: '2026-09-26'
9
+ author: WHOISABHISHEKADHIKARI
10
+ tags:
11
+ - sme
12
+ - business
13
+ - operations
14
+ - database
15
+ - csv
16
+ - notion
17
+ - sql
18
+ - analyze
19
+ tools: []
20
+ source_repo: WHOISABHISHEKADHIKARI/sme-ops-system-builder
21
+ ---
22
+
23
+ # Advanced Analytics Dashboard
24
+
25
+ **What it is:** A register for analytics metrics and their sources; it does not train or run predictive models.
26
+
27
+ ## Overview
28
+
29
+ Works out the smallest useful **Advanced Analytics Dashboard** setup for the business in front of it, then
30
+ builds it only when asked. The default output is a short recommendation, not a
31
+ spreadsheet. Artifacts - CSV, SQL DDL, JSON Schema, Notion mapping - are produced on
32
+ request, from one field list so they cannot drift apart.
33
+
34
+ Layer: Layer 9: Analyze. Fits: Scale stage. Table code: n/a.
35
+
36
+ ## When to Use This Skill
37
+
38
+ - analytics dashboard
39
+ - predictive metrics
40
+ - kpi dashboard template
41
+ - business metrics dashboard
42
+
43
+ Also use it when the user says "predictive insights", or describes the same process happening in a
44
+ spreadsheet, a document or someone inboxes.
45
+
46
+ Do not use it for: payroll calculation, tax filing, or legal advice. This skill produces
47
+ empty templates only - it never holds or processes real employee or customer data.
48
+
49
+ ## How It Works
50
+
51
+ Follow the shared execution contract. The module-specific rules below define only domain fields, decisions, calculations, and safety constraints.
52
+
53
+ ### Step 1 - Identify intent
54
+
55
+ Read the request and pick the intent before asking anything.
56
+
57
+ - "set up" or "build" or "create" -> the user wants artifacts; go to Step 2.
58
+ - "our process is ..." or "it is in a sheet" -> the user wants to move an existing process; capture it, then Step 2.
59
+ - "is this right" or "review" or "audit" -> the user wants a check, not a build; answer from what they share.
60
+ - "how do I ..." -> advice question; answer directly and offer the build only if it helps.
61
+
62
+ Ask only if this is the highest-value missing fact; otherwise proceed without an opener:
63
+
64
+ > **Q:** Which decision is the dashboard meant to support?
65
+
66
+ ### Step 2 - Ask only what is missing
67
+
68
+ Skip anything the user already answered, in any earlier message. Ask the rest one at a
69
+ time, and stop as soon as the remaining answers would not change the output.
70
+
71
+ - **Decision** - Which decision? / Who makes it? / How often?
72
+ - **Data** - Which sources? / How many rows? / How fresh does it need to be?
73
+ - **Measures** - Which metrics? / How many? / Compared against what?
74
+ - **Current process** - Do you have a dashboard? / Manual or tool-based? / Is it trusted?
75
+ - **Outcome** - What do you need? / A metric set, a layout or both?
76
+
77
+ Never invent an answer. If the user does not know, record it as unknown and carry on.
78
+
79
+ ### Step 3 - Hold the internal context
80
+
81
+ Hold the answers in this shape. It stays internal - it is not shown to the user unless
82
+ they ask, and it never carries a value the user did not give.
83
+
84
+ ```yaml
85
+ module: advanced-analytics-dashboard
86
+ intent: null # setup | advice | review | fix | build | convert | export
87
+ scale: null # Starter | Growth | Scale, only if the answer changes it
88
+ areas:
89
+ "Decision": null
90
+ "Data": null
91
+ "Measures": null
92
+ "Current process": null
93
+ "Outcome": null
94
+ requested_outputs: [] # csv | sql | json | notion | xlsx - requested formats only
95
+ confirmed_facts: [] # only what the user actually said
96
+ open_questions: [] # the unanswered ones, in the order worth asking
97
+ ```
98
+
99
+ ### Step 4 - Recommend the smallest workflow
100
+
101
+ If an artifact was requested, build it after resolving essential missing facts. Otherwise give a short recommendation and offer the relevant artifact.
102
+
103
+ **Recommended approach:** Start with the decision, then add one metric per part of it. Layout is a late decision and rarely the problem.
104
+
105
+ **Why this one:** Dashboards fail from metric sprawl, not from design. Fix the decision and the metric count first, and the layout follows.
106
+
107
+ **Workflow:** Metric defined → Source data → Calculation → Refresh → Decision review
108
+
109
+ ### Step 5 - Build only on request
110
+
111
+ Once the user asks for it, derive the fields from the confirmed context and emit the
112
+ requested artifacts. For machine-readable text, keep prose outside the data; for files,
113
+ provide a usable link. Report material validation failures or limitations separately.
114
+
115
+ **A selected Notion output is rendered by `notion-manual-import`, so route the
116
+ Notion step there.** When the user selects Notion, hand that step to
117
+ @notion-manual-import: it holds the CSV, the property
118
+ mapping, the import steps and the verification checklist, and it renders the Field
119
+ Reference below instead of defining a table of its own. Do not restate the mapping
120
+ here and do not improvise the import steps. Manual CSV and mapping outputs need no
121
+ connection. For requested workspace changes, follow the shared contract: verify actual
122
+ tool access and the target before writing. A user saying "connected" is not tool evidence.
123
+ Never ask for a Notion password or token.
124
+
125
+ For an Excel-compatible CSV, use UTF-8 with a byte order mark so Excel opens the
126
+ text correctly. A CSV is not an `.xlsx` workbook; create `.xlsx` only when the user
127
+ requests a workbook.
128
+ A CSV carries no types, so after it, name the columns
129
+ that need a number, date or currency format applied.
130
+
131
+ ```csv
132
+ Metric,Category,Source Module,Formula or Method,Period,Value,Target,Trend,Owner,Last Updated,Metric ID
133
+ Net revenue,General,Invoices & Billing,"Revenue invoiced minus credits, divided by active clients.",2026-03,1000,100,Up 3 months running,Example Owner,2026-01-15,
134
+ ```
135
+
136
+ ```sql
137
+ CREATE TABLE advanced_analytics_dashboard (
138
+ metric VARCHAR(255),
139
+ category VARCHAR(100) NOT NULL,
140
+ source_module VARCHAR(255),
141
+ formula_or_method VARCHAR(255),
142
+ period VARCHAR(255),
143
+ value NUMERIC NOT NULL,
144
+ target NUMERIC NOT NULL,
145
+ trend VARCHAR(255),
146
+ owner VARCHAR(255),
147
+ last_updated DATE NOT NULL,
148
+ metric_id SERIAL PRIMARY KEY,
149
+ created_at TIMESTAMP DEFAULT NOW(),
150
+ updated_at TIMESTAMP DEFAULT NOW()
151
+ );
152
+ ```
153
+
154
+ ```json
155
+ {
156
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
157
+ "title": "Advanced Analytics Dashboard",
158
+ "type": "object",
159
+ "additionalProperties": false,
160
+ "properties": {
161
+ "Metric": { "type": "string" },
162
+ "Category": { "type": "string" },
163
+ "Source Module": { "type": "string" },
164
+ "Formula or Method": { "type": "string" },
165
+ "Period": { "type": "string" },
166
+ "Value": { "type": "number" },
167
+ "Target": { "type": "number" },
168
+ "Trend": { "type": "string" },
169
+ "Owner": { "type": "string" },
170
+ "Last Updated": { "type": "string", "format": "date" },
171
+ "Metric ID": { "type": "integer" }
172
+ },
173
+ "required": [
174
+ "Category",
175
+ "Value",
176
+ "Target",
177
+ "Last Updated"
178
+ ]
179
+ }
180
+ ```
181
+
182
+ ```markdown
183
+ | CSV column | Notion property | Set after import |
184
+ |---|---|---|
185
+ | Metric | Title | Use as the database title |
186
+ | Category | Select (add options after import) | Convert to Select, add options: "General", "Operations", "Finance", "People", "Compliance" |
187
+ | Source Module | Text | Leave as Text |
188
+ | Formula or Method | Text | Leave as Text |
189
+ | Period | Text | Leave as Text |
190
+ | Value | Number | Convert to Number |
191
+ | Target | Number | Convert to Number |
192
+ | Trend | Text | Leave as Text |
193
+ | Owner | Text | Leave as Text |
194
+ | Last Updated | Date | Convert to Date |
195
+ | Metric ID | Text (preserve source ID) | Keep imported IDs as Text; optionally add a separate Unique ID property |
196
+ ```
197
+
198
+ The rows above are documentation examples only. Emit empty templates unless the user explicitly requests examples. Money stays `currency`, dates stay `date`,
199
+ and anything pointing at another table stays `relation`.
200
+
201
+ ## Field Reference
202
+
203
+ | # | Field | Type | SQL | JSON Schema | Notion | CSV example |
204
+ |---:|---|---|---|---|---|---|
205
+ | 1 | Metric | `text` | `VARCHAR(255)` | `string` | Text | `Net revenue` |
206
+ | 2 | Category | `select` | `VARCHAR(100)` | `string` | Select (add options after import) | `General` |
207
+ | 3 | Source Module | `text` | `VARCHAR(255)` | `string` | Text | `Invoices & Billing` |
208
+ | 4 | Formula or Method | `text` | `VARCHAR(255)` | `string` | Text | `Revenue invoiced minus credits, divided by active clients.` |
209
+ | 5 | Period | `text` | `VARCHAR(255)` | `string` | Text | `2026-03` |
210
+ | 6 | Value | `number` | `NUMERIC` | `number` | Number | `1000` |
211
+ | 7 | Target | `number` | `NUMERIC` | `number` | Number | `100` |
212
+ | 8 | Trend | `text` | `VARCHAR(255)` | `string` | Text | `Up 3 months running` |
213
+ | 9 | Owner | `text` | `VARCHAR(255)` | `string` | Text | `Example Owner` |
214
+ | 10 | Last Updated | `date` | `DATE` | `string, format: date` | Date | `2026-01-15` |
215
+ | 11 | Metric ID | `id` | `SERIAL PRIMARY KEY` | `integer` | Text (preserve source ID) | `(blank)` |
216
+
217
+ ## Select Options
218
+
219
+ **Category**
220
+
221
+ ```
222
+ General | Operations | Finance | People | Compliance
223
+ ```
224
+
225
+ ## Relations
226
+
227
+ Link fields: none
228
+
229
+ ## Examples
230
+
231
+ **Prompt**
232
+
233
+ ```
234
+ We have a dashboard with 30 tiles that nobody uses.
235
+ ```
236
+
237
+ **Context first** - one question per message, nothing already answered:
238
+
239
+ > **Q:** Which decision?
240
+ > **A:** Which projects need attention.
241
+ >
242
+ > **Q:** Data sources?
243
+ > **A:** Project tracker and accounting.
244
+ >
245
+ > **Q:** How often?
246
+ > **A:** Weekly.
247
+
248
+ **Recommended next step** - offered, not built:
249
+
250
+ > Start with the decision, then add one metric per part of it. Layout is a late decision and rarely the problem.
251
+ >
252
+ > Workflow: Metric defined → Source data → Calculation → Refresh → Decision review
253
+ >
254
+ > Want the CSV, SQL, JSON Schema and Notion mapping for this?
255
+
256
+ ## Best Practices
257
+
258
+ - Build when requested; recommend and offer a build for advice-only requests.
259
+ - One question per message. A batched intake reads as a form and gets guessed at.
260
+ - Keep display names identical across CSV and JSON; document normalized SQL identifiers.
261
+ - Use `relation` for anything that points at another table, `text` only for free text.
262
+ - Money fields are `currency`, never `text`. Dates are `date`, never free text.
263
+ - If the user requests an example row, keep it obviously fake so nobody imports it as real data.
264
+
265
+ ## Limitations
266
+
267
+ - Forecasts require supplied data, a specified model, evaluation evidence and uncertainty.
268
+ This template alone produces no predictions or verified insights.
269
+
270
+ - Empty template only. It does not compute payroll, tax, leave balances or KPIs.
271
+ - Notion relations need both databases imported before the link column resolves.
272
+ - Select options are a starting set. Rename them to match how the business talks.
273
+ - No automation, reminders or sync. Those need the integration layer.
274
+ - Does not connect to source systems, clean data or guarantee metric accuracy.
275
+ - Legal, tax and HR review is still required before this drives real decisions.
276
+
277
+ ## Security & Safety Notes
278
+
279
+ - Never fill in real names, salaries, medical or banking data. Placeholders only.
280
+ - Label example rows as synthetic, and keep bank details masked.
281
+ - Local reads, generation commands, and validation are part of a requested artifact build.
282
+ External writes, messages, provisioning, and publication require authorization for that
283
+ action and target; existing explicit authorization does not need to be repeated.
284
+ - If sensitive data is supplied, avoid repeating unnecessary identifiers. Use only what
285
+ the requested review needs; keep generated templates empty. Do not claim deletion
286
+ from the conversation or service storage.
287
+ - Privacy, legal and disciplinary cases need a qualified human reviewer before anything
288
+ is acted on.
289
+
290
+ ## Common Pitfalls
291
+
292
+ - **Problem:** a static mapping is described as a completed workspace build.
293
+ **Solution:** deliver manual mappings without a connection; claim a live change only
294
+ after the authorized tool operation succeeds.
295
+ - **Problem:** asked all six questions in one message.
296
+ **Solution:** ask one, wait, and drop any the first answer already covered.
297
+ - **Problem:** built a full system when one table was asked for.
298
+ **Solution:** build what was requested; mention the parent skill separately.
299
+ - **Problem:** all four artifacts drift apart.
300
+ **Solution:** derive all four from the field list in this file, never by hand.
301
+ - **Problem:** Notion import shows every column as Text.
302
+ **Solution:** that is expected. Apply the property mapping table once, after import.
303
+
304
+ ## Related Skills
305
+
306
+ - [Module Catalog](https://github.com/sickn33/agentic-awesome-skills/blob/main/CATALOG.md) - find the relevant module, then read its skill.
307
+ - @people-directory - the employee master record most modules link to.
308
+ - @notification-reminder-hub - turns due dates in this module into reminders.
309
+
310
+ ## Reusable Prompt
311
+
312
+ ```
313
+ I want to set up predictive insights for my company.
314
+ Ask me one short question at a time, and only about what I have not already told you.
315
+ Then recommend the smallest setup that fits, and wait for me to ask before you build it.
316
+ When I ask, output CSV, SQL DDL, JSON Schema, a Notion property mapping or an Excel workbook. Data only.
317
+ ```
318
+
@@ -0,0 +1,259 @@
1
+ ---
2
+ name: ai-image-generation-studio
3
+ description: "Install and use the official AI Image Generator package, pinned by digest, for paid hosted work on the Beatra service."
4
+ category: media
5
+ risk: critical
6
+ source: community
7
+ source_repo: beatra-ai/ai-image-generator-skill
8
+ source_type: official
9
+ date_added: "2026-09-18"
10
+ author: beatra-ai
11
+ tags: [image-generation, text-to-image, mcp, paid-api, beatra]
12
+ tools: [claude, codex, cursor, gemini]
13
+ license: "MIT-0"
14
+ license_source: "https://github.com/beatra-ai/ai-image-generator-skill/blob/13c7b9b2a2197fb91deb6a3a1466124db620c3d1/LICENSE"
15
+ ---
16
+
17
+ # AI Image Generator Skill
18
+
19
+ ## Overview
20
+
21
+ Generate, compose, and edit product images, brand visuals, posters, social graphics, illustrations, and photo variations, from inside Claude Code, Codex, or OpenClaw. The work is produced on the hosted, paid Beatra service
22
+ (`mcp.beatra.ai`).
23
+
24
+ This catalog entry is a **reviewed pointer, not the executable package**. It
25
+ contains no client code and performs no Beatra operation by itself. The package
26
+ it points to bundles three standard-library Python scripts that make network
27
+ calls, store a credential, and can replace their own files. Read
28
+ [Install](#install-pinned-verified-approved-twice) and
29
+ [Security & Safety Notes](#security--safety-notes) before activating it.
30
+
31
+ | Pinned identity | Value |
32
+ | --- | --- |
33
+ | Package | `ai-image-generation-studio` `0.1.4` |
34
+ | Archive | `https://cdn.beatra.ai/agent-packages/ai-image-generation-studio/v0.1.4/ai-image-generation-studio-skill-0.1.4.zip` |
35
+ | Archive SHA-256 | `b357edb0f9f2546435c89cf1ef8278596e28a7629229a78fcab9804decd13682` |
36
+ | Source tree | [`beatra-ai/ai-image-generator-skill@13c7b9b`](https://github.com/beatra-ai/ai-image-generator-skill/tree/13c7b9b2a2197fb91deb6a3a1466124db620c3d1/skills/ai-image-generation-studio) (full SHA `13c7b9b2a2197fb91deb6a3a1466124db620c3d1`) |
37
+ | License | MIT No Attribution (MIT-0) |
38
+
39
+ The archive holds regular files only (no symlinks, no executable bits, no
40
+ binaries). Confirm that with the inspect commands below. Every file must be
41
+ byte-identical to the source tree at the pinned commit.
42
+
43
+ ## When to Use This Skill
44
+
45
+ - Use when the user explicitly wants AI Image Generator work produced on Beatra and accepts that it is paid.
46
+ - Use when they have agreed to send prompts and any reference images to a third party.
47
+ - Do not use for local-only image editing or when no paid render was approved.
48
+
49
+ ## Install (pinned, verified, approved twice)
50
+
51
+ ### Step 1: Download and verify into a review directory
52
+
53
+ Explain that this downloads an external package from `cdn.beatra.ai`, then ask
54
+ for approval. Only after approval:
55
+
56
+ ```bash
57
+ umask 077
58
+ review_dir="$(mktemp -d)"
59
+ cd "$review_dir" || exit 1
60
+ curl -fsSLO "https://cdn.beatra.ai/agent-packages/ai-image-generation-studio/v0.1.4/ai-image-generation-studio-skill-0.1.4.zip"
61
+ printf '%s %s\n' \
62
+ 'b357edb0f9f2546435c89cf1ef8278596e28a7629229a78fcab9804decd13682' \
63
+ 'ai-image-generation-studio-skill-0.1.4.zip' | shasum -a 256 -c -
64
+ ```
65
+
66
+ Stop if the check does not print `OK`. The expected digest comes from this
67
+ catalog entry, not from a file on the same CDN.
68
+
69
+ ### Step 2: Inspect before activation
70
+
71
+ ```bash
72
+ unzip -l ai-image-generation-studio-skill-0.1.4.zip
73
+ unzip -q ai-image-generation-studio-skill-0.1.4.zip
74
+ find ai-image-generation-studio -type l -print # expect no output
75
+ find ai-image-generation-studio -type f -perm -111 -print # expect no output
76
+ grep -n '"auto_update": True' ai-image-generation-studio/scripts/mcp_client.py
77
+ ```
78
+
79
+ Optionally confirm byte identity with the public source tree (a second,
80
+ independent host):
81
+
82
+ ```bash
83
+ git clone --quiet --filter=blob:none --no-checkout https://github.com/beatra-ai/ai-image-generator-skill.git src
84
+ git -C src checkout --quiet 13c7b9b2a2197fb91deb6a3a1466124db620c3d1 -- skills/ai-image-generation-studio
85
+ (cd ai-image-generation-studio && find . -type f | LC_ALL=C sort | xargs shasum -a 256) > archive.sha
86
+ (cd src/skills/ai-image-generation-studio && find . -type f | LC_ALL=C sort | xargs shasum -a 256) > tree.sha
87
+ cmp archive.sha tree.sha && echo IDENTICAL
88
+ ```
89
+
90
+ Report to the user what the review found: `SKILL.md`, `manifest.json`, the
91
+ bundled Markdown references, and `scripts/authorize.py`,
92
+ `scripts/mcp_client.py`, `scripts/uninstall.py` (Python 3.10+, standard
93
+ library only, no dependency installation, no lifecycle hooks). Summarize the
94
+ network, credential, local-state, telemetry, and self-update behavior listed
95
+ under [Security & Safety Notes](#security--safety-notes).
96
+
97
+ ### Step 3: Copy in and disable self-update before any other command
98
+
99
+ Ask for a **second, separate** approval, because this changes agent
100
+ configuration. Then copy the reviewed tree to the host's skills directory
101
+ (Claude Code shown; use the equivalent path for other hosts) and immediately
102
+ turn off silent self-update for that exact path:
103
+
104
+ ```bash
105
+ dest="$HOME/.claude/skills/ai-image-generation-studio"
106
+ test ! -e "$dest" || { echo "destination exists; stop and ask the user"; exit 1; }
107
+ cp -R ai-image-generation-studio "$dest"
108
+ python3 "$dest/scripts/mcp_client.py" update --auto off
109
+ ```
110
+
111
+ The last command must print
112
+ `Automatic Beatra package updates are disabled.` It writes only
113
+ `~/.beatra/updates/<id>/state.json` and makes no network request. Run it
114
+ before `authorize.py`, `verify`, `tools`, `upload`, or `call`: in this
115
+ pinned version self-update is **on by default**. The setting is keyed to the
116
+ resolved install path, so repeat it after moving or re-copying the directory.
117
+
118
+ ### Step 4: Authorize as its own decision
119
+
120
+ Authorization opens a browser sign-in and stores a bearer token. Ask first.
121
+
122
+ ```bash
123
+ python3 "$dest/scripts/authorize.py"
124
+ ```
125
+
126
+ Start a new agent session if the host discovers skills only at startup.
127
+
128
+ ## How It Works
129
+
130
+ 1. Read the installed package's `SKILL.md` and its references; they define the
131
+ routes, payload shapes, and review loop.
132
+ 2. Use free, non-billable discovery first (`beatra.models.list`, task list) to
133
+ read current model cards and credit estimates.
134
+ 3. Show the user a cost card for exactly one paid call: tool, model, estimate,
135
+ and which files will be uploaded. Wait for explicit approval. Planning or
136
+ "just do it" is not approval.
137
+ 4. Upload only files the user supplied and approved for this task, then submit
138
+ once with a stable `client_request_id` and poll the returned task.
139
+ 5. Report the delivered artifact and `billing.net_charged_credits`, review the
140
+ result with the user, and ask again before any further paid stage.
141
+
142
+ ## Examples
143
+
144
+ ### Free connection check (non-billable)
145
+
146
+ ```bash
147
+ python3 "$HOME/.claude/skills/ai-image-generation-studio/scripts/mcp_client.py" verify
148
+ ```
149
+
150
+ ### One approved paid call
151
+
152
+ After the user approved the cost card for this exact payload, submit once with
153
+ a stable request id using the tool name from the installed `SKILL.md`. If the
154
+ response is lost, retry only with the same `client_request_id` and identical
155
+ arguments; never submit a replacement while the task is running.
156
+
157
+ ## Update
158
+
159
+ This entry does not endorse the package's silent self-update. Keep
160
+ `update --auto off` in place and do not run `update --auto on` or a bare
161
+ `update` without explicit approval.
162
+
163
+ To move to a newer version, repeat Steps 1 to 3 for that version in a new
164
+ review directory, verify its digest against the matching tree in `beatra-ai/ai-image-generator-skill`
165
+ (a version not listed in this entry has not been reviewed here), show the
166
+ user the file-level changes against the installed copy, and replace the
167
+ directory only after approval. `update --check` reports the available version
168
+ from `beatra.ai` without changing files.
169
+
170
+ ## Uninstall
171
+
172
+ ```bash
173
+ dest="$HOME/.claude/skills/ai-image-generation-studio"
174
+ python3 "$dest/scripts/uninstall.py" --dry-run
175
+ python3 "$dest/scripts/uninstall.py"
176
+ ```
177
+
178
+ Read the JSON decision. `disconnected` means this was the last Beatra skill on
179
+ the device: the token was revoked (when `revoked` is `true`) and the files
180
+ `credentials.json`, `installation.json`, `host.json`, `skills.json`, and
181
+ `registrations.json` under `~/.beatra` were removed. `keep_connection` means
182
+ another Beatra skill still uses the shared token, which stays. Then, after
183
+ confirming the path with the user, delete `$dest`.
184
+
185
+ `uninstall.py` does not remove `~/.beatra/updates/`. When the decision is
186
+ `disconnected` and no other Beatra skill is installed, remove that directory
187
+ too; otherwise leave it. A token that could not be revoked expires after 15
188
+ days idle and can be revoked at once in the Beatra Console under Agents.
189
+
190
+ ## Best Practices
191
+
192
+ - ✅ Keep one approval per paid call, per upload set, and per install step.
193
+ - ✅ Report net charged credits from the terminal task, not the estimate.
194
+ - ❌ Do not re-enable self-update or install an unreviewed version silently.
195
+ - ❌ Do not print, paste, or move the token out of `~/.beatra/credentials.json`.
196
+ - ❌ Do not retry a paid call with a new request ID after an uncertain response.
197
+
198
+ ## Limitations
199
+
200
+ - Requires a Beatra account, network access, Python 3.10+, and prepaid credits.
201
+ - Models, prices, schemas, and availability are controlled by Beatra and its
202
+ upstream model providers and can change; the service is provided as is.
203
+ - Outputs are probabilistic, not guaranteed unique or non-infringing, and need
204
+ human review before publication.
205
+ - This catalog entry reviews only the pinned archive above. A newer version is
206
+ a different review.
207
+
208
+ ## Security & Safety Notes
209
+
210
+ `risk: critical` is deliberate.
211
+
212
+ - **Network.** Authorization uses `api.beatra.ai`; every tool call and upload
213
+ goes to `mcp.beatra.ai`. With self-update left on, the client also fetches
214
+ `https://beatra.ai/skills/ai-image-generation-studio/install.json` and archives from
215
+ `cdn.beatra.ai`.
216
+ - **Self-update (on by default in this pinned version).** Before `verify`,
217
+ `tools`, `upload`, or `call`, the client checks for a newer release at most
218
+ once every 24 hours and, if one exists, replaces package-owned files without
219
+ per-update preview or approval. It pins host and path, verifies checksums
220
+ from Beatra's own discovery document and CDN, and rolls back on failure, but
221
+ those digests are not independently anchored. This entry therefore requires
222
+ `update --auto off` before first use, as in Step 3.
223
+ - **Uploads and third parties.** Prompts and uploaded media are sent to Beatra
224
+ and forwarded to the third-party model provider executing the task. Beatra
225
+ is hosted outside mainland China. See the
226
+ [privacy policy](https://beatra.ai/en/privacy).
227
+ - **Billing.** Paid tools consume prepaid credits. Credits for tasks that fail
228
+ for reasons attributable to Beatra or the upstream model are returned
229
+ automatically; otherwise purchases are non-refundable, and actual usage can
230
+ exceed the estimate and leave a negative balance. See the
231
+ [terms](https://beatra.ai/en/terms).
232
+ - **Credentials.** `authorize.py` runs an OAuth device flow, opens the browser,
233
+ and stores one bearer token in `~/.beatra/credentials.json` (directory
234
+ `0700`, file `0600`). The token never goes into argv, environment variables,
235
+ or output. It carries full Beatra scope, including `wallet:spend`, has a
236
+ sliding 15-day idle lifetime, and is shared by every Beatra skill on the
237
+ device.
238
+ - **Local state.** `~/.beatra/` also holds `installation.json` (random
239
+ installation reference), `host.json` (agent platform and hostname),
240
+ `skills.json` (installed Beatra skill paths), `registrations.json`, and
241
+ `updates/<id>/state.json` plus update backups when updates run.
242
+ - **Telemetry.** The device flow sends the hostname as the device name, the
243
+ package slug and version, and the detected agent platform (for example
244
+ `claude-code`, from environment variables). On first use the client makes a
245
+ non-billable `beatra.installations.register` call, and every tool call adds
246
+ `source_package_slug` and `source_platform`. There is no opt-out for these
247
+ fields.
248
+ - **Retention.** Account data is kept for the life of the account. Task
249
+ records, artifacts, and billing ledgers are retained after account closure
250
+ for audit and tax purposes.
251
+ - **Content rights.** Users keep rights in their inputs and receive Beatra's
252
+ rights in outputs; they must hold rights to uploaded media and must not
253
+ create deceptive impersonations.
254
+
255
+ ## Additional Resources
256
+
257
+ - [Source tree at the pinned commit](https://github.com/beatra-ai/ai-image-generator-skill/tree/13c7b9b2a2197fb91deb6a3a1466124db620c3d1/skills/ai-image-generation-studio)
258
+ - [Product page](https://beatra.ai/skills/ai-image-generation-studio)
259
+ - [Terms](https://beatra.ai/en/terms) and [privacy policy](https://beatra.ai/en/privacy)