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,498 @@
1
+ ---
2
+ name: brand-kit-print-collateral
3
+ description: 'Print collateral spec: item, finished and trim size, bleed, colour mode, stock and GSM, finish, safe margin, print method, quantity and unit cost. Use for cards and letterhead.'
4
+ category: business
5
+ risk: safe
6
+ source: self
7
+ source_type: self
8
+ date_added: "2026-09-27"
9
+ author: WHOISABHISHEKADHIKARI
10
+ tags: [sme, brand-kit, letterhead, visiting-card, business-card, employee-card, id-card, print, bleed, cmyk, stationery, folder, invoice, email-signature, csv, sql, notion]
11
+ tools: []
12
+ source_repo: WHOISABHISHEKADHIKARI/sme-ops-system-builder
13
+ ---
14
+
15
+ # Brand Kit & Print Collateral
16
+
17
+ **What it is:** the printed identity set - letterhead, visiting card, employee ID card, folder, invoice, quotation and the email signature block - specified to the point where any printer can produce it.
18
+
19
+ ## Overview
20
+
21
+ Works out the smallest useful collateral set for the business in front of it, then builds it
22
+ only when asked. The default output is a short recommendation, not a set of layout files.
23
+ The collateral register - CSV, SQL DDL, JSON Schema, Notion mapping - is produced on
24
+ request, from one field list so the four cannot drift apart.
25
+
26
+ Layer: Layer 2: Brand & Design. Fits: Starter stage. Table code: n/a.
27
+
28
+ **The rule this table exists to enforce:** the finished size and the trim size are
29
+ different things, and a designer who forgets the difference pays for the reprint. The
30
+ finished size is what gets cut; the trim size is finished size plus bleed on every edge.
31
+ The table keeps them in separate columns for exactly that reason, and the same logic
32
+ separates colour mode, stock weight and finish - three decisions a printer asks about
33
+ before a job starts, and three that cannot be changed after it starts.
34
+
35
+ ## When to Use This Skill
36
+
37
+ - letterhead, visiting card, business card, ID card, employee card, name badge
38
+ - compliment slip, folder, envelope, invoice, quotation, statement
39
+ - email signature block
40
+ - "our print looks wrong"
41
+ - prepress, bleed, CMYK, crop marks, stock weight, lamination
42
+ - brand guidelines for anything that gets printed
43
+
44
+ Do not use it for: the digital design system (`design-theme-guide`), the mark itself
45
+ (`logo-image-design`), or the email body templates - the signature block is in scope here,
46
+ the body is `business-email-template`.
47
+
48
+ Do not use it before an approved mark exists. Collateral built with no approved logo is a
49
+ rewrite later; route to `logo-image-design` first and note the dependency.
50
+
51
+ ## How It Works
52
+
53
+ Follow the shared execution contract. The module-specific rules below define only domain fields, decisions, calculations, and safety constraints.
54
+
55
+ ### Step 1 - Identify intent
56
+
57
+ Read the request and pick the intent before asking anything.
58
+
59
+ - "design" / "make" / "we need" -> artifacts wanted; go to Step 2.
60
+ - "we already print these" -> something exists; capture it, then Step 2.
61
+ - "print came out wrong" / "fix" -> a prepress or specification problem; capture what went
62
+ wrong, then Step 2.
63
+ - "review" / "check" -> a check, not a build.
64
+
65
+ Ask only if this is the highest-value missing fact; otherwise proceed without an opener:
66
+
67
+ > **Q:** What is the business called, and what does one line of it actually do?
68
+
69
+ ### Step 2 - Ask only what is missing
70
+
71
+ Treat ambiguous replies as unanswered and ask which explicit option the user means. Record unknown values as `Unknown`; `Unknown` is not zero. A record must not be `Done` when a required check fails.
72
+
73
+ Skip anything already answered. Ask the rest one at a time, and stop as soon as the
74
+ remaining answers would not change the item list or the specification.
75
+
76
+ - **Identity** - Exact business name, address and phone as they must print? / Logo file
77
+ available in an editable or vector format? / Anything already printed that must match?
78
+ - **Items** - Which items are needed - letterhead, card, employee card, folder, invoice,
79
+ envelope? / Which need to be two-sided? / Is the employee card for access control, or
80
+ purely for identity?
81
+ - **Volume** - How many of each, now and over the year? / Who prints it - a local printer,
82
+ a national one, or an online print service?
83
+ - **Specification** - Any stock or finish already decided? / Does it need to be writable -
84
+ pen, pencil, thermal printer? / Any wet or outdoor exposure?
85
+ - **Employee card detail** - What goes on it - photo, name, role, department, phone, or a
86
+ barcode? / What is the data-protection position on employee photos and role data?
87
+
88
+ Never invent an answer. Names, addresses, phone numbers, quantities, stock weights, printer
89
+ names, prices and barcode schemes the user has not supplied are `Unknown`.
90
+
91
+ ### Step 3 - Hold the internal context
92
+
93
+ ```yaml
94
+ module: brand-kit-print-collateral
95
+ intent: null # design | fix | review | import
96
+ scale: null # Starter | Growth | Scale, only if the answer changes it
97
+ areas:
98
+ "Identity": null
99
+ "Items": null
100
+ "Volume": null
101
+ "Specification": null
102
+ "Employee Card Detail": null
103
+ requested_outputs: []
104
+ confirmed_facts: []
105
+ open_questions: []
106
+ ```
107
+
108
+ ### Step 4 - Recommend the smallest workflow
109
+
110
+ Build an already requested artifact without asking again. For advice-only requests, give a short recommendation and offer the relevant artifact.
111
+
112
+ **Recommended approach:** Four items that between them cover almost every business - A4
113
+ letterhead, a 55x90mm visiting card, an 85.54mm employee card in the same family, and a
114
+ single-page email signature. Each specified with trim, bleed, colour mode, stock and
115
+ finish stated once, plus a PDF proof and a print-ready export with crop marks. Build the
116
+ envelope and folder only when someone asks for them.
117
+
118
+ **Why this one:** These four are the items a business actually runs out of. Folder and
119
+ envelope are a second print run, not a first one, and they can inherit the letterhead's
120
+ specification without being redesigned. A signature block costs nothing and appears in
121
+ every email the business ever sends, which makes it the highest-leverage item on the list.
122
+
123
+ **Workflow:** Items and sizes fixed → Mark and tokens applied → Copy block written once →
124
+ Layout and hierarchy set → Stock and finish chosen → Bleed and crop marks set → PDF proof
125
+ approved → Print-ready export with marks → Proof checked on press → Master archived
126
+
127
+ ### Step 5 - Build only on request
128
+
129
+ Once the user asks for it, derive the fields from the confirmed context and emit the
130
+ requested artifacts. For machine-readable text, keep prose outside the data; for files,
131
+ provide a usable link. Report material validation failures or limitations separately.
132
+
133
+ **A selected Notion output is rendered by `notion-manual-import`, so route the
134
+ Notion step there.** When the user selects Notion, hand that step to
135
+ @notion-manual-import: it holds the CSV, the property
136
+ mapping, the import steps and the verification checklist, and it renders the Field
137
+ Reference below instead of defining a table of its own. Do not restate the mapping
138
+ here and do not improvise the import steps. Manual CSV and mapping outputs need no
139
+ connection. For requested workspace changes, follow the shared contract: verify actual
140
+ tool access and the target before writing. A user saying "connected" is not tool evidence.
141
+ Never ask for a Notion password or token.
142
+
143
+ ```csv
144
+ Item ID,Item Name,Item Type,Finished Size,Trim Size,Bleed,Colour Mode,Stock,Paper Weight GSM,Finish,Sides,Corner Radius,Safe Margin,Front Elements,Back Elements,Spot Colour,Print Method,Quantity,Cost Per Unit,Supplier,Version,Status,Notes
145
+ ,Example Retail letterhead,Letterhead,A4,216x303 mm,3 mm,CMYK,Uncoated,120,Uncoated,One side,0,12 mm,"Logo top left, NAP block bottom left, contact strip bottom right",Reverse: repeat mark and the short URL only,None - build to process black only,Digital litho,250,0.00,Unknown,1.0,Draft,"Example row - replace every value before use."
146
+ ```
147
+
148
+ ```sql
149
+ -- Engine assumption: PostgreSQL. For another engine use the engine's auto-increment
150
+ -- equivalent and keep the rest portable.
151
+ CREATE TABLE print_collateral (
152
+ item_id BIGINT PRIMARY KEY,
153
+ item_name VARCHAR(255) NOT NULL,
154
+ item_type VARCHAR(100) NOT NULL,
155
+ finished_size VARCHAR(50) NOT NULL,
156
+ trim_size VARCHAR(50) NOT NULL,
157
+ bleed VARCHAR(50) NOT NULL,
158
+ colour_mode VARCHAR(100) NOT NULL,
159
+ stock VARCHAR(100) NOT NULL,
160
+ paper_weight_gsm INTEGER,
161
+ finish VARCHAR(100) NOT NULL,
162
+ sides VARCHAR(20) NOT NULL,
163
+ corner_radius VARCHAR(50),
164
+ safe_margin VARCHAR(50),
165
+ front_elements TEXT,
166
+ back_elements TEXT,
167
+ spot_colour VARCHAR(255),
168
+ print_method VARCHAR(100),
169
+ quantity INTEGER,
170
+ cost_per_unit NUMERIC(14,2),
171
+ supplier VARCHAR(255),
172
+ version VARCHAR(50) NOT NULL,
173
+ status VARCHAR(50) NOT NULL,
174
+ notes TEXT,
175
+ created_at TIMESTAMP DEFAULT NOW(),
176
+ updated_at TIMESTAMP DEFAULT NOW(),
177
+ CONSTRAINT collateral_bleed CHECK (bleed IN ('3 mm','5 mm','None','Other - state in Notes')),
178
+ CONSTRAINT collateral_sides CHECK (sides IN ('One side','Two sides','Two sides - different front and back')),
179
+ CONSTRAINT collateral_cost_non_negative CHECK (cost_per_unit IS NULL OR cost_per_unit >= 0)
180
+ );
181
+
182
+ CREATE INDEX idx_print_collateral_status ON print_collateral (status);
183
+ CREATE INDEX idx_print_collateral_type ON print_collateral (item_type);
184
+ ```
185
+
186
+ ```json
187
+ {
188
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
189
+ "title": "Brand Kit & Print Collateral",
190
+ "type": "object",
191
+ "additionalProperties": false,
192
+ "properties": {
193
+ "Item ID": { "type": "integer" },
194
+ "Item Name": { "type": "string" },
195
+ "Item Type": { "type": "string" },
196
+ "Finished Size": { "type": "string" },
197
+ "Trim Size": { "type": "string" },
198
+ "Bleed": { "type": "string" },
199
+ "Colour Mode": { "type": "string" },
200
+ "Stock": { "type": "string" },
201
+ "Paper Weight GSM": { "type": "integer" },
202
+ "Finish": { "type": "string" },
203
+ "Sides": { "type": "string" },
204
+ "Corner Radius": { "type": "string" },
205
+ "Safe Margin": { "type": "string" },
206
+ "Front Elements": { "type": "string" },
207
+ "Back Elements": { "type": "string" },
208
+ "Spot Colour": { "type": "string" },
209
+ "Print Method": { "type": "string" },
210
+ "Quantity": { "type": "integer" },
211
+ "Cost Per Unit": { "type": "number" },
212
+ "Supplier": { "type": "string" },
213
+ "Version": { "type": "string" },
214
+ "Status": { "type": "string" },
215
+ "Notes": { "type": "string" }
216
+ },
217
+ "required": [
218
+ "Item Name",
219
+ "Item Type",
220
+ "Finished Size",
221
+ "Trim Size",
222
+ "Bleed",
223
+ "Colour Mode",
224
+ "Stock",
225
+ "Finish",
226
+ "Sides",
227
+ "Version",
228
+ "Status"
229
+ ]
230
+ }
231
+ ```
232
+
233
+ ```markdown
234
+ | CSV column | Notion property | Set after import |
235
+ |---|---|---|
236
+ | Item ID | Text (preserve source ID) | Keep imported IDs as Text; optionally add a separate Unique ID property |
237
+ | Item Name | Title | Use as the database title |
238
+ | Item Type | Select (add options after import) | Convert to Select, add options: "Letterhead", "Visiting Card", "Employee Card", "Envelope", "Folder", "Invoice", "Quotation", "Statement", "Compliment Slip", "Email Signature", "Presentation Document" |
239
+ | Finished Size | Text | Leave as Text. The cut size. mm for print, px for screen-only items |
240
+ | Trim Size | Text | Leave as Text. Finished size plus bleed. State the arithmetic in Notes |
241
+ | Bleed | Select (add options after import) | Convert to Select, add options: "3 mm", "5 mm", "None", "Other - state in Notes" |
242
+ | Colour Mode | Select (add options after import) | Convert to Select, add options: "CMYK", "RGB", "Greyscale", "CMYK plus spot", "Process black only" |
243
+ | Stock | Text | Leave as Text. "120gsm uncoated" and "350gsm silk" are two different answers |
244
+ | Paper Weight GSM | Number | Convert to Number, no unit. The cell holds digits only |
245
+ | Finish | Select (add options after import) | Convert to Select, add options: "Uncoated", "Matt lamination", "Gloss lamination", "Soft touch lamination", "Spot UV", "Foil", "Round corner", "Die cut", "Perforation" |
246
+ | Sides | Select (add options after import) | Convert to Select, add options: "One side", "Two sides", "Two sides - different front and back" |
247
+ | Corner Radius | Text | Leave as Text. "0" for square. Round corners need a die, which is a cost |
248
+ | Safe Margin | Text | Leave as Text. Keep content inside this; the trim tolerance eats the rest |
249
+ | Front Elements | Text | Leave as Text |
250
+ | Back Elements | Text | Leave as Text |
251
+ | Spot Colour | Text | Leave as Text. Name the ink and the Pantone or CMYK build. "None" is a valid entry |
252
+ | Print Method | Text | Leave as Text. "Digital litho" and "offset" cost differently at different runs |
253
+ | Quantity | Number | Convert to Number, digits only |
254
+ | Cost Per Unit | Number (format: currency) | Convert to Number, set format to Currency. No symbol in the cell |
255
+ | Supplier | Text | Leave as Text |
256
+ | Version | Text | Leave as Text |
257
+ | Status | Select (add options after import) | Convert to Select, add options: "Draft", "In review", "Proof approved", "Sent to printer", "Printed", "Archived" |
258
+ | Notes | Text | Leave as Text. Print the printer's own instructions here |
259
+ ```
260
+
261
+ The rows above are documentation examples only. Emit empty templates unless the user explicitly requests examples. Money is `currency` with no symbol. Stock,
262
+ finish and quantity stay `Unknown` or blank until the business supplies them - never a
263
+ plausible guess.
264
+
265
+ ## Field Reference
266
+
267
+ | # | Field | Type | SQL | JSON Schema | Notion | CSV example |
268
+ |---:|---|---|---|---|---|---|
269
+ | 1 | Item ID | `id` | `BIGINT PRIMARY KEY` | `integer` | Text or Notion auto-ID | `(blank)` |
270
+ | 2 | Item Name | `text` | `VARCHAR(255)` | `string` | Text | `Example Retail letterhead` |
271
+ | 3 | Item Type | `select` | `VARCHAR(100)` | `string` | Select | `Letterhead` |
272
+ | 4 | Finished Size | `text` | `VARCHAR(50)` | `string` | Text | `A4` |
273
+ | 5 | Trim Size | `text` | `VARCHAR(50)` | `string` | Text | `216x303 mm` |
274
+ | 6 | Bleed | `select` | `VARCHAR(50)` | `string` | Select | `3 mm` |
275
+ | 7 | Colour Mode | `select` | `VARCHAR(100)` | `string` | Select | `CMYK` |
276
+ | 8 | Stock | `text` | `VARCHAR(100)` | `string` | Text | *(blank)* |
277
+ | 9 | Paper Weight GSM | `number` | `INTEGER` | `integer` | Number | *(blank)* |
278
+ | 10 | Finish | `select` | `VARCHAR(100)` | `string` | Select | `Uncoated` |
279
+ | 11 | Sides | `select` | `VARCHAR(20)` | `string` | Select | `One side` |
280
+ | 12 | Corner Radius | `text` | `VARCHAR(50)` | `string` | Text | `0` |
281
+ | 13 | Safe Margin | `text` | `VARCHAR(50)` | `string` | Text | `12 mm` |
282
+ | 14 | Front Elements | `long_text` | `TEXT` | `string` | Text | *(blank)* |
283
+ | 15 | Back Elements | `long_text` | `TEXT` | `string` | Text | *(blank)* |
284
+ | 16 | Spot Colour | `text` | `VARCHAR(255)` | `string` | Text | `None` |
285
+ | 17 | Print Method | `text` | `VARCHAR(100)` | `string` | Text | `Digital litho` |
286
+ | 18 | Quantity | `number` | `INTEGER` | `integer` | Number | `250` |
287
+ | 19 | Cost Per Unit | `currency` | `NUMERIC(14,2)` | `number` | Number (format: currency) | `0.00` |
288
+ | 20 | Supplier | `text` | `VARCHAR(255)` | `string` | Text | `Unknown` |
289
+ | 21 | Version | `text` | `VARCHAR(50)` | `string` | Text | `1.0` |
290
+ | 22 | Status | `select` | `VARCHAR(50)` | `string` | Select | `Draft` |
291
+ | 23 | Notes | `long_text` | `TEXT` | `string` | Text | *(blank)* |
292
+
293
+ ## Select Options
294
+
295
+ **Item Type** - a starting set. Add the country's own statutory items (a UK VAT
296
+ invoice wording, an Indian GST invoice) when the business tells you they apply.
297
+
298
+ ```
299
+ Letterhead | Visiting Card | Employee Card | Envelope | Folder | Invoice | Quotation | Statement | Compliment Slip | Email Signature | Presentation Document
300
+ ```
301
+
302
+ **Bleed** - the three values that matter. 3 mm is the common default; anything that runs
303
+ off an edge needs it, and anything that does not run off an edge does not.
304
+
305
+ ```
306
+ 3 mm | 5 mm | None | Other - state in Notes
307
+ ```
308
+
309
+ **Colour Mode** - `Process black only` is the cheapest, most reliable option for a
310
+ letterhead and it looks better than a bad CMYK build of a logo.
311
+
312
+ ```
313
+ CMYK | RGB | Greyscale | CMYK plus spot | Process black only
314
+ ```
315
+
316
+ **Finish** - each one is a different price and a different minimum run. Round corners and
317
+ die cuts need a physical tool, so a re-run after a text change is not free.
318
+
319
+ ```
320
+ Uncoated | Matt lamination | Gloss lamination | Soft touch lamination | Spot UV | Foil | Round corner | Die cut | Perforation
321
+ ```
322
+
323
+ **Sides** - three values, not two, because a folded sheet with a different back is a
324
+ different item from a two-sided flat one.
325
+
326
+ ```
327
+ One side | Two sides | Two sides - different front and back
328
+ ```
329
+
330
+ **Status** - the print cycle, in order. `Proof approved` is the gate; nothing goes to press
331
+ before it.
332
+
333
+ ```
334
+ Draft | In review | Proof approved | Sent to printer | Printed | Archived
335
+ ```
336
+
337
+ ## Relations
338
+
339
+ None standalone. Two natural links worth confirming with the business before making them
340
+ live relations:
341
+
342
+ - `Supplier` points at a vendor database if one exists in the same build. Otherwise it is
343
+ Text with a note naming the intended target.
344
+ - The employee card's role and department fields point at the `people-directory` in the
345
+ operational pack. That database is not in this artifact set, so `Front Elements` stays
346
+ text here and names the fields it draws from.
347
+
348
+ ## Examples
349
+
350
+ **Prompt**
351
+
352
+ ```
353
+ We want to redo our letterhead and get visiting cards made. Last time the cards came out
354
+ with a white edge around the logo and the letterhead was a different blue to the website.
355
+ ```
356
+
357
+ **Context first** - one question per message, nothing already answered:
358
+
359
+ > **Q:** What is the business called, and what does one line of it actually do?
360
+ > **A:** Example Retail, home and kitchen goods in Example City.
361
+ >
362
+ > **Q:** Is there an approved logo file in an editable or vector format?
363
+ > **A:** We have a PNG, and the original Canva file.
364
+ >
365
+ > **Q:** Which items do you need - letterhead, cards, employee cards, envelopes, folder?
366
+ > **A:** Letterhead and visiting cards for now. Employee cards later.
367
+ >
368
+ > **Q:** How many of each, and who is printing them?
369
+ > **A:** 500 cards. There is a printer on our street the founder used before.
370
+ >
371
+ > **Q:** Do the cards need to be writable?
372
+ > **A:** Yes, people write on them.
373
+
374
+ **Recommended next step** - offered, not built:
375
+
376
+ > Letterhead and visiting card, both built from the same tokens as the website so the blue
377
+ > cannot drift again. Cards at 55x90mm on 350gsm uncoated with a round corner and matt
378
+ > lamination, letterhead on 120gsm uncoated. Both at 3mm bleed, and the logo supplied as
379
+ > vector rather than a stretched PNG - that is the white edge. Add the employee card and
380
+ > envelope in the same family when the second run happens.
381
+ >
382
+ > Workflow: Items and sizes fixed → Mark and tokens applied → Copy block written once →
383
+ > Layout and hierarchy set → Stock and finish chosen → Bleed and crop marks set → PDF proof
384
+ > approved → Print-ready export with marks → Proof checked on press → Master archived
385
+ >
386
+ > Want the CSV, SQL DDL, JSON Schema and Notion mapping for this?
387
+
388
+ ## Best Practices
389
+
390
+ - Build when requested; recommend and offer a build for advice-only requests.
391
+ - One question per message. A batched intake reads as a form and gets guessed at.
392
+ - Never hand a printer a raster logo. Ask for SVG or EPS, or redraw the mark. A stretched
393
+ PNG is the single most common cause of a soft edge on a printed card.
394
+ - Write the copy block once. The address, phone, email and web line are identical on the
395
+ letterhead, the card, the invoice and the signature - typed from the canonical NAP block,
396
+ never retyped.
397
+ - Build text as process black wherever possible. A four-colour CMYK build of a one-colour
398
+ logo costs more and usually looks worse.
399
+ - Always proof on press for a first run. Optical margin alignment means the block can sit
400
+ 0.3mm high, and on a letterhead that is visible on every page.
401
+ - Keep a 3mm bleed on anything that touches an edge, and keep live content at least 5mm
402
+ inside the trim - trim tolerance eats the margin.
403
+ - Ask the printer for the ICC profile of the press and soft-proof from it. Do not send an
404
+ untagged CMYK file and hope.
405
+ - Choose writable stock for cards people will write on, and a smaller card for people who
406
+ will not.
407
+ - Treat the email signature as collateral, not as an afterthought. It is the one item that
408
+ appears in every message forever.
409
+ - Derive all four artifacts from the field list in this file, never by hand.
410
+ - If the user requests an example row, keep it obviously fake so nobody imports it as a real item.
411
+
412
+ ## Limitations
413
+
414
+ - This is a specification register. It does not lay out the artwork, and it cannot attach
415
+ a press-ready PDF.
416
+ - It cannot check a printer's actual capability, minimum run, price or lead time. Those go
417
+ in `Supplier` and `Cost Per Unit` when the business supplies them.
418
+ - Barcode, RFID and access-control encoding on an employee card is out of scope. If the
419
+ card is a credential and not an ID badge, that is a different product with a different
420
+ supplier.
421
+ - Employee photo and role data on an ID card is a data-protection question. This table
422
+ records that the fields exist; it does not decide the lawful basis.
423
+ - It does not model envelopes, window envelopes or carrier-specific dielines.
424
+ - Special finishes have minimum runs and plate costs that vary by printer and are not
425
+ modelled here.
426
+ - Round corners and die cuts are a one-time tool charge; changing the shape later means a
427
+ new charge. This is a commercial fact, not a design preference.
428
+ - Print colour cannot be guaranteed to match a screen. Nothing in this table promises a
429
+ match, and a proof is the only check.
430
+
431
+ ## Security & Safety Notes
432
+
433
+ - Never invent a business name, address, phone number, quantity, supplier, price, stock
434
+ weight or barcode value. `Unknown` and blank are correct.
435
+ - Employee card data is personal data. A photo, a role, a department and an employee
436
+ number on a card are all personal data in most jurisdictions. Do not paste a real
437
+ employee roster into this table.
438
+ - Employee photos and role data need a lawful basis and an access policy. Flag it, and
439
+ refer it to the data-protection position - `data-privacy-controls` in the operational
440
+ pack.
441
+ - Lost cards are a security event, not an admin task. A card register should be able to
442
+ record a revoke-and-replace.
443
+ - Local reads, generation commands, and validation are part of a requested artifact build.
444
+ External writes, messages, provisioning, and publication require authorization for that
445
+ action and target; existing explicit authorization does not need to be repeated.
446
+ - Barcode and QR payloads must never contain a national identifier or anything that should
447
+ not be publicly readable from the card.
448
+
449
+ ## Common Pitfalls
450
+
451
+ - **Problem:** a static mapping is described as a completed workspace build.
452
+ **Solution:** deliver manual mappings without a connection; claim a live change only
453
+ after the authorized tool operation succeeds.
454
+ - **Problem:** asked all five questions in one message.
455
+ **Solution:** ask one, wait, and drop any the first answer already covered.
456
+ - **Problem:** finished size and trim size are the same value.
457
+ **Solution:** trim is finished plus bleed on all four edges. The white edge on a printed
458
+ card is almost always a missing bleed or a white background that was not removed.
459
+ - **Problem:** the logo arrives as a stretched PNG from a Canva file.
460
+ **Solution:** ask for the vector, or redraw. A raster logo at card size is visible as
461
+ softness on every one of 500 cards.
462
+ - **Problem:** the letterhead blue does not match the website.
463
+ **Solution:** the copy is a screen value in CMYK. Use a CMYK build of the brand colour,
464
+ and accept that exact match is impossible; a proof settles it.
465
+ - **Problem:** content sits 3mm from the trim on a folded item.
466
+ **Solution:** fold eats the margin. Keep live content 5mm inside, and never run a fold
467
+ through text.
468
+ - **Problem:** stock weight was never chosen and the printer defaulted it.
469
+ **Solution:** `Stock` and `Paper Weight GSM` are not optional. State them.
470
+ - **Problem:** spot UV or foil was added "to match the brand", at 100 units.
471
+ **Solution:** plate and tool costs make small runs of special finish uneconomic. It is a
472
+ quantity decision, and it belongs to the business.
473
+ - **Problem:** all four artifacts drift apart.
474
+ **Solution:** derive all four from the field list in this file, never by hand.
475
+ - **Problem:** Notion import shows every column as Text.
476
+ **Solution:** that is expected. Apply the property mapping table once, after import.
477
+
478
+ ## Related Skills
479
+
480
+ - `brand-growth-system-builder` - routes to this skill and the other 12 brand and growth modules.
481
+ - @logo-image-design - the master mark and the vector files this module needs. Run first.
482
+ - @design-theme-guide - the colour and type tokens every item here must use.
483
+ - `business-email-template` - the email body; the signature block stays in this module.
484
+ - @free-design-resources - stock photography, fonts, print services and mockups.
485
+ - @presentation-deck - the printed leave-behind version of the deck.
486
+ - @code-of-conduct - what the employee card shows, and where the conduct rules are posted.
487
+ - `asset-it-management` (operational pack) - the issued card, lanyard and laptop as assets.
488
+
489
+ ## Reusable Prompt
490
+
491
+ ```
492
+ I want a printed brand kit - letterhead, visiting cards, employee cards, and an email
493
+ signature - specified so any printer can produce it.
494
+ Ask me one short question at a time, and only about what I have not already told you.
495
+ Never invent an address, quantity, price or supplier. Then recommend the smallest item
496
+ set that fits, with the logo as a dependency, and wait for me to ask before you build it.
497
+ When I ask, output CSV, SQL DDL, JSON Schema and a Notion property mapping. Data only.
498
+ ```