conectese 0.1.14

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 (260) hide show
  1. package/README.md +265 -0
  2. package/_conectese/.conectese-version +1 -0
  3. package/_conectese/config/playwright.config.json +11 -0
  4. package/_conectese/core/architect.agent.yaml +110 -0
  5. package/_conectese/core/best-practices/_catalog.yaml +116 -0
  6. package/_conectese/core/best-practices/blog-post.md +132 -0
  7. package/_conectese/core/best-practices/blog-seo.md +127 -0
  8. package/_conectese/core/best-practices/copywriting.md +426 -0
  9. package/_conectese/core/best-practices/data-analysis.md +401 -0
  10. package/_conectese/core/best-practices/email-newsletter.md +118 -0
  11. package/_conectese/core/best-practices/email-sales.md +110 -0
  12. package/_conectese/core/best-practices/image-design.md +348 -0
  13. package/_conectese/core/best-practices/instagram-feed.md +235 -0
  14. package/_conectese/core/best-practices/instagram-reels.md +112 -0
  15. package/_conectese/core/best-practices/instagram-stories.md +107 -0
  16. package/_conectese/core/best-practices/linkedin-article.md +116 -0
  17. package/_conectese/core/best-practices/linkedin-post.md +121 -0
  18. package/_conectese/core/best-practices/researching.md +349 -0
  19. package/_conectese/core/best-practices/review.md +269 -0
  20. package/_conectese/core/best-practices/social-networks-publishing.md +294 -0
  21. package/_conectese/core/best-practices/strategist.md +344 -0
  22. package/_conectese/core/best-practices/technical-writing.md +365 -0
  23. package/_conectese/core/best-practices/twitter-post.md +105 -0
  24. package/_conectese/core/best-practices/twitter-thread.md +122 -0
  25. package/_conectese/core/best-practices/whatsapp-broadcast.md +107 -0
  26. package/_conectese/core/best-practices/youtube-script.md +122 -0
  27. package/_conectese/core/best-practices/youtube-shorts.md +112 -0
  28. package/_conectese/core/prompts/build.prompt.md +547 -0
  29. package/_conectese/core/prompts/design.prompt.md +469 -0
  30. package/_conectese/core/prompts/discovery.prompt.md +269 -0
  31. package/_conectese/core/prompts/sherlock-instagram.md +123 -0
  32. package/_conectese/core/prompts/sherlock-linkedin.md +73 -0
  33. package/_conectese/core/prompts/sherlock-shared.md +684 -0
  34. package/_conectese/core/prompts/sherlock-twitter.md +78 -0
  35. package/_conectese/core/prompts/sherlock-youtube.md +85 -0
  36. package/_conectese/core/runner.pipeline.md +535 -0
  37. package/_conectese/core/skills.engine.md +381 -0
  38. package/agents/data-extractor/AGENT.md +13 -0
  39. package/agents/direito-adaneiro/AGENT.md +18 -0
  40. package/agents/direito-administrativo/AGENT.md +18 -0
  41. package/agents/direito-aeroporta-rio/AGENT.md +18 -0
  42. package/agents/direito-agra-rio/AGENT.md +18 -0
  43. package/agents/direito-ambiental/AGENT.md +18 -0
  44. package/agents/direito-banca-rio/AGENT.md +18 -0
  45. package/agents/direito-civil/AGENT.md +18 -0
  46. package/agents/direito-constitcional/AGENT.md +18 -0
  47. package/agents/direito-da-crianc-a-e-do-adolescente-eca/AGENT.md +18 -0
  48. package/agents/direito-da-propriedade-intelectal/AGENT.md +18 -0
  49. package/agents/direito-de-ami-lia/AGENT.md +18 -0
  50. package/agents/direito-de-tra-nsito/AGENT.md +18 -0
  51. package/agents/direito-desportivo/AGENT.md +18 -0
  52. package/agents/direito-digital/AGENT.md +18 -0
  53. package/agents/direito-do-consmidor/AGENT.md +18 -0
  54. package/agents/direito-do-trabalho/AGENT.md +18 -0
  55. package/agents/direito-econo-mico/AGENT.md +18 -0
  56. package/agents/direito-eleitoral/AGENT.md +18 -0
  57. package/agents/direito-empresarial/AGENT.md +18 -0
  58. package/agents/direito-imobilia-rio/AGENT.md +18 -0
  59. package/agents/direito-inanceiro/AGENT.md +18 -0
  60. package/agents/direito-internacional/AGENT.md +18 -0
  61. package/agents/direito-mari-timo/AGENT.md +18 -0
  62. package/agents/direito-me-dico-e-da-sa-de/AGENT.md +18 -0
  63. package/agents/direito-militar/AGENT.md +18 -0
  64. package/agents/direito-ndia-rio/AGENT.md +18 -0
  65. package/agents/direito-notarial-e-registral/AGENT.md +18 -0
  66. package/agents/direito-penal/AGENT.md +18 -0
  67. package/agents/direito-previdencia-rio/AGENT.md +18 -0
  68. package/agents/direito-processal-civil/AGENT.md +18 -0
  69. package/agents/direito-processal-do-trabalho/AGENT.md +18 -0
  70. package/agents/direito-processal-militar/AGENT.md +18 -0
  71. package/agents/direito-processal-penal/AGENT.md +18 -0
  72. package/agents/direito-rbani-stico/AGENT.md +18 -0
  73. package/agents/direito-secrita-rio/AGENT.md +18 -0
  74. package/agents/direito-sindical/AGENT.md +18 -0
  75. package/agents/direito-societa-rio/AGENT.md +18 -0
  76. package/agents/direito-tribta-rio/AGENT.md +18 -0
  77. package/agents/direitos-hmanos/AGENT.md +18 -0
  78. package/agents/legal-analyst/AGENT.md +16 -0
  79. package/agents/legal-synthesizer/AGENT.md +13 -0
  80. package/agents/lgpd-anonymizer/AGENT.md +14 -0
  81. package/agents/lgpd-restorer/AGENT.md +14 -0
  82. package/agents/task-router/AGENT.md +13 -0
  83. package/bin/conectese.js +73 -0
  84. package/dashboard/index.html +12 -0
  85. package/dashboard/package-lock.json +1971 -0
  86. package/dashboard/package.json +28 -0
  87. package/dashboard/public/assets/avatars/Female1_1wave.png +0 -0
  88. package/dashboard/public/assets/avatars/Female1_2wave.png +0 -0
  89. package/dashboard/public/assets/avatars/Female1_blink.png +0 -0
  90. package/dashboard/public/assets/avatars/Female1_talk.png +0 -0
  91. package/dashboard/public/assets/avatars/Female2_1wave.png +0 -0
  92. package/dashboard/public/assets/avatars/Female2_2wave.png +0 -0
  93. package/dashboard/public/assets/avatars/Female2_blink.png +0 -0
  94. package/dashboard/public/assets/avatars/Female2_talk.png +0 -0
  95. package/dashboard/public/assets/avatars/Female3_blink.png +0 -0
  96. package/dashboard/public/assets/avatars/Female3_talk.png +0 -0
  97. package/dashboard/public/assets/avatars/Female3_wave.png +0 -0
  98. package/dashboard/public/assets/avatars/Female4_blink.png +0 -0
  99. package/dashboard/public/assets/avatars/Female4_talk.png +0 -0
  100. package/dashboard/public/assets/avatars/Female4_wave.png +0 -0
  101. package/dashboard/public/assets/avatars/Female5_blink.png +0 -0
  102. package/dashboard/public/assets/avatars/Female5_talk.png +0 -0
  103. package/dashboard/public/assets/avatars/Female5_wave.png +0 -0
  104. package/dashboard/public/assets/avatars/Female6_blink.png +0 -0
  105. package/dashboard/public/assets/avatars/Female6_talk.png +0 -0
  106. package/dashboard/public/assets/avatars/Female6_wave.png +0 -0
  107. package/dashboard/public/assets/avatars/Male1_1wave.png +0 -0
  108. package/dashboard/public/assets/avatars/Male1_2wave.png +0 -0
  109. package/dashboard/public/assets/avatars/Male1_blink.png +0 -0
  110. package/dashboard/public/assets/avatars/Male1_talk.png +0 -0
  111. package/dashboard/public/assets/avatars/Male2_1wave.png +0 -0
  112. package/dashboard/public/assets/avatars/Male2_2wave.png +0 -0
  113. package/dashboard/public/assets/avatars/Male2_blink.png +0 -0
  114. package/dashboard/public/assets/avatars/Male2_talk.png +0 -0
  115. package/dashboard/public/assets/avatars/Male3_blink.png +0 -0
  116. package/dashboard/public/assets/avatars/Male3_talk.png +0 -0
  117. package/dashboard/public/assets/avatars/Male3_wave.png +0 -0
  118. package/dashboard/public/assets/avatars/Male4_blink.png +0 -0
  119. package/dashboard/public/assets/avatars/Male4_talk.png +0 -0
  120. package/dashboard/public/assets/avatars/Male4_wave.png +0 -0
  121. package/dashboard/public/assets/desks/desktop_set_black_down.png +0 -0
  122. package/dashboard/public/assets/desks/desktop_set_black_down_coding-1.png +0 -0
  123. package/dashboard/public/assets/desks/desktop_set_black_down_coding.png +0 -0
  124. package/dashboard/public/assets/desks/desktop_set_black_up.png +0 -0
  125. package/dashboard/public/assets/desks/desktop_set_white_down.png +0 -0
  126. package/dashboard/public/assets/desks/desktop_set_white_down_coding-1.png +0 -0
  127. package/dashboard/public/assets/desks/desktop_set_white_down_coding.png +0 -0
  128. package/dashboard/public/assets/desks/desktop_set_white_up.png +0 -0
  129. package/dashboard/public/assets/furniture/armchair_tan.png +0 -0
  130. package/dashboard/public/assets/furniture/armchair_tan_down.png +0 -0
  131. package/dashboard/public/assets/furniture/backpack_blue.png +0 -0
  132. package/dashboard/public/assets/furniture/backpack_red.png +0 -0
  133. package/dashboard/public/assets/furniture/blinds.png +0 -0
  134. package/dashboard/public/assets/furniture/blinds_large_closed_white.png +0 -0
  135. package/dashboard/public/assets/furniture/bookshelf.png +0 -0
  136. package/dashboard/public/assets/furniture/bookshelf_purple_tall.png +0 -0
  137. package/dashboard/public/assets/furniture/bulletin_board.png +0 -0
  138. package/dashboard/public/assets/furniture/clock.png +0 -0
  139. package/dashboard/public/assets/furniture/coffee_mug.png +0 -0
  140. package/dashboard/public/assets/furniture/coffee_mug_blue.png +0 -0
  141. package/dashboard/public/assets/furniture/coffee_table.png +0 -0
  142. package/dashboard/public/assets/furniture/coffeepot_right.png +0 -0
  143. package/dashboard/public/assets/furniture/coffeetable_black_horizontal.png +0 -0
  144. package/dashboard/public/assets/furniture/couch.png +0 -0
  145. package/dashboard/public/assets/furniture/couch_tan_down.png +0 -0
  146. package/dashboard/public/assets/furniture/cushion_blue.png +0 -0
  147. package/dashboard/public/assets/furniture/cushion_tan.png +0 -0
  148. package/dashboard/public/assets/furniture/desk_wood.png +0 -0
  149. package/dashboard/public/assets/furniture/fancy_rug.png +0 -0
  150. package/dashboard/public/assets/furniture/fancy_rug_wide.png +0 -0
  151. package/dashboard/public/assets/furniture/flowers1.png +0 -0
  152. package/dashboard/public/assets/furniture/flowers2.png +0 -0
  153. package/dashboard/public/assets/furniture/lamp_tan.png +0 -0
  154. package/dashboard/public/assets/furniture/lantern.png +0 -0
  155. package/dashboard/public/assets/furniture/monstera.png +0 -0
  156. package/dashboard/public/assets/furniture/monstera_small.png +0 -0
  157. package/dashboard/public/assets/furniture/picture_frame.png +0 -0
  158. package/dashboard/public/assets/furniture/plant1.png +0 -0
  159. package/dashboard/public/assets/furniture/plant2.png +0 -0
  160. package/dashboard/public/assets/furniture/plant3.png +0 -0
  161. package/dashboard/public/assets/furniture/plant_poof.png +0 -0
  162. package/dashboard/public/assets/furniture/plant_spindly.png +0 -0
  163. package/dashboard/public/assets/furniture/poster_blue.png +0 -0
  164. package/dashboard/public/assets/furniture/rug.png +0 -0
  165. package/dashboard/public/assets/furniture/succulent_blue.png +0 -0
  166. package/dashboard/public/assets/furniture/succulent_green.png +0 -0
  167. package/dashboard/public/assets/furniture/treasurechest_closed_gold.png +0 -0
  168. package/dashboard/public/assets/furniture/water_cooler_better.png +0 -0
  169. package/dashboard/public/assets/furniture/whiteboard.png +0 -0
  170. package/dashboard/public/assets/furniture/whiteboard_stand_graph.png +0 -0
  171. package/dashboard/public/assets/furniture/window_blinds_open.png +0 -0
  172. package/dashboard/src/App.tsx +46 -0
  173. package/dashboard/src/components/SquadCard.tsx +47 -0
  174. package/dashboard/src/components/SquadSelector.tsx +61 -0
  175. package/dashboard/src/components/StatusBadge.tsx +32 -0
  176. package/dashboard/src/components/StatusBar.tsx +97 -0
  177. package/dashboard/src/hooks/useSquadSocket.ts +135 -0
  178. package/dashboard/src/lib/formatTime.ts +16 -0
  179. package/dashboard/src/lib/normalizeState.ts +25 -0
  180. package/dashboard/src/main.tsx +10 -0
  181. package/dashboard/src/office/AgentSprite.ts +241 -0
  182. package/dashboard/src/office/OfficeScene.ts +153 -0
  183. package/dashboard/src/office/PhaserGame.tsx +80 -0
  184. package/dashboard/src/office/RoomBuilder.ts +190 -0
  185. package/dashboard/src/office/assetKeys.ts +150 -0
  186. package/dashboard/src/office/palette.ts +32 -0
  187. package/dashboard/src/plugin/squadWatcher.ts +233 -0
  188. package/dashboard/src/store/useSquadStore.ts +56 -0
  189. package/dashboard/src/styles/globals.css +36 -0
  190. package/dashboard/src/types/state.ts +63 -0
  191. package/dashboard/src/vite-env.d.ts +1 -0
  192. package/dashboard/test-results/.last-run.json +4 -0
  193. package/dashboard/tsconfig.json +24 -0
  194. package/dashboard/tsconfig.tsbuildinfo +1 -0
  195. package/dashboard/vite.config.ts +13 -0
  196. package/package.json +53 -0
  197. package/skills/README.md +63 -0
  198. package/skills/apify/SKILL.md +55 -0
  199. package/skills/blotato/SKILL.md +63 -0
  200. package/skills/canva/SKILL.md +60 -0
  201. package/skills/conectese-agent-creator/SKILL.md +192 -0
  202. package/skills/conectese-skill-creator/SKILL.md +407 -0
  203. package/skills/conectese-skill-creator/agents/analyzer.md +274 -0
  204. package/skills/conectese-skill-creator/agents/comparator.md +202 -0
  205. package/skills/conectese-skill-creator/agents/grader.md +223 -0
  206. package/skills/conectese-skill-creator/assets/eval_review.html +146 -0
  207. package/skills/conectese-skill-creator/eval-viewer/generate_review.py +471 -0
  208. package/skills/conectese-skill-creator/eval-viewer/viewer.html +1325 -0
  209. package/skills/conectese-skill-creator/references/schemas.md +430 -0
  210. package/skills/conectese-skill-creator/references/skill-format.md +235 -0
  211. package/skills/conectese-skill-creator/scripts/__init__.py +0 -0
  212. package/skills/conectese-skill-creator/scripts/aggregate_benchmark.py +401 -0
  213. package/skills/conectese-skill-creator/scripts/quick_validate.py +103 -0
  214. package/skills/conectese-skill-creator/scripts/run_eval.py +310 -0
  215. package/skills/conectese-skill-creator/scripts/utils.py +47 -0
  216. package/skills/image-ai-generator/SKILL.md +124 -0
  217. package/skills/image-ai-generator/scripts/generate.py +175 -0
  218. package/skills/image-creator/SKILL.md +155 -0
  219. package/skills/image-fetcher/SKILL.md +91 -0
  220. package/skills/instagram-publisher/SKILL.md +119 -0
  221. package/skills/instagram-publisher/scripts/publish.js +165 -0
  222. package/skills/resend/SKILL.md +80 -0
  223. package/skills/template-designer/SKILL.md +201 -0
  224. package/skills/template-designer/base-templates/model-a.html +27 -0
  225. package/skills/template-designer/base-templates/model-b.html +31 -0
  226. package/skills/template-designer/base-templates/model-c.html +42 -0
  227. package/src/agents-cli.js +158 -0
  228. package/src/agents.js +134 -0
  229. package/src/i18n.js +48 -0
  230. package/src/init.js +341 -0
  231. package/src/locales/en.json +73 -0
  232. package/src/locales/es.json +72 -0
  233. package/src/locales/pt-BR.json +72 -0
  234. package/src/logger.js +38 -0
  235. package/src/prompt.js +46 -0
  236. package/src/readme/README.md +119 -0
  237. package/src/runs.js +90 -0
  238. package/src/skills-cli.js +157 -0
  239. package/src/skills.js +146 -0
  240. package/src/update.js +169 -0
  241. package/templates/_conectese/.conectese-version +1 -0
  242. package/templates/_conectese/_investigations/.gitkeep +0 -0
  243. package/templates/ide-templates/antigravity/.agent/rules/conectese.md +55 -0
  244. package/templates/ide-templates/antigravity/.agent/workflows/conectese.md +102 -0
  245. package/templates/ide-templates/claude-code/.claude/skills/conectese/SKILL.md +182 -0
  246. package/templates/ide-templates/claude-code/.mcp.json +8 -0
  247. package/templates/ide-templates/claude-code/CLAUDE.md +43 -0
  248. package/templates/ide-templates/codex/.agents/skills/conectese/SKILL.md +6 -0
  249. package/templates/ide-templates/codex/AGENTS.md +105 -0
  250. package/templates/ide-templates/cursor/.cursor/commands/conectese.md +9 -0
  251. package/templates/ide-templates/cursor/.cursor/mcp.json +8 -0
  252. package/templates/ide-templates/cursor/.cursor/rules/conectese.mdc +48 -0
  253. package/templates/ide-templates/cursor/.cursorignore +3 -0
  254. package/templates/ide-templates/opencode/.opencode/commands/conectese.md +9 -0
  255. package/templates/ide-templates/opencode/AGENTS.md +105 -0
  256. package/templates/ide-templates/vscode-copilot/.github/prompts/conectese.prompt.md +201 -0
  257. package/templates/ide-templates/vscode-copilot/.vscode/mcp.json +8 -0
  258. package/templates/ide-templates/vscode-copilot/.vscode/settings.json +3 -0
  259. package/templates/package.json +8 -0
  260. package/templates/squads/.gitkeep +0 -0
