@rubytech/create-sitedesk-code 0.1.340

package/payload/premium-plugins/sitedesk/plugins/sitedesk-media/skills/microsite/templates/llms.txt

@@ -0,0 +1,32 @@
+# {{ COMPANY_LEGAL_NAME }}
+
+> {{ LLMS_SUMMARY }}
+
+## Facts
+
+- Legal name: {{ COMPANY_LEGAL_NAME }}
+- Company number: {{ COMPANY_NUMBER }} (registered in {{ COMPANY_JURISDICTION }})
+- Registered office: {{ STREET_ADDRESS }}, {{ POST_TOWN }}, {{ COUNTY }}, {{ POSTCODE }}
+- Established: {{ ESTABLISHED_YEAR }} ({{ YEARS_TRADING }} of experience)
+- Ownership: {{ OWNERSHIP }}
+- Areas served: {{ REGION }}
+- Telephone: {{ PHONE_DISPLAY }} / {{ MOBILE_DISPLAY }}
+- Email: {{ EMAIL }}
+- Led by {{ FOUNDER_NAME }}, who runs the team and posts project progress directly.
+- Recent projects: {{ RECENT_PROJECTS }}
+
+## Services
+
+- {{ SERVICE_1_NAME }}: {{ SERVICE_1_DESC }}
+- {{ SERVICE_2_NAME }}: {{ SERVICE_2_DESC }}
+- {{ SERVICE_3_NAME }}: {{ SERVICE_3_DESC }}
+- {{ SERVICE_4_NAME }}: {{ SERVICE_4_DESC }}
+- {{ SERVICE_5_NAME }}: {{ SERVICE_5_DESC }}
+- {{ SERVICE_6_NAME }}: {{ SERVICE_6_DESC }}
+
+## Links
+
+- Website: {{ WEBSITE_URL }}
+- Facebook: {{ FACEBOOK_URL }}
+- Instagram: {{ INSTAGRAM_URL }}
+- TikTok: {{ TIKTOK_URL }}

package/payload/premium-plugins/sitedesk/plugins/sitedesk-media/skills/socials/SKILL.md

@@ -0,0 +1,133 @@
+---
+name: socials
+description: Render share-ready Open Graph and social tiles plus per-platform captions for a named subject — a brand micro-site, a job's progress, a valuation cycle, or a bespoke topic — with a PII gate for any source that can carry client data. Resolves the subject through a source adapter into candidate images and copy, overlays brand typography, screenshots landscape (1200×628), square (1200×1200) and portrait (1080×1350) PNG tiles via the on-device browser, assembles a gallery and a captions file for all five platforms, and emits a redaction report reconciling every source item. For micro-sites it also wires the site's og:image. Never posts — the bundle is for operator review. Trigger phrases include "social tiles for this job", "og images for the site", "Instagram tiles + captions for <subject>", "social collateral for <business>".
+allowed-tools:
+  - Bash
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+  - mcp__plugin_browser_browser__browser-render
+  - mcp__plugin_browser_browser__browser-navigate
+  - mcp__plugin_browser_browser__browser-evaluate
+  - mcp__plugin_browser_browser__browser-resize
+  - mcp__plugin_browser_browser__browser-screenshot
+  - mcp__plugin_browser_browser__browser-wait-for
+---
+
+# socials
+
+One skill, one subject at a time. You take a named **subject**, resolve it through a
+source adapter, and emit a publication bundle: exact-size PNG social tiles, captions
+for all five platforms, a gallery, and — for any subject that can carry client data
+— a redaction report. You **never post**. The bundle is for the operator to review
+and sign off. You ship no business content; every fact is the operator's own data,
+read from the resolved source.
+
+## Inputs
+
+- **subject** — a name (the business, the job, the topic).
+- **mode** — one of `microsite`, `job`, `valuation`, `bespoke`.
+- **material** — the path the adapter reads (a built `site/`, a job folder, or the
+  operator's own photos and notes).
+- **output** — where the bundle lands (for `microsite`, the site's own `site/`).
+
+## 1. Resolve the subject, and echo it
+
+Resolve the subject through its adapter in [`references/sources.md`](references/sources.md)
+to the normalized intermediate (`topic`, headline/sub candidates, copy facts,
+candidate images, `piiBearing`). **Before you render anything, state the resolved
+subject and the source mode back** — e.g. "Resolving job 1737 in `valuation` mode,
+this period's progress." A mis-resolution must be visible here, not discovered in a
+finished tile.
+
+## 2. PII gate (if `piiBearing`)
+
+If the adapter's `piiBearing` is true (`job` and `valuation` always; `bespoke`
+unless the operator declared the material brand-safe), run the gate in
+[`references/pii-strip.md`](references/pii-strip.md) over **every** candidate image
+and **every** copy fact — before any of it reaches a template. Write
+`redaction-report.md` reconciling every source photo and text field as
+*used / redacted / rejected*. If every photo is rejected, stop and ask for a usable
+image; never emit an imageless bundle. **Do not present a bundle without the report.**
+`microsite` skips this step (the site is already published copy).
+
+## 3. Render the tiles (browser plugin, PNG)
+
+1. Build the resolved render page: copy [`templates/og.html`](templates/og.html) to
+   `<output>/og.html` and substitute `{{ CANDIDATES_JSON }}` with the vetted
+   candidate set (`{ key: { img, pos, head, sub }, … }`) plus the scalar tokens
+   (palette, eyebrow, specs, domain, phone). The logo and hero images resolve from
+   the output dir's `images/`.
+2. Serve `<output>/` over a local HTTP server so relative paths and webfonts load
+   (`cd <output> && python3 -m http.server <port>` via `Bash`; `file://` will not
+   load the fonts).
+3. For each tile, drive the on-device browser:
+   - `browser-navigate` to `http://localhost:<port>/og.html?format=F&hero=H`,
+   - `browser-resize` to the exact size — landscape `1200×628`, square `1200×1200`,
+     portrait `1080×1350`,
+   - `browser-evaluate` `document.fonts.ready.then(() => true)` (and a short settle)
+     so the webfonts have landed before capture,
+   - `browser-screenshot` to `<output>/socials/og-F-H.png`.
+   A **person** hero (`isPerson: true`) renders **portrait only** — a landscape or
+   square crop cuts off the head.
+4. `Read` each finished PNG to confirm it rendered: logo legible, copy readable,
+   scrim adequate. A **sub-20KB** file is a blank page (server not running, wrong
+   port, or the page threw) — diagnose before re-running, never ship it.
+
+## 4. Captions — all five platforms, plain register
+
+Build `<output>/social-posts.md` from [`templates/social-posts.md`](templates/social-posts.md):
+one block per tile, with copy for **Instagram, LinkedIn, TikTok, Facebook, and X**.
+Write every line in the plain register (the `plainly` skill): no em-dashes, no
+inflation vocabulary, no "it's not X, it's Y", no rhetorical openers, no emoji faking
+enthusiasm. For a `piiBearing` subject, no caption names the client, the address or
+postcode, any figure, any individual, or any email sender.
+
+## 5. Gallery, and (microsite only) the og:image
+
+Build `<output>/socials.html` from [`templates/socials.html`](templates/socials.html):
+repeat the group block once per tile key. For a **person** hero (`isPerson: true`),
+write only the portrait `<div class="tile">` cell for that key — delete the landscape
+and square cells, since those files are never rendered for a person.
+
+The OG snippet (`<div class="snippet">…</div>`) is **microsite only**. In `microsite`
+mode, keep it, render the tiles into the site's `site/socials/`, and set the site's
+`og:image`/`twitter:image` to `<WEBSITE_URL>socials/og-landscape-main.png` (a true
+1200×628 card beats a raw hero for link previews; `WEBSITE_URL` is the site's absolute
+URL from the brand pack). For a **job/valuation/bespoke** bundle there is no site to
+wire — **delete the whole `<div class="snippet">` block** from the copied template
+before substituting, so no `WEBSITE_URL` token survives.
+
+## Output contract
+
+```
+<output>/
+  og.html                         # the resolved render page (kept for re-runs)
+  socials/
+    og-landscape-<key>.png  og-square-<key>.png  og-portrait-<key>.png   # per tile
+    og-portrait-<person-key>.png  # a person hero: portrait only
+  socials.html                    # gallery: each tile at size, download links
+  social-posts.md                 # captions per tile, all five platforms
+  redaction-report.md             # piiBearing subjects only — the standing reconciliation
+```
+
+## Completion criteria
+
+- Every tile exists at its exact pixel size; a person tile is portrait only.
+- Captions cover all five platforms; `socials.html` previews each tile with a working
+  download link.
+- For a `piiBearing` subject, `redaction-report.md` is present and accounts for
+  **every** source photo and text field; no output names the client, the address, a
+  figure, an individual, or an email sender.
+- In `microsite` mode, the site's `og:image`/`twitter:image` point at the landscape
+  main tile.
+- `Read` each finished PNG — file size alone is not proof.
+
+## When NOT to use
+
+- The operator wants to **post** — this skill never posts; it produces a reviewable
+  bundle and stops.
+- The deliverable is the micro-site itself → `microsite`. The full marketing run
+  (site + tiles) → `make-media`, which calls this skill in `microsite` mode.

package/payload/premium-plugins/sitedesk/plugins/sitedesk-media/skills/socials/references/pii-strip.md

@@ -0,0 +1,64 @@
+# socials — PII gate
+
+The gate runs for every `piiBearing` subject ([`sources.md`](sources.md)): `job` and
+`valuation` always, `bespoke` unless the operator declares the material brand-safe.
+It runs **before** anything reaches a template — over every candidate image and
+every copy fact. `microsite` skips it (the site is already published copy).
+
+Detection is the agent's own visual and textual review against the taxonomy below
+plus operator confirmation. No computer-vision model ships; the operator-approval
+gate is the backstop. The skill **never posts** — the bundle is for review.
+
+## Text never emitted
+
+"Rendered-tile copy" means **every** text field that reaches a tile or a caption:
+the headline and sub (from the candidate set), the eyebrow, the four spec tags
+(`copyFacts.specs[]`), and every platform caption. The gate reviews all of them.
+
+No caption and no rendered-tile copy may contain:
+
+- the **client name** (person or company),
+- the **site address or postcode** (or any fragment that identifies the address),
+- any **contract, valuation, or payment figure** — any `£` amount, any pence/pound
+  value, any percentage that reveals a financial position,
+- any **named individual** (worker, client, neighbour, surveyor),
+- any **email sender** address or name lifted from an instruction email.
+
+The progress is the story. "Roof on, watertight — phase two complete" is publishable.
+"Valuation 3 for the Smiths at 14 Mill Lane, £42,310 due" is not.
+
+## Photos that are rejected
+
+Reject a candidate image (do not crop around it — reject the whole photo) if it
+shows:
+
+- a recognizable **face**,
+- a **vehicle number plate**,
+- a **house number, street sign, or nameplate**,
+- **visible client paperwork** — a letter, an invoice, a drawing with a title block,
+  a screen showing client data.
+
+A photo of the work itself — a finished wall, a roof line, a poured slab, a steel
+frame — with none of the above is usable.
+
+## The redaction report
+
+Every `piiBearing` run writes `redaction-report.md` to the output. It reconciles
+**every** source photo and **every** source text field to one disposition:
+
+- **used** — appears in the bundle (which tile / caption),
+- **redacted** — the source carried PII that was removed before use (name the field
+  and what was stripped),
+- **rejected** — not used at all (name the reason: which photo category, which text
+  rule).
+
+The report is the standing reconciliation that makes a silent leak visible: a source
+PII field that appears in an output but is absent from the report's redacted/rejected
+list is the failure signature. A **missing or empty report is itself a failure** —
+the skill refuses to present a bundle without it.
+
+## When every photo is rejected
+
+If vetting rejects every candidate image, stop and ask the operator for a usable
+photo. Never emit an imageless bundle, and never fall back to a stock or invented
+image — the report shows all photos *rejected* and no tile is written.

package/payload/premium-plugins/sitedesk/plugins/sitedesk-media/skills/socials/references/sources.md

@@ -0,0 +1,96 @@
+# socials — source adapters
+
+The `socials` skill resolves a named **subject** to a normalized intermediate that
+the shared render core consumes. One adapter per subject kind. This file is the
+contract and the **extension point**: a future subject (a quote, a timesheet, a
+testimonial) is a new row here, not a new skill.
+
+## The normalized intermediate
+
+Every adapter resolves its subject to this shape:
+
+```
+{
+  topic,              // one short phrase naming what the tiles are about
+  headlineCandidates, // [string] — lead lines, strongest first
+  subCandidates,      // [string] — supporting lines, paired to headlines
+  copyFacts,          // { eyebrow, specs[], domain, phone } — overlay scalars
+  candidateImages,    // [{ key, path, isPerson }] — vetted backgrounds
+  piiBearing          // boolean — does this source carry client data?
+}
+```
+
+`candidateImages[].key` becomes the tile `hero` and the filename suffix
+(`og-<format>-<key>.png`). `isPerson: true` marks a hero that must render
+**portrait only** (a landscape or square crop cuts off the head). `piiBearing`
+decides whether the PII gate in [`pii-strip.md`](pii-strip.md) runs before any of
+this reaches a template.
+
+## Adapters
+
+### `microsite` — `piiBearing: false`
+
+Reads a built `site/` directory (the output of `microsite`): the brand pack
+(`brand.md` tokens, `images/logo.png`) and the curated hero photos at the fixed
+paths the micro-site uses:
+
+| key | image | leads with |
+|---|---|---|
+| `main` | `images/hero-01.webp` | the firm's lead line |
+| `interior` | `images/hero-03.webp` | a finishes line |
+| `build` | `images/hero-06.webp` | a process line |
+| `founder` | `images/founder-portrait.webp` | "meet the…" — **`isPerson: true`, portrait only** |
+
+`copyFacts` for `microsite` is the brand pack's own credential cells (sector,
+trades, areas, years) plus `domain`, `phone`, and the site's full `WEBSITE_URL` (the
+microsite-only og:image wiring needs the absolute URL, not just the domain).
+
+Brand-safe by construction (the site is already published copy), so the PII gate is
+skipped. This is the path `make-media` calls as its final stage; it also wires the
+site's `og:image`/`twitter:image` to the landscape `main` tile.
+
+### `job` — `piiBearing: true`
+
+A whole-job progress milestone. Topic = the site/job overall. Reads the job folder
+`{ACCOUNT_DIR}/jobs/{jobId}/`:
+
+- **`state.json` — non-money fields only.** Read `lines[].description`,
+  `lines[].pctComplete`, `variations[].comment`, `variations[].status`,
+  `variations[].pctComplete`. The headline candidates come from the strongest
+  progress lines (highest `pctComplete`, an agreed variation comment).
+- **`source/` photos** as candidate images.
+- **`copyFacts.specs[]`** (the four small tile tags) and `copyFacts.eyebrow` carry
+  only neutral context — a stage name, a trade, a month, a town. **Never a figure**
+  (no `£`, no `pctComplete` value, no count of money) and **never a client
+  identifier**. "Phase two · Roofing · June" is fine; "80% · £42k" is not. These are
+  copy facts, so the PII gate reviews them like any other emitted text.
+
+**Never read** the money fields — `contractSumPence`, `lines[].contractValuePence`,
+`variations[].valuePence`, `paymentsReceived[]`, `vatRatePct`, `retentionPct` — and
+**never read** the issued documents under `valuations/`. Those carry the figures the
+client should never see on a public tile. `lines[].id` and `variations[].number` are
+**keys only** — use them to select a line, never as copy on a tile or caption (an
+operator may have keyed a line with a client name or address fragment).
+
+### `valuation` — `piiBearing: true`
+
+The current valuation cycle's progress. Same job folder and the **same non-money
+fields** as `job`, but framed to **this period**: the lines and variations whose
+`pctComplete` advanced this cycle. Topic = "this period's progress on the job". The
+same money-field and `valuations/`-document exclusions apply — read the progress,
+never the figures.
+
+### `bespoke` — `piiBearing: true` (operator may waive)
+
+An operator-chosen topic with the operator's own photos and notes. The operator
+supplies the topic, the headline/sub ideas, and the candidate images. The PII gate
+runs by default; the operator may declare the material brand-safe (their own
+marketing photos, no client identifiable) to skip it — that declaration is the only
+way the gate is waived for a bespoke subject.
+
+## Adding a subject later
+
+A new subject kind (quote, timesheet, testimonial, …) is a new adapter section here:
+name what it reads, how it maps to the normalized intermediate, and its `piiBearing`
+value. No new skill, no new render core, no new caption register. If the source can
+carry client data, set `piiBearing: true` and the existing gate covers it.