package/skills/image-creator/SKILL.md ADDED
@@ -0,0 +1,155 @@
1
+ ---
2
+ name: image-creator
3
+ description: >
4
+ Renders HTML/CSS into production-ready images via Playwright.
5
+ Accepts complete HTML content, opens it in a headless browser at
6
+ the specified viewport, and captures a pixel-perfect screenshot.
7
+ Generic engine -- any visual format is defined by the HTML template.
8
+ description_pt-BR: >
9
+ Renderiza HTML/CSS em imagens prontas para produção via Playwright.
10
+ Aceita conteúdo HTML completo, abre em um navegador headless na
11
+ viewport especificada e captura uma screenshot pixel-perfect.
12
+ Motor genérico -- qualquer formato visual é definido pelo template HTML.
13
+ description_es: >
14
+ Renderiza HTML/CSS en imágenes listas para producción vía Playwright.
15
+ Acepta contenido HTML completo, lo abre en un navegador headless en
16
+ el viewport especificado y captura una screenshot pixel-perfect.
17
+ Motor genérico -- cualquier formato visual se define por el template HTML.
18
+ type: mcp
19
+ version: "1.0.0"
20
+ mcp:
21
+ server_name: playwright
22
+ categories: [design, automation, images]
23
+ ---
24
+
25
+ # Image Creator
26
+
27
+ ## When to use
28
+
29
+ Use the Visual Renderer when you need to generate production-ready images from HTML/CSS. This skill uses Playwright to render complete, self-contained HTML files in a headless browser and capture pixel-perfect screenshots. It is the primary engine for creating social media graphics, carousel slides, infographics, and any other visual content defined by HTML templates.
30
+
31
+ ## Instructions
32
+
33
+ ### Core Workflow
34
+
35
+ 1. **Generate HTML** -- Write a complete, self-contained HTML file with inline CSS. The HTML IS the design -- all styling, layout, fonts, colors, and content must be embedded.
36
+
37
+ 2. **Save HTML** -- Write the HTML file to the squad's output folder (e.g., `output/slides/slide-01.html`)
38
+
39
+ 3. **Start HTTP server** -- Before rendering, start a local HTTP server in the squad's output folder:
40
+ ```bash
41
+ python -m http.server 8765 --directory "OUTPUT_DIR" &
42
+ for i in $(seq 1 30); do curl -s http://localhost:8765 > /dev/null 2>&1 && break || sleep 0.1; done
43
+ ```
44
+ Replace OUTPUT_DIR with the actual absolute path to the output folder (quote paths that contain spaces).
45
+
46
+ 4. **Render** -- Use Playwright to:
47
+ - `browser_navigate` to `http://localhost:8765/slide-01.html` (filename only, not full path)
48
+ - `browser_resize` to target viewport dimensions
49
+ - `browser_take_screenshot` to save as PNG
50
+
51
+ 5. **Verify** -- Read the screenshot to confirm quality. Re-render if needed.
52
+
53
+ 6. **Stop server** -- After all slides are rendered, stop the HTTP server:
54
+ ```bash
55
+ pkill -f "http.server 8765" 2>/dev/null || true
56
+ ```
57
+
58
+ ### Viewport Presets (width x height)
59
+
60
+ Use these standard dimensions:
61
+ - Instagram Post: 1080 x 1080
62
+ - Instagram Carousel: 1080 x 1440
63
+ - Instagram Story/Reel: 1080 x 1920
64
+ - Facebook Post: 1200 x 630
65
+ - Twitter/X Post: 1200 x 675
66
+ - LinkedIn Post: 1200 x 627
67
+ - YouTube Thumbnail: 1280 x 720
68
+ - Custom: as specified by the squad
69
+
70
+ ### HTML Template Guidelines
71
+
72
+ The HTML you generate MUST:
73
+ - Be self-contained (inline CSS, no external dependencies)
74
+ - Use web-safe fonts OR Google Fonts via `@import`
75
+ - Embed images as absolute paths or base64 data URIs
76
+ - Set exact body dimensions matching the viewport
77
+ - Use `margin: 0; padding: 0; overflow: hidden` on body
78
+ - Account for device pixel ratio if high-res needed
79
+
80
+ Example minimal structure:
81
+ ```html
82
+ <!DOCTYPE html>
83
+ <html>
84
+ <head>
85
+ <meta charset="UTF-8">
86
+ <style>
87
+ * { margin: 0; padding: 0; box-sizing: border-box; }
88
+ body { width: 1080px; height: 1440px; overflow: hidden; }
89
+ /* ... your design ... */
90
+ </style>
91
+ </head>
92
+ <body>
93
+ <!-- Your content -->
94
+ </body>
95
+ </html>
96
+ ```
97
+
98
+ ### Batch Rendering (Carousels/Multi-slide)
99
+
100
+ For multi-image outputs like carousels:
101
+ 1. Generate one HTML file per slide
102
+ 2. Start the HTTP server **once** before the batch (step 3 of Core Workflow)
103
+ 3. Render each slide sequentially (step 4 repeated per slide)
104
+ 4. Stop the HTTP server **once** after all slides are done (step 6 of Core Workflow)
105
+ 5. Name output files with zero-padded numbers: slide-01.png, slide-02.png, slide-03.png
106
+ 6. Keep all slides at the same viewport dimensions
107
+
108
+ ### Best Practices
109
+
110
+ - Always verify the first rendered image before batch rendering
111
+ - Use CSS Grid/Flexbox for layout -- most reliable across renderers
112
+ - Avoid animations/transitions (static screenshot only)
113
+ - For rounded corners on images, use CSS `border-radius` + `overflow`
114
+ - For emoji rendering, rely on system fonts (Windows: Segoe UI Emoji)
115
+ - Test text overflow -- ensure no content is clipped unexpectedly
116
+ - Keep HTML files alongside output PNGs for easy re-rendering
117
+
118
+ ### Typography & Readability Rules
119
+
120
+ Text must be legible in the target platform's smallest viewing context (mobile feed for social platforms). Text inside linked or embedded image files (JPG, PNG, base64 assets) is decorative and exempt. All HTML text nodes and inline SVG text are subject to these rules.
121
+
122
+ These are HARD minimums -- never go below them for readable text.
123
+
124
+ #### Minimum Font Sizes by Platform
125
+
126
+ | Text Role | Instagram Post/Carousel | Instagram Story/Reel | LinkedIn/Facebook | YouTube Thumb |
127
+ |------------------|------------------------|----------------------|-------------------|---------------|
128
+ | Hero / Display | 58px | 56px | 40px | 60px |
129
+ | Heading | 43px | 42px | 32px | 36px |
130
+ | Body / Bullets | 34px | 32px | 24px | 36px |
131
+ | Caption / Footer | 24px | 20px | 20px | 32px |
132
+
133
+ **Universal rule**: No text element meant to be read may use a font size smaller than 20px, on any platform.
134
+
135
+ #### Font Weight
136
+
137
+ - Body text and above: use font-weight 500+ (medium/semibold/bold)
138
+ - Caption text: font-weight 500+ strongly recommended; 400 only with explicit high-contrast background (4.5:1 ratio minimum)
139
+ - Avoid thin/light weights (100-300) for any readable text
140
+
141
+ #### Verification Checklist
142
+
143
+ Before calling `browser_take_screenshot`, scan your HTML and confirm:
144
+ - All text elements use explicit px sizes (not em/rem that could resolve smaller)
145
+ - No heading is below the Heading minimum for the target platform
146
+ - No body/bullet text is below the Body minimum
147
+ - No footer or metadata text is below the Caption minimum
148
+ - No readable text uses font-weight below 500 (caption at 400 only with 4.5:1 contrast background)
149
+
150
+ ## Available operations
151
+
152
+ - **Render HTML to PNG** -- Convert self-contained HTML/CSS into a pixel-perfect screenshot
153
+ - **Batch Render** -- Render multiple slides/pages sequentially for carousels and multi-image content
154
+ - **Viewport Resize** -- Set precise viewport dimensions for any target platform
155
+ - **Quality Verification** -- Visually inspect rendered output and re-render if needed
package/skills/image-fetcher/SKILL.md ADDED
@@ -0,0 +1,91 @@
1
+ ---
2
+ name: image-fetcher
3
+ description: >
4
+ Acquires visual assets from multiple sources: web image search,
5
+ live website screenshots via Playwright, and user-provided files.
6
+ Organizes assets in the squad's reference folder.
7
+ description_pt-BR: >
8
+ Obtém assets visuais de múltiplas fontes: busca de imagens na web,
9
+ capturas de sites via Playwright e arquivos fornecidos pelo usuário.
10
+ Organiza os assets na pasta de referência do squad.
11
+ description_es: >
12
+ Obtiene assets visuales de múltiples fuentes: búsqueda de imágenes en la web,
13
+ capturas de sitios vía Playwright y archivos proporcionados por el usuario.
14
+ Organiza los assets en la carpeta de referencia del squad.
15
+ type: hybrid
16
+ version: "1.0.0"
17
+ mcp:
18
+ server_name: playwright
19
+ categories: [assets, scraping, automation, images]
20
+ ---
21
+
22
+ # Asset Fetcher
23
+
24
+ ## When to use
25
+
26
+ Use the Asset Fetcher when you need to acquire visual assets for content creation. It supports three acquisition modes: web image search, live website screenshots via Playwright, and organizing user-provided files. All assets are saved to the squad's reference or output folder with descriptive filenames and metadata.
27
+
28
+ ## Instructions
29
+
30
+ ### Capabilities
31
+
32
+ 1. **Web Image Search** -- Use the native web_search tool to find images by keyword. Evaluate results and download the best match.
33
+
34
+ 2. **Live Screenshot** -- Use Playwright MCP to navigate to a URL, set viewport dimensions, and capture a screenshot.
35
+
36
+ 3. **Asset Organization** -- Save all acquired assets with descriptive filenames in the squad's reference/ or output/ folder.
37
+
38
+ ### Screenshot Modes
39
+
40
+ - **viewport** -- Capture only the visible viewport area (default)
41
+ - **full_page** -- Capture the entire scrollable page
42
+ - **selector** -- Capture a specific CSS selector element
43
+
44
+ ### Screenshot Workflow
45
+
46
+ When taking a screenshot:
47
+ 1. Navigate to the URL with `browser_navigate`
48
+ 2. Set viewport: `browser_resize` with width/height for target format
49
+ - Instagram post: 1080x1080
50
+ - Instagram carousel: 1080x1440
51
+ - Story/Reel: 1080x1920
52
+ - Generic: 1280x720
53
+ 3. Wait for page load (`browser_wait_for` if needed)
54
+ 4. Capture: `browser_take_screenshot`
55
+ 5. Save to reference folder with descriptive filename
56
+
57
+ ### Asset Metadata
58
+
59
+ After acquiring each asset, document in your output:
60
+ - `path`: local file path
61
+ - `width/height`: image dimensions
62
+ - `source_type`: "web_search" | "screenshot" | "user_provided"
63
+ - `original_url`: source URL (if applicable)
64
+
65
+ ### Cache Policy
66
+
67
+ Before fetching an asset:
68
+ - Check if the reference folder already has a matching file
69
+ - Use deterministic filenames based on source (e.g., URL slug + viewport)
70
+ - Reuse existing assets to avoid redundant fetches
71
+
72
+ ### Safety
73
+
74
+ - Timeout: max 30s per screenshot, skip and warn if exceeded
75
+ - Maximum screenshot dimensions: 1920x1920px
76
+ - Block `file://` protocol URLs
77
+ - Block localhost and private IP ranges (127.0.0.1, 10.x, 192.168.x)
78
+
79
+ ### Best Practices
80
+
81
+ - Prefer screenshots over web search for product/tool pages (images are often outdated)
82
+ - Save with descriptive names: `gemini-benchmark-chart.png` not `image1.png`
83
+ - Normalize URLs before caching (strip tracking params)
84
+ - Document all acquired assets with metadata for downstream tools
85
+
86
+ ## Available operations
87
+
88
+ - **Web Image Search** -- Find and download images by keyword from the web
89
+ - **Live Screenshot** -- Capture viewport, full-page, or element screenshots of any URL
90
+ - **Asset Organization** -- Save and catalog assets with descriptive filenames and metadata
91
+ - **Cache Check** -- Detect and reuse previously fetched assets to avoid redundant downloads
package/skills/instagram-publisher/SKILL.md ADDED
@@ -0,0 +1,119 @@
1
+ ---
2
+ name: instagram-publisher
3
+ description: >
4
+ Publishes Instagram carousel posts from local images.
5
+ Uploads images to imgBB (requires API key) for public hosting, creates Instagram
6
+ media containers via the Graph API, and publishes the carousel.
7
+ Supports 2-10 images per post and retrieves the real post permalink.
8
+ description_pt-BR: >
9
+ Publica carrosséis do Instagram a partir de imagens locais.
10
+ Faz upload das imagens para o imgBB (requer chave de API) como hospedagem pública,
11
+ cria containers de mídia via Graph API e publica o carrossel.
12
+ Suporta de 2 a 10 imagens por post e obtém o permalink real.
13
+ description_es: >
14
+ Publica carruseles de Instagram a partir de imágenes locales.
15
+ Sube las imágenes a imgBB (requiere clave de API) como hosting público, crea
16
+ contenedores de medios vía Graph API y publica el carrusel.
17
+ Soporta de 2 a 10 imágenes por post y obtiene el permalink real.
18
+ type: script
19
+ version: "1.0.0"
20
+ script:
21
+ path: scripts/publish.js
22
+ runtime: node
23
+ invoke: "node --env-file=.env {skill_path}/scripts/publish.js --images \"{images}\" --caption \"{caption}\""
24
+ env:
25
+ - INSTAGRAM_ACCESS_TOKEN
26
+ - INSTAGRAM_USER_ID
27
+ - IMGBB_API_KEY
28
+ categories: [social-media, publishing, instagram]
29
+ ---
30
+
31
+ # Instagram Publisher
32
+
33
+ ## When to use
34
+
35
+ Use the Instagram Publisher when you need to publish carousel posts directly to an Instagram Business account. This skill handles the full workflow: uploading images to imgBB (requires your own API key from https://api.imgbb.com/), creating Instagram media containers via the Graph API, and publishing the carousel. It supports 2-10 JPEG images per post.
36
+
37
+
38
+ ## Instructions
39
+
40
+ ### Workflow
41
+
42
+ 1. List JPEG files in `squads/{squad}/output/images/` sorted by name.
43
+ If no files found: stop and ask the user to add images before continuing.
44
+ 2. Present the image list to the user with AskUserQuestion to confirm order.
45
+ 3. Extract the caption from the content draft:
46
+ - Use the hook slide text + CTA slide text
47
+ - Max 2200 characters (Instagram limit)
48
+ 4. Run the publish script:
49
+ ```
50
+ node --env-file=.env squads/{squad}/tools/publish.js \
51
+ --images "<comma-separated-ordered-paths>" \
52
+ --caption "<caption>"
53
+ ```
54
+ Add `--dry-run` to test the full flow without actually publishing.
55
+ 5. On success: save the post URL and post ID to the step output file.
56
+ 6. On failure: display the error and ask the user how to proceed.
57
+
58
+ ### Constraints
59
+
60
+ - Images: JPEG only, 2-10 per carousel
61
+ - Caption: max 2200 characters
62
+ - Requires Instagram Business account (not Personal or Creator)
63
+ - Rate limit: 25 API-published posts per 24 hours
64
+
65
+ ### Setup (first-time)
66
+
67
+ Copy `.env.example` to `.env` and fill in the two required variables:
68
+
69
+ ```
70
+ INSTAGRAM_ACCESS_TOKEN=
71
+ INSTAGRAM_USER_ID=
72
+ ```
73
+
74
+ #### INSTAGRAM_ACCESS_TOKEN
75
+
76
+ Pré-requisito: conta Instagram Business conectada a uma Página do Facebook, e um app criado em [developers.facebook.com](https://developers.facebook.com/) (tipo: **Empresa**).
77
+
78
+ **Para obter um token de longa duração (válido 60 dias):**
79
+
80
+ 1. Acesse seu app → **Graph API Explorer**
81
+ 2. No dropdown do topo, selecione seu app
82
+ 3. Clique em **"Gerar token de acesso"**
83
+ 4. Ative as permissões:
84
+ - `instagram_content_publish`
85
+ - `instagram_basic`
86
+ - `pages_read_engagement`
87
+ 5. Clique em **"Gerar token de acesso"** e autorize — você receberá um token de curta duração (1h)
88
+ 6. Converta para longa duração (60 dias) com este GET:
89
+ ```
90
+ https://graph.facebook.com/oauth/access_token
91
+ ?grant_type=fb_exchange_token
92
+ &client_id={APP_ID}
93
+ &client_secret={APP_SECRET}
94
+ &fb_exchange_token={TOKEN_CURTO}
95
+ ```
96
+ _(APP_ID e APP_SECRET: seu app → Configurações → Básico)_
97
+ 7. Copie o `access_token` da resposta e cole em `.env`
98
+
99
+ > O token expira em 60 dias. Repita o processo para renovar.
100
+
101
+ #### INSTAGRAM_USER_ID
102
+
103
+ 1. No Graph API Explorer (com o token acima), faça GET em:
104
+ ```
105
+ /me/accounts
106
+ ```
107
+ 2. Localize sua **Página do Facebook** na resposta e anote o `id`
108
+ 3. Faça GET em:
109
+ ```
110
+ /{page-id}?fields=instagram_business_account
111
+ ```
112
+ 4. Copie o `id` dentro de `instagram_business_account` — esse é o seu User ID
113
+
114
+ ## Available operations
115
+
116
+ - **Publish Carousel** -- Upload images and publish a carousel post to Instagram
117
+ - **Dry Run** -- Test the full publishing flow without actually posting (use `--dry-run` flag)
118
+ - **Image Upload** -- Upload local JPEG images to imgBB (requires API key)
119
+ - **Status Check** -- Monitor media container processing status before publishing
package/skills/instagram-publisher/scripts/publish.js ADDED
@@ -0,0 +1,165 @@
1
+ #!/usr/bin/env node
2
+ // Instagram Carousel Publisher
3
+ // Usage: node --env-file=.env publish.js --images "slide1.jpg,slide2.jpg" --caption "..." [--dry-run]
4
+
5
+ import { readFileSync } from 'node:fs';
6
+ import { resolve } from 'node:path';
7
+ import { fileURLToPath } from 'node:url';
8
+
9
+ // ── Argument parsing ──────────────────────────────────────────
10
+
11
+ export function parseArgs(argv) {
12
+ const args = { images: [], caption: '', dryRun: false };
13
+ for (let i = 2; i < argv.length; i++) {
14
+ if (argv[i] === '--images') {
15
+ if (i + 1 < argv.length) args.images = argv[++i].split(',').map(s => s.trim());
16
+ }
17
+ else if (argv[i] === '--caption') {
18
+ if (i + 1 < argv.length) args.caption = argv[++i];
19
+ }
20
+ else if (argv[i] === '--dry-run') args.dryRun = true;
21
+ }
22
+ return args;
23
+ }
24
+
25
+ // ── Image upload (imgBB) ──────────────────────────────────────
26
+
27
+ export async function uploadToImgBB(imagePath, apiKey) {
28
+ const absolutePath = resolve(imagePath);
29
+ const fileBuffer = readFileSync(absolutePath);
30
+ const base64Image = fileBuffer.toString('base64');
31
+ const form = new FormData();
32
+ form.append('key', apiKey);
33
+ form.append('image', base64Image);
34
+ const res = await fetch('https://api.imgbb.com/1/upload', {
35
+ method: 'POST',
36
+ body: form,
37
+ });
38
+ if (!res.ok) throw new Error(`imgBB upload failed [${res.status}]: ${await res.text()}`);
39
+ const json = await res.json();
40
+ if (!json.success) throw new Error(`imgBB upload failed: ${JSON.stringify(json)}`);
41
+ return json.data.url;
42
+ }
43
+
44
+ // ── Instagram Graph API ───────────────────────────────────────
45
+
46
+ const IG_BASE = 'https://graph.facebook.com/v21.0';
47
+
48
+ export async function createChildContainer(userId, imageUrl, accessToken) {
49
+ const params = new URLSearchParams({
50
+ image_url: imageUrl,
51
+ is_carousel_item: 'true',
52
+ access_token: accessToken,
53
+ });
54
+ const res = await fetch(`${IG_BASE}/${userId}/media?${params}`, { method: 'POST' });
55
+ if (!res.ok) throw new Error(`createChildContainer failed [${res.status}]: ${await res.text()}`);
56
+ return (await res.json()).id;
57
+ }
58
+
59
+ export async function getContainerStatus(containerId, accessToken) {
60
+ const params = new URLSearchParams({ fields: 'status_code', access_token: accessToken });
61
+ const res = await fetch(`${IG_BASE}/${containerId}?${params}`);
62
+ if (!res.ok) throw new Error(`getContainerStatus failed [${res.status}]: ${await res.text()}`);
63
+ return (await res.json()).status_code;
64
+ }
65
+
66
+ export async function pollUntilFinished(containerId, accessToken, timeoutMs = 60_000, intervalMs = 3_000) {
67
+ const deadline = Date.now() + timeoutMs;
68
+ while (Date.now() < deadline) {
69
+ const status = await getContainerStatus(containerId, accessToken);
70
+ if (status === 'FINISHED') return;
71
+ if (status === 'ERROR') throw new Error(`Container ${containerId} entered ERROR state`);
72
+ await new Promise(r => setTimeout(r, intervalMs));
73
+ }
74
+ throw new Error(`Container ${containerId} timed out after ${timeoutMs}ms`);
75
+ }
76
+
77
+ export async function createCarouselContainer(userId, childIds, caption, accessToken) {
78
+ const params = new URLSearchParams({
79
+ media_type: 'CAROUSEL',
80
+ children: childIds.join(','),
81
+ caption,
82
+ access_token: accessToken,
83
+ });
84
+ const res = await fetch(`${IG_BASE}/${userId}/media?${params}`, { method: 'POST' });
85
+ if (!res.ok) throw new Error(`createCarouselContainer failed [${res.status}]: ${await res.text()}`);
86
+ return (await res.json()).id;
87
+ }
88
+
89
+ export async function publishMedia(userId, containerId, accessToken) {
90
+ const params = new URLSearchParams({ creation_id: containerId, access_token: accessToken });
91
+ const res = await fetch(`${IG_BASE}/${userId}/media_publish?${params}`, { method: 'POST' });
92
+ if (!res.ok) throw new Error(`publishMedia failed [${res.status}]: ${await res.text()}`);
93
+ return (await res.json()).id;
94
+ }
95
+
96
+ export async function getPermalink(mediaId, accessToken) {
97
+ const params = new URLSearchParams({ fields: 'permalink', access_token: accessToken });
98
+ const res = await fetch(`${IG_BASE}/${mediaId}?${params}`);
99
+ if (!res.ok) return null; // non-fatal — just skip the URL display
100
+ const json = await res.json();
101
+ return json.permalink ?? null;
102
+ }
103
+
104
+ // ── Main ──────────────────────────────────────────────────────
105
+
106
+ async function main() {
107
+ const { images, caption, dryRun } = parseArgs(process.argv);
108
+
109
+ if (!images.length) throw new Error('--images is required (e.g. --images "slide1.jpg,slide2.jpg")');
110
+ if (!caption) throw new Error('--caption is required');
111
+ if (images.length < 2 || images.length > 10) {
112
+ throw new Error(`Instagram carousels require 2–10 images (got ${images.length})`);
113
+ }
114
+ if (caption.length > 2200) {
115
+ throw new Error(`Caption exceeds Instagram's 2200-character limit (got ${caption.length})`);
116
+ }
117
+
118
+ const { INSTAGRAM_ACCESS_TOKEN, INSTAGRAM_USER_ID, IMGBB_API_KEY } = process.env;
119
+ if (!INSTAGRAM_ACCESS_TOKEN) throw new Error('INSTAGRAM_ACCESS_TOKEN is not set in environment');
120
+ if (!INSTAGRAM_USER_ID) throw new Error('INSTAGRAM_USER_ID is not set in environment');
121
+ if (!IMGBB_API_KEY) throw new Error('IMGBB_API_KEY is not set in environment. Get one at https://api.imgbb.com/');
122
+
123
+ console.log(`📸 Uploading ${images.length} image(s) to imgBB...`);
124
+ const imageUrls = await Promise.all(images.map(p => uploadToImgBB(p, IMGBB_API_KEY)));
125
+ imageUrls.forEach((url, i) => console.log(` [${i + 1}] ${url}`));
126
+
127
+ console.log('\n📦 Creating Instagram media containers...');
128
+ const childIds = await Promise.all(
129
+ imageUrls.map(url => createChildContainer(INSTAGRAM_USER_ID, url, INSTAGRAM_ACCESS_TOKEN))
130
+ );
131
+ console.log(` Container IDs: ${childIds.join(', ')}`);
132
+
133
+ console.log('\n⏳ Waiting for containers to finish processing...');
134
+ await Promise.all(childIds.map(id => pollUntilFinished(id, INSTAGRAM_ACCESS_TOKEN)));
135
+ console.log(' All containers ready.');
136
+
137
+ console.log('\n🎠 Creating carousel container...');
138
+ const carouselId = await createCarouselContainer(
139
+ INSTAGRAM_USER_ID, childIds, caption, INSTAGRAM_ACCESS_TOKEN
140
+ );
141
+ await pollUntilFinished(carouselId, INSTAGRAM_ACCESS_TOKEN);
142
+ console.log(` Carousel container ID: ${carouselId}`);
143
+
144
+ if (dryRun) {
145
+ console.log('\n✅ DRY RUN complete — skipping final publish call.');
146
+ console.log(` Carousel container ready: ${carouselId}`);
147
+ return;
148
+ }
149
+
150
+ console.log('\n🚀 Publishing to Instagram...');
151
+ const postId = await publishMedia(INSTAGRAM_USER_ID, carouselId, INSTAGRAM_ACCESS_TOKEN);
152
+ const permalink = await getPermalink(postId, INSTAGRAM_ACCESS_TOKEN);
153
+ console.log(`\n✅ Published successfully!`);
154
+ console.log(` Post ID: ${postId}`);
155
+ if (permalink) console.log(` URL: ${permalink}`);
156
+ }
157
+
158
+ // Run only when executed directly (not when imported for tests)
159
+ const isMain = process.argv[1] === fileURLToPath(import.meta.url);
160
+ if (isMain) {
161
+ main().catch(err => {
162
+ console.error(`\n❌ ${err.message}`);
163
+ process.exit(1);
164
+ });
165
+ }
package/skills/resend/SKILL.md ADDED
@@ -0,0 +1,80 @@
1
+ ---
2
+ name: resend
3
+ description: >
4
+ Send emails through Resend's official MCP server.
5
+ Supports single send, batch send, HTML and plain text bodies,
6
+ attachments, CC/BCC, scheduling, and contact management.
7
+ description_pt-BR: >
8
+ Envie emails pelo servidor MCP oficial da Resend.
9
+ Suporta envio individual, envio em lote, corpo HTML e texto puro,
10
+ anexos, CC/BCC, agendamento e gerenciamento de contatos.
11
+ description_es: >
12
+ Enviar correos electrónicos a través del servidor MCP oficial de Resend.
13
+ Soporta envío individual, envío por lotes, cuerpo HTML y texto plano,
14
+ adjuntos, CC/BCC, programación y gestión de contactos.
15
+ type: mcp
16
+ version: "1.0.0"
17
+ mcp:
18
+ server_name: resend
19
+ command: npx
20
+ args: ["-y", "resend-mcp"]
21
+ transport: stdio
22
+ env:
23
+ - RESEND_API_KEY
24
+ categories: [email, automation, communication]
25
+ ---
26
+
27
+ # Resend — Email Skill
28
+
29
+ ## When to use
30
+
31
+ Use this skill when a squad needs to send emails — welcome messages, notifications,
32
+ reports, newsletters, or any transactional/marketing email. Resend handles delivery
33
+ so the squad only needs to compose the content and call the MCP tools.
34
+
35
+ ## Instructions
36
+
37
+ ### Sending a single email
38
+
39
+ 1. Prepare **from**, **to**, **subject**, and **body** (HTML or plain text).
40
+ 2. Call the Resend MCP `send_email` tool.
41
+ 3. Check the response for a successful `id` — that confirms the email was queued.
42
+
43
+ ### Sending a batch
44
+
45
+ 1. Build an array of email objects (same fields as single send).
46
+ 2. Call the Resend MCP `batch_send_emails` tool.
47
+ 3. Each item in the response will have its own `id` or error.
48
+
49
+ ### Attachments
50
+
51
+ Pass attachments as an array with `filename`, `path` (local file), `url`, or `content` (base64).
52
+
53
+ ### Scheduling
54
+
55
+ Include a `scheduled_at` field (ISO 8601 datetime) to schedule future delivery.
56
+
57
+ ## Best practices
58
+
59
+ - Validate **from** against a verified domain before sending — Resend rejects unverified senders.
60
+ - Keep subject lines under 80 characters for better deliverability.
61
+ - For batch sends, group by shared content to reduce payload size.
62
+ - Always check the response for errors and surface them to the user rather than silently failing.
63
+ - When composing HTML emails, keep the markup simple — most email clients ignore complex CSS.
64
+
65
+ ## Available operations
66
+
67
+ - **Send Email** — Single email with HTML/text body, attachments, CC/BCC, reply-to
68
+ - **Batch Send** — Multiple emails in one call
69
+ - **Schedule Email** — Queue an email for future delivery
70
+ - **List/Get Emails** — Check delivery status of sent emails
71
+ - **Cancel Email** — Cancel a scheduled email before it sends
72
+ - **Manage Contacts** — Create, list, update, and remove contacts from audiences
73
+ - **Manage Domains** — Add and verify sender domains
74
+
75
+ ## Setup
76
+
77
+ 1. Create a free account at [resend.com](https://resend.com)
78
+ 2. Generate an API key (starts with `re_`)
79
+ 3. Add a verified sender domain (or use Resend's shared `onboarding@resend.dev` for testing)
80
+ 4. Set `RESEND_API_KEY` in your `.env` file