package/payload/premium-plugins/sitedesk/plugins/sitedesk-media/skills/socials/templates/og.html

@@ -0,0 +1,92 @@
+<!DOCTYPE html>
+<html lang="en-GB">
+<head>
+<meta charset="UTF-8">
+<title>{{ COMPANY_SHORT }} social tile renderer</title>
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link href="https://fonts.googleapis.com/css2?family=Cormorant+Garamond:ital,wght@0,400;0,500;1,400;1,500&family=Lora:ital,wght@0,400;1,400&family=Inter:wght@400;500;600&display=swap" rel="stylesheet">
+<style>
+  /* Brand tokens — substituted per subject by the resolving adapter. */
+  :root{
+    --ink:{{ INK_900 }}; --ink-2:{{ INK_700 }}; --paper:{{ PAPER_100 }}; --paper-2:{{ PAPER_200 }};
+    --copper:{{ ACCENT }}; --copper-soft:{{ ACCENT_SOFT }}; --brand-grey:{{ BRAND_GREY }};
+    --serif:'Cormorant Garamond',Garamond,serif; --body:'Lora',Georgia,serif; --sans:'Inter',system-ui,sans-serif;
+  }
+  *{margin:0;padding:0;box-sizing:border-box;}
+  html,body{background:var(--ink);}
+  body{display:flex;align-items:flex-start;justify-content:flex-start;}
+  .stage{position:relative;overflow:hidden;background:var(--ink);color:#fff;}
+  .stage.landscape{width:1200px;min-width:1200px;max-width:1200px;height:628px;min-height:628px;max-height:628px;}
+  .stage.square{width:1200px;min-width:1200px;max-width:1200px;height:1200px;min-height:1200px;max-height:1200px;}
+  .stage.portrait{width:1080px;min-width:1080px;max-width:1080px;height:1350px;min-height:1350px;max-height:1350px;}
+  .hero{position:absolute;inset:0;background-size:cover;background-position:center;}
+  .scrim{position:absolute;inset:0;
+    background:linear-gradient(180deg, rgba(0,0,0,.22) 0%, rgba(0,0,0,.10) 32%, rgba(0,0,0,.55) 72%, rgba(0,0,0,.84) 100%);}
+  /* real brand logo on a white chip so it reads on any photo */
+  .logo-chip{position:absolute;top:48px;left:64px;background:#fff;padding:16px 22px;
+    box-shadow:0 6px 22px rgba(0,0,0,.30);border-top:3px solid var(--copper);}
+  .logo-chip img{display:block;height:84px;width:auto;}
+  .copy{position:absolute;left:64px;right:64px;bottom:60px;}
+  .eyebrow{font-family:var(--sans);font-weight:600;font-size:17px;letter-spacing:.30em;text-transform:uppercase;color:var(--copper);margin-bottom:18px;}
+  .headline{font-family:var(--serif);font-style:italic;font-weight:500;font-size:72px;line-height:1.02;color:#fff;}
+  .sub{font-family:var(--body);font-style:italic;font-size:26px;color:#fff;opacity:.94;margin-top:14px;}
+  .rule{width:64px;height:2px;background:var(--copper);margin:24px 0 20px;}
+  .specs{font-family:var(--sans);font-weight:500;font-size:16px;letter-spacing:.10em;text-transform:uppercase;color:#fff;opacity:.92;}
+  .specs span+span::before{content:"·";color:var(--copper);margin:0 9px;}
+  .foot{display:flex;justify-content:space-between;align-items:center;margin-top:26px;padding-top:18px;
+    border-top:1px solid rgba(255,255,255,.28);
+    font-family:var(--sans);font-weight:600;font-size:15px;letter-spacing:.16em;text-transform:uppercase;color:#fff;}
+  .foot .r{color:var(--copper);}
+  .stage.square .headline,.stage.portrait .headline{font-size:84px;}
+  .stage.square .sub,.stage.portrait .sub{font-size:30px;}
+  .stage.square .eyebrow,.stage.portrait .eyebrow{font-size:19px;}
+  .stage.square .logo-chip img,.stage.portrait .logo-chip img{height:62px;}
+  .stage.portrait .copy{bottom:78px;}
+  .stage.square .copy{bottom:72px;}
+</style>
+</head>
+<body>
+  <div class="stage" id="stage">
+    <div class="hero" id="hero"></div>
+    <div class="scrim"></div>
+    <div class="logo-chip"><img src="images/logo.png" alt="{{ COMPANY_NAME }}"></div>
+    <div class="copy">
+      <div class="eyebrow">{{ TILE_EYEBROW }}</div>
+      <h1 class="headline" id="headline"></h1>
+      <div class="sub" id="sub"></div>
+      <div class="rule"></div>
+      <div class="specs"><span>{{ TILE_SPEC_1 }}</span><span>{{ TILE_SPEC_2 }}</span><span>{{ TILE_SPEC_3 }}</span><span>{{ TILE_SPEC_4 }}</span></div>
+      <div class="foot"><span>{{ WEBSITE_DOMAIN }}</span><span class="r">{{ PHONE_DISPLAY }}</span></div>
+    </div>
+  </div>
+<script>
+  // CANDIDATES is substituted by the socials skill AFTER the PII gate. It is an
+  // object keyed by hero name; each entry names a background image (a path that
+  // resolves from this file's directory) and the headline/sub it leads with:
+  //   { main: { img:'images/hero-01.webp', pos:'center', head:'…', sub:'…' }, … }
+  // For a micro-site the adapter supplies the four brand themes; for a job /
+  // valuation / bespoke subject it supplies the vetted candidate images and the
+  // copy facts that survived redaction. No client PII ever reaches this object —
+  // the gate strips it upstream.
+  //
+  // A person hero (a founder portrait, a worker on site) must be rendered
+  // PORTRAIT ONLY: a landscape or square crop cuts off the head. The socials
+  // skill enforces this by only emitting the portrait format for a person hero.
+  const CANDIDATES = {{ CANDIDATES_JSON }};
+  // ?format=landscape|square|portrait  &  ?hero=<key from CANDIDATES>
+  const q = new URLSearchParams(location.search);
+  const keys = Object.keys(CANDIDATES);
+  const fmt = q.get('format') || 'landscape';
+  const hero = q.get('hero') || keys[0];
+  const h = CANDIDATES[hero] || CANDIDATES[keys[0]];
+  const stage = document.getElementById('stage');
+  stage.classList.add(fmt);
+  const heroEl = document.getElementById('hero');
+  heroEl.style.backgroundImage = "url('" + h.img + "')";
+  heroEl.style.backgroundPosition = h.pos || 'center';
+  document.getElementById('headline').textContent = h.head;
+  document.getElementById('sub').textContent = h.sub;
+</script>
+</body>
+</html>

package/payload/premium-plugins/sitedesk/plugins/sitedesk-media/skills/socials/templates/social-posts.md

@@ -0,0 +1,47 @@
+# {{ COMPANY_NAME }} — social captions
+
+Paste-ready copy for each tile. Phone {{ PHONE_DISPLAY }} · {{ WEBSITE_DOMAIN }}
+{{ FACEBOOK_HANDLE }} · {{ INSTAGRAM_HANDLE }} · {{ TIKTOK_HANDLE }}
+
+Write every caption in the plain register (the `plainly` skill): no em-dashes, no
+inflation words (discover, unlock, nestled, stunning, boasts, bespoke-where-it-
+isn't), no "it's not X, it's Y", no rhetorical openers, no emoji used to fake
+enthusiasm. Read each one aloud; if it sounds like a marketing bot, rewrite it.
+
+For a PII-bearing subject (a job, a valuation cycle, a bespoke topic) no caption
+may name the client, the site address or postcode, any contract / valuation /
+payment figure, any named individual, or any email sender. The progress is the
+story; the people and the money are not.
+
+Repeat the block below once per rendered tile. `{{ TILE_KEY }}` matches the tile
+filename (`og-*-{{ TILE_KEY }}.png`); a person tile is portrait only, so its block
+references the portrait image alone.
+
+## Per-platform shape (a cap, not a target)
+
+- **Instagram (feed + portrait)** — name first, then what is visible, then "link in
+  bio" if there is a site, then 4–6 hashtags. The portrait line leads with what is
+  in that specific hero.
+- **LinkedIn** — three short paragraphs, professional, plain.
+- **TikTok** — one short hook line plus 3–5 hashtags.
+- **Facebook** — three short paragraphs, warmer than LinkedIn.
+- **X** — under 280 characters, one clear line.
+
+---
+
+## {{ TILE_HEAD }} — `og-*-{{ TILE_KEY }}.png`
+
+**Instagram (feed + portrait)**
+{{ TILE_KEY_INSTAGRAM }}
+
+**LinkedIn**
+{{ TILE_KEY_LINKEDIN }}
+
+**TikTok**
+{{ TILE_KEY_TIKTOK }}
+
+**Facebook**
+{{ TILE_KEY_FACEBOOK }}
+
+**X**
+{{ TILE_KEY_X }}

package/payload/premium-plugins/sitedesk/plugins/sitedesk-media/skills/socials/templates/socials.html

@@ -0,0 +1,87 @@
+<!DOCTYPE html>
+<html lang="en-GB">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>{{ COMPANY_NAME }} · Social collateral</title>
+<link rel="icon" href="favicon.png" type="image/png">
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link href="https://fonts.googleapis.com/css2?family=Cormorant+Garamond:ital,wght@0,400;0,500;1,400&family=Lora:ital,wght@0,400;1,400&family=Inter:wght@400;500;600&display=swap" rel="stylesheet">
+<style>
+  /* Brand tokens — substituted per subject by the resolving adapter. */
+  :root{
+    --ink:{{ INK_900 }}; --ink-2:{{ INK_700 }}; --slate:{{ INK_400 }}; --paper:{{ PAPER_100 }}; --paper-2:{{ PAPER_200 }};
+    --rule:{{ RULE_100 }}; --gold:{{ ACCENT_TEXT }}; --copper:{{ ACCENT }}; --brand-grey:{{ BRAND_GREY }};
+    --serif:'Cormorant Garamond',Garamond,serif; --body:'Lora',Georgia,serif; --sans:'Inter',system-ui,sans-serif;
+  }
+  *{margin:0;padding:0;box-sizing:border-box;}
+  body{font-family:var(--body);background:var(--paper-2);color:var(--ink);line-height:1.6;}
+  img{display:block;max-width:100%;height:auto;}
+  a{color:inherit;}
+  header{background:var(--paper);border-bottom:1px solid var(--rule);padding:22px 32px;display:flex;align-items:center;justify-content:space-between;flex-wrap:wrap;gap:16px;}
+  header img{height:64px;width:auto;}
+  header .t{font-family:var(--sans);font-size:11px;font-weight:600;letter-spacing:.28em;text-transform:uppercase;color:var(--brand-grey);}
+  .wrap{max-width:1100px;margin:0 auto;padding:48px 32px 64px;}
+  .lede{font-family:var(--serif);font-style:italic;font-size:28px;color:var(--ink);margin-bottom:8px;}
+  .lede::after{content:'';display:block;width:40px;height:2px;background:var(--copper);margin-top:16px;}
+  .intro{font-size:15px;color:var(--ink-2);max-width:680px;margin-bottom:14px;}
+  .snippet{background:var(--ink);color:#fff;border-radius:2px;padding:20px 22px;margin:22px 0 40px;overflow-x:auto;}
+  .snippet .h{font-family:var(--sans);font-size:10px;font-weight:600;letter-spacing:.24em;text-transform:uppercase;color:var(--copper);margin-bottom:12px;}
+  .snippet pre{font-family:ui-monospace,Menlo,Consolas,monospace;font-size:12px;line-height:1.7;color:#e9e6df;white-space:pre;}
+  .group{margin-top:48px;}
+  .group h2{font-family:var(--serif);font-style:italic;font-size:24px;color:var(--ink);margin-bottom:4px;}
+  .group h2 .role{font-family:var(--sans);font-size:10px;font-weight:600;letter-spacing:.24em;text-transform:uppercase;color:var(--copper);margin-left:12px;vertical-align:middle;}
+  .group .cap{font-size:13.5px;color:var(--ink-2);max-width:680px;margin:8px 0 20px;border-left:3px solid var(--copper);padding-left:14px;}
+  .tiles{display:grid;grid-template-columns:repeat(auto-fill,minmax(260px,1fr));gap:22px;align-items:end;}
+  .tile{background:var(--paper);border:1px solid var(--rule);padding:12px;}
+  .tile img{width:100%;border:1px solid var(--rule);}
+  .tile .meta{display:flex;align-items:center;justify-content:space-between;margin-top:10px;}
+  .tile .fmt{font-family:var(--sans);font-size:10px;font-weight:600;letter-spacing:.16em;text-transform:uppercase;color:var(--slate);}
+  .tile .dl{font-family:var(--sans);font-size:10px;font-weight:600;letter-spacing:.16em;text-transform:uppercase;color:var(--paper);background:var(--ink);text-decoration:none;padding:7px 12px;}
+  .tile .dl:hover{background:var(--copper);}
+  footer{border-top:1px solid var(--rule);padding:28px 32px;text-align:center;font-family:var(--sans);font-size:10px;font-weight:500;letter-spacing:.2em;text-transform:uppercase;color:var(--slate);}
+</style>
+</head>
+<body>
+<header>
+  <img src="images/logo.png" alt="{{ COMPANY_NAME }}">
+  <span class="t">Social collateral</span>
+</header>
+<div class="wrap">
+  <div class="lede">{{ GALLERY_LEDE }}</div>
+  <p class="intro">{{ GALLERY_INTRO }} Landscape (1200×628) for Facebook, LinkedIn and link previews; square (1200×1200) for the Instagram feed; portrait (1080×1350) for Instagram and Reels covers. Captions for every tile are in <a href="social-posts.md" style="text-decoration:underline;text-decoration-color:rgba(0,0,0,.25);">social-posts.md</a>.</p>
+
+  <!--
+    OG SNIPPET — microsite mode only. A job / valuation / bespoke bundle has no
+    site to wire, so omit this whole block for those subjects. When present, it
+    points at the landscape main tile (PNG).
+  -->
+  <div class="snippet">
+    <div class="h">Paste into the page &lt;head&gt; for link previews</div>
+<pre>&lt;meta property="og:image" content="{{ WEBSITE_URL }}socials/og-landscape-main.png"&gt;
+&lt;meta property="og:image:width" content="1200"&gt;
+&lt;meta property="og:image:height" content="628"&gt;
+&lt;meta name="twitter:card" content="summary_large_image"&gt;
+&lt;meta name="twitter:image" content="{{ WEBSITE_URL }}socials/og-landscape-main.png"&gt;</pre>
+  </div>
+
+  <!--
+    GROUP BLOCK — repeat once per resolved tile key. {{ TILE_KEY }} matches the
+    filename suffix; {{ TILE_HEAD }} / {{ TILE_CAPTION }} are the subject's copy.
+    A standard tile has all three formats. A PERSON tile is portrait only: emit
+    just the portrait cell for it (drop the landscape and square cells).
+  -->
+  <div class="group">
+    <h2>{{ TILE_HEAD }} <span class="role">{{ TILE_KEY }}</span></h2>
+    <p class="cap">{{ TILE_CAPTION }}</p>
+    <div class="tiles">
+      <div class="tile"><img src="socials/og-landscape-{{ TILE_KEY }}.png" alt="{{ TILE_HEAD }}, landscape tile"><div class="meta"><span class="fmt">Landscape · 1200×628</span><a class="dl" href="socials/og-landscape-{{ TILE_KEY }}.png" download>Download</a></div></div>
+      <div class="tile"><img src="socials/og-square-{{ TILE_KEY }}.png" alt="{{ TILE_HEAD }}, square tile"><div class="meta"><span class="fmt">Square · 1200×1200</span><a class="dl" href="socials/og-square-{{ TILE_KEY }}.png" download>Download</a></div></div>
+      <div class="tile"><img src="socials/og-portrait-{{ TILE_KEY }}.png" alt="{{ TILE_HEAD }}, portrait tile"><div class="meta"><span class="fmt">Portrait · 1080×1350</span><a class="dl" href="socials/og-portrait-{{ TILE_KEY }}.png" download>Download</a></div></div>
+    </div>
+  </div>
+</div>
+<footer>© {{ COPYRIGHT_YEAR }} {{ COMPANY_LEGAL_NAME }} · {{ TAGLINE }}</footer>
+</body>
+</html>

package/payload/premium-plugins/teaching/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "teaching",
+  "description": "Interactive tutoring, lesson planning, and study pack generation. Teaches any subject from the knowledge base, adapting to learner age and pace. Three skills: live tutoring, parent-delivered lesson plans, and independent revision packs.",
+  "version": "0.1.0",
+  "author": {
+    "name": "Rubytech LLC"
+  }
+}

package/payload/premium-plugins/teaching/PLUGIN.md

@@ -0,0 +1,58 @@
+---
+name: teaching
+description: "Interactive tutoring, lesson planning, and study pack generation. Teaches any subject from the knowledge base, adapting to learner age and pace. Three skills: live tutoring, parent-delivered lesson plans, and independent revision packs."
+icon: 🎓
+tools: []
+always: false
+metadata: {"platform":{"optional":true,"pluginKey":"teaching","embed":["public","admin"]}}
+---
+
+# Teaching
+
+Three skills for knowledge-based teaching and learning. Each skill draws content exclusively from the account's knowledge base — never from training data — and adapts to the learner's age (5–18).
+
+## Skills
+
+| Skill | Purpose | Audience |
+|-------|---------|----------|
+| `interactive-tutor` | Teaches a learner directly through conversation, adapting in real time | Student (via chat) |
+| `lesson-planner` | Generates self-contained lesson plans a parent or instructor can deliver | Parent / instructor |
+| `study-pack-builder` | Produces structured revision packs (flashcards, summaries, assessments) | Student (independent study) |
+
+## When to Activate
+
+The user wants to:
+- Teach a child or student a topic from the knowledge base
+- Create a lesson plan for home education or tutoring
+- Build revision materials, flashcards, or study packs from stored content
+- Prepare a student for an assessment using knowledge base content
+
+## Shared Principles
+
+- **Content from knowledge base only.** Every skill searches memory first. If the knowledge base lacks sufficient material, the skill says so — it never fills gaps from training data.
+- **Conversational context gathering.** Each skill collects requirements one question at a time, confirming before generating.
+- **Age-appropriate adaptation.** Language, examples, and complexity scale to the learner's age (5–18 years).
+- **Self-contained output.** Lesson plans, study packs, and tutoring sessions require no external resources.
+- **Domain-neutral.** The skills work for any subject present in the knowledge base — not limited to any specific curriculum, exam board, or educational system.
+
+## Tools Used
+
+No MCP server. Skills operate via existing platform tools:
+- `memory-search` — retrieve subject content from the knowledge base
+- `image_generate` — create visual aids, diagrams, and infographics
+
+Structured choices are presented as numbered lists in plain chat — the platform has no inline-UI component primitive on the admin / native-CC surface.
+
+## References
+
+Domain knowledge files loaded on demand by each skill:
+
+| Reference | Used By | Purpose |
+|-----------|---------|---------|
+| `skills/interactive-tutor/references/assessment.md` | interactive-tutor | Prior knowledge assessment and comprehension checking |
+| `skills/interactive-tutor/references/classroom-conduct.md` | interactive-tutor | Standing rules for language, output format, and boundaries |
+| `skills/interactive-tutor/references/teaching-modes.md` | interactive-tutor | Four teaching approaches (Socratic, Direct, Guided Discovery, Adaptive) |
+| `skills/lesson-planner/references/context-gathering.md` | lesson-planner | Student context fields and teaching mode descriptions |
+| `skills/lesson-planner/references/plan-structure.md` | lesson-planner | Lesson plan format, content requirements, and quality standards |
+| `skills/study-pack-builder/references/disaggregation.md` | study-pack-builder | Building topic hierarchies from knowledge base content |
+| `skills/study-pack-builder/references/materials.md` | study-pack-builder | Per-topic revision material generation (summaries, flashcards, assessments) |