cue-ai 0.9.0 → 0.9.2

package/resources/skills/skills/career/salary-negotiation-prep/SKILL.md

@@ -0,0 +1,378 @@
+---
+name: salary-negotiation-prep
+description: Research market comp bands, build a negotiation strategy, and write counter-offer scripts. Use when user says "negotiate my offer", "salary negotiation", "counter offer", "what should I ask for", "is this offer fair", "they lowballed me", or "how much should I counter".
+---
+
+# Salary Negotiation Prep
+
+## When to Use This Skill
+
+Use this skill when the user wants to:
+- Negotiate a job offer or salary
+- Research market rates for their role
+- Create a counter-offer strategy
+- Understand total compensation packages
+- Mentions: "salary negotiation", "negotiate offer", "counter offer", "compensation", "how much should I ask for"
+
+## Core Capabilities
+
+- Research and validate market compensation
+- Build negotiation strategy and scripts
+- Calculate total compensation (not just base salary)
+- Prepare counter-offer responses
+- Identify negotiation leverage points
+- Navigate difficult salary conversations
+
+## The Negotiation Mindset
+
+**Key Principles:**
+1. Negotiation is expected - companies budget for it
+2. 84% of employers expect candidates to negotiate
+3. Not negotiating leaves $500K-$1M on the table over a career
+4. The goal is win-win, not adversarial
+
+**What You're Really Negotiating:**
+- Base salary
+- Signing bonus
+- Annual bonus/commission
+- Equity (stock options, RSUs)
+- Benefits (401k match, insurance)
+- Perks (vacation, remote work, professional development)
+- Start date
+- Title
+
+## Research Phase
+
+### Step 1: Determine Market Rate
+
+**Sources to Check:**
+- Levels.fyi (best for tech)
+- Glassdoor (general, take with grain of salt)
+- LinkedIn Salary
+- Blind (anonymous reports)
+- PayScale
+- Salary.com
+- H1B salary data (publicly available)
+
+**Build a Range:**
+```
+Low (25th percentile): $XXX,XXX
+Target (50th percentile): $XXX,XXX  
+High (75th percentile): $XXX,XXX
+Stretch (90th percentile): $XXX,XXX
+```
+
+### Step 2: Know Your Value
+
+**Factors That Increase Your Worth:**
+- Years of relevant experience
+- Specialized/rare skills
+- Track record of results
+- In-demand certifications
+- Current competing offers
+- Referral from employee
+- Market demand in your field
+
+**Factors That May Limit:**
+- Entry level or career change
+- Less experience than ideal candidate
+- Gaps in required skills
+- Location arbitrage (lower cost of living)
+
+### Step 3: Calculate Total Compensation
+
+**Total Comp = Base + Bonus + Equity + Benefits**
+
+```
+EXAMPLE:
+Base Salary: $150,000
+Target Bonus (15%): $22,500
+RSU Grant (4-year): $200,000 ($50,000/year)
+401k Match (4%): $6,000
+Benefits Value: ~$15,000
+
+Total Annual Comp: $243,500
+```
+
+**Common Equity Terms:**
+- **RSUs:** Restricted Stock Units (real shares, taxed when vesting)
+- **Options:** Right to buy at strike price (value = current price - strike price)
+- **Vesting:** Typically 4-year with 1-year cliff
+- **Refresh grants:** Annual additional equity grants
+
+## Negotiation Strategy
+
+### When to Negotiate
+
+**Best Time:** After you have a written offer, before you sign
+
+**Timeline:**
+1. Receive verbal offer → Express enthusiasm, ask for written offer
+2. Receive written offer → Thank them, ask for time to review
+3. Research and prepare → 24-48 hours
+4. Counter with ask → Email or call
+5. Discussion/back and forth → May take several rounds
+6. Final agreement → Get in writing
+
+### The Counter-Offer Framework
+
+**Structure:**
+1. Express enthusiasm
+2. Reinforce your value
+3. Make specific ask
+4. Provide justification
+5. Open discussion
+
+### Counter-Offer Email Template
+
+```
+Subject: [Your Name] - Offer Discussion
+
+Hi [Recruiter/Hiring Manager],
+
+Thank you so much for the offer to join [Company] as [Title]. I'm very excited about the opportunity to [specific thing about the role]. After speaking with the team and learning more about [something specific], I'm confident this is the right fit.
+
+I've had time to review the offer details and wanted to discuss the compensation. Based on my research of the market and my [X years of experience / specific valuable skill / competing offer], I was hoping we could discuss a base salary of $[Your Ask] rather than $[Their Offer].
+
+[Optional: Add specific justification - e.g., "I've seen similar roles at [comparable companies] in this range" or "Given the scope of the role and my track record of [specific achievement], I believe this reflects my value."]
+
+I'm flexible and open to discussing other elements of the package as well. Would you have time for a quick call to discuss?
+
+Thank you again for this opportunity. I'm looking forward to finding a package that works for both of us.
+
+Best,
+[Your Name]
+```
+
+### Counter-Offer Call Script
+
+```
+"Hi [Name], thanks for making time. I'm really excited about this opportunity - [genuine specific reason].
+
+I've reviewed the offer and want to discuss compensation. Based on my market research and [X years experience / key accomplishment / competing offer], I was hoping for a base salary closer to $[Amount].
+
+Is there flexibility there?"
+
+[LISTEN - Let them respond]
+
+[If they push back:]
+"I understand there are constraints. I'm flexible - could we look at other elements like signing bonus, equity, or [other element] to bridge the gap?"
+
+[If they say they'll need to check:]
+"That's totally fair. When would be a good time to reconnect?"
+```
+
+## Common Negotiation Scenarios
+
+### Scenario 1: First Offer Is Low
+
+**Approach:**
+- Don't accept immediately
+- Express enthusiasm for role
+- Counter with research-backed number
+- Be prepared to justify
+
+**Script:**
+```
+"I'm thrilled about the opportunity. The base salary is lower than I expected based on my research. For this role and market, I was expecting something in the $X-$Y range. Is there room to move closer to $X?"
+```
+
+### Scenario 2: They Ask Your Salary Expectations First
+
+**Deflection Strategy:**
+```
+"I'm flexible and focused on finding the right fit. What's the range you've budgeted for this role?"
+```
+
+**If Pressed:**
+```
+"Based on my research for this role and market, I'm looking at $X-$Y, but I'm open to discussing the full compensation picture."
+```
+
+### Scenario 3: They Won't Budge on Base
+
+**Alternatives to Negotiate:**
+- Signing bonus (one-time, easier to approve)
+- Additional equity
+- Earlier performance review (sooner raise)
+- More vacation days
+- Remote work flexibility
+- Professional development budget
+- Title upgrade
+- Relocation assistance
+- Start date
+
+**Script:**
+```
+"I understand the base salary is firm. Could we discuss a signing bonus to help bridge the gap? Something in the range of $X would make this work."
+```
+
+### Scenario 4: You Have Competing Offers
+
+**Use Carefully:**
+- Only mention if true
+- Don't make it a threat
+- Frame as problem-solving
+
+**Script:**
+```
+"I want to be transparent - I'm also in discussions with [another company/a few other companies]. They're offering $X. [Your Company] is my first choice because [genuine reason], but I want to make sure the compensation is competitive."
+```
+
+### Scenario 5: They Ask About Current Salary
+
+**In Many States, This Question Is Illegal**
+
+**If Asked (and legal):**
+```
+"I'd prefer to focus on the value I'd bring to this role and what the market rate is. What's the range you've budgeted?"
+```
+
+**Or Redirect:**
+```
+"My current compensation isn't really comparable since [different location/role/structure]. Based on my research for this role, I'm targeting $X-$Y."
+```
+
+## Negotiation Tactics
+
+### Do's:
+- ✅ Always negotiate (respectfully)
+- ✅ Get the offer in writing before negotiating
+- ✅ Research thoroughly
+- ✅ Be specific with numbers
+- ✅ Express genuine enthusiasm
+- ✅ Give them a way to say yes
+- ✅ Consider total compensation
+- ✅ Be patient - process takes time
+- ✅ Get final agreement in writing
+
+### Don'ts:
+- ❌ Accept on the spot
+- ❌ Give a salary history (if not required by law)
+- ❌ Make ultimatums
+- ❌ Lie about competing offers
+- ❌ Be rude or aggressive
+- ❌ Negotiate just for the sake of it
+- ❌ Accept verbal promises without writing
+- ❌ Burn bridges if it doesn't work out
+
+## Total Compensation Comparison
+
+### Side-by-Side Analysis
+
+```markdown
+## OFFER COMPARISON
+
+| Component | Company A | Company B | Notes |
+|-----------|-----------|-----------|-------|
+| Base Salary | $150,000 | $140,000 | A wins |
+| Target Bonus | 15% ($22,500) | 20% ($28,000) | B wins |
+| Signing Bonus | $20,000 | $10,000 | A wins |
+| Equity (annual) | $50,000 | $75,000 | B wins |
+| 401k Match | 4% ($6,000) | 6% ($8,400) | B wins |
+| Benefits | Standard | Premium | B wins |
+| WFH | Hybrid (3 days) | Full remote | B wins |
+| Vacation | 3 weeks | Unlimited | Depends |
+
+**Year 1 Total Comp:**
+Company A: $248,500
+Company B: $261,400
+
+**Analysis:** Company B is higher total comp, but Company A has higher base which affects future raises and mortgage qualification.
+```
+
+## Negotiation Timeline Template
+
+```
+Day 1: Receive offer
+- Thank them, express enthusiasm
+- Ask for offer in writing
+- Ask deadline for response
+
+Day 1-3: Research
+- Verify market rate
+- Calculate total comp
+- Identify priorities
+- Prepare counter-offer
+
+Day 3-5: Counter
+- Send counter-offer email or schedule call
+- Be specific about ask
+
+Day 5-10: Discussion
+- May require several rounds
+- Be patient but responsive
+- Stay professional and positive
+
+Day 10+: Resolution
+- Agree on terms
+- Get everything in writing
+- Sign and celebrate!
+```
+
+## Output Format
+
+When preparing salary negotiation:
+
+```markdown
+# SALARY NEGOTIATION STRATEGY
+
+## Market Research Summary
+**Role:** [Title]
+**Location:** [City/Remote]
+**Experience Level:** [Years]
+
+**Market Range:**
+- 25th percentile: $XXX,XXX
+- 50th percentile: $XXX,XXX (target)
+- 75th percentile: $XXX,XXX
+- 90th percentile: $XXX,XXX (stretch)
+
+**Sources:** [List sources used]
+
+## Their Offer
+| Component | Amount |
+|-----------|--------|
+| Base | $XXX,XXX |
+| Bonus | X% |
+| Equity | $XXX,XXX |
+| Signing | $XXX |
+| Total Year 1 | $XXX,XXX |
+
+## Your Counter
+| Component | Ask | Justification |
+|-----------|-----|---------------|
+| Base | $XXX,XXX | [Why] |
+| Signing | $XXX | [Why] |
+| [Other] | | |
+
+## Counter-Offer Script
+[Email template or call script customized for this situation]
+
+## If They Push Back
+**Plan B:** [Alternative elements to negotiate]
+**Walk-away Point:** [Your minimum]
+
+## Key Talking Points
+1. [Your experience/value point]
+2. [Market data point]
+3. [Specific achievement]
+
+## Questions to Clarify
+- [Equity vesting schedule?]
+- [Bonus guaranteed?]
+- [Review cycle timeline?]
+```
+
+## Implementation Checklist
+
+1. ✅ Research market rate from 3+ sources
+2. ✅ Calculate total compensation (not just base)
+3. ✅ Identify your priorities
+4. ✅ Determine walk-away point
+5. ✅ Prepare counter-offer with justification
+6. ✅ Write or practice negotiation script
+7. ✅ Plan for pushback scenarios
+8. ✅ Get agreement in writing
+9. ✅ Review final offer letter carefully
+10. ✅ Sign and celebrate!

package/resources/skills/skills/content/pdf/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: pdf
 description: >-
+  Use when user says "extract text from pdf", "merge pdfs", "split a pdf", "fill out a pdf form",
+  "extract tables from pdf", or "create a pdf".
   Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs,
   merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or
   programmatically process, generate, or analyze PDF documents at scale.

package/resources/skills/skills/content/postiz-cards/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: postiz-cards
+description: 'Use when user says "build a branded card", "make a postiz card", "schedule a branded post", "composite the logo on this card", "lint my post copy". Brand-aware card pipeline for Postiz. Lints post copy (cashtag/em-dash/stat gates), composites the brand logo band onto Higgsfield cards (with OCR text-check), and pulls analytics. For building or scheduling branded image-card posts for ANY postizz brand (volaria, etc.). Pairs with /post-as.'
+allowed-tools:
+  - Bash
+  - Read
+---
+
+# postiz-cards
+
+The reusable toolkit behind `/post-as` — the card-building and pre-publish discipline, generalized so any brand under `profiles/postizz/brands/<brand>/` can use it. Volaria is the reference implementation.
+
+## Why this exists
+
+Hand-rolling generate → composite → lint → upload → schedule for every card is slow and error-prone (cashtag-limit failures, em-dashes, garbled headline text, logo redraws). These scripts make each step one command.
+
+## Scripts (`scripts/`)
+
+### `lint.py` — pre-publish gate
+```
+python3 scripts/lint.py <draftfile>      # tweets separated by a line: ===
+```
+Per tweet enforces **≤1 cashtag** (X rejects 2+ as nonRetryable), **0 em-dashes**, char count; warns on **uncited stats** (numbers with no source link). Exit 1 on FAIL. Run before every schedule.
+
+### `card.sh` — logo composite + OCR check + upload
+```
+scripts/card.sh <raw.png> [out.png] [--brand <name>] [--check "HEADLINE WORDS"] [--upload]
+```
+Composites the brand's logo band onto a raw Higgsfield card (defaults: 220px band, logo `-resize x180` at `north +0+20` — override via `BAND_H`/`LOGO_H`/`LOGO_OFF` env). `--check` OCRs the rendered card (tesseract) to catch text errors like a dropped word. `--upload` pushes to Postiz and prints the media URL.
+**Never** pass the logo to image-gen as a reference — it redraws. Always composite post-gen.
+
+### `analytics.sh` — performance report
+```
+scripts/analytics.sh [--brand <name>] [--int <integration_id>]
+```
+Postiz platform + recent-post metrics. **Caveat:** Postiz analytics lag X by ~30× on fresh posts — use for trend, cross-check X-native (the account's per-post analytics or Premium export).
+
+## Standing pipeline (per post)
+research/verify → draft copy → `lint.py` → generate card (EMPTY top band) → `card.sh --check --upload` → schedule via the `postiz` CLI with a first-reply CTA, at a peak slot → reply within 30 min.
+
+## Brand config (per brand, under `profiles/postizz/brands/<brand>/`)
+- `logo.png` — composited onto every card (the band recipe; tune via env if a brand differs).
+- `brand.md` — palette/voice/card templates + the content plan (pillars, cadence, levers).
+- `accounts.yaml` — integration IDs (or pass `--int` / `POSTIZ_INT`).
+
+## Related
+- Command: `/post-as <brand>` (wraps this end-to-end). `/trend-to-thread`, `/article-to-everywhere`.
+- Rules: `rules/postiz/x-cashtag-limit.md`.

package/resources/skills/skills/content/postiz-cards/scripts/analytics.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# Postiz performance report for a brand's integration + recent posts. Brand-parameterized.
+# Usage: analytics.sh [--brand <name>] [--int <integration_id>]
+# WARNING: Postiz analytics LAG X by ~30x on fresh posts. Trend only; cross-check X-native.
+set -uo pipefail
+CUE_ROOT="${CUE_REPO_ROOT:-$HOME/Documents/cue}"
+brand="${POSTIZ_BRAND:-volaria}"; INT="${POSTIZ_INT:-}"
+while [ $# -gt 0 ]; do case "$1" in --brand) brand="$2"; shift 2;; --int) INT="$2"; shift 2;; *) shift;; esac; done
+# fall back to the brand's accounts.yaml
+[ -z "$INT" ] && INT="$(grep -oE 'cmp[a-z0-9]{20,}' "$CUE_ROOT/profiles/postizz/brands/$brand/accounts.yaml" 2>/dev/null | head -1)"
+[ -n "$INT" ] || { echo "no integration id (pass --int or set POSTIZ_INT, or fill accounts.yaml for $brand)"; exit 1; }
+
+echo "=== $brand platform analytics (Postiz - LAGS X ~30x) ==="
+postiz analytics:platform "$INT" 2>&1 | python3 -c "
+import sys,json
+t=sys.stdin.read(); i=t.find('[')
+try:
+    d=json.loads(t[i:])
+    for m in d:
+        vals=m.get('data',[]); tot=vals[-1].get('total') if vals else '?'
+        print(f'  {m.get(\"label\",\"?\"):12} {tot}')
+except Exception: print('  (parse failed)', t[:120])
+"
+echo
+echo "=== recent published posts ==="
+postiz posts:list 2>/dev/null > /tmp/postiz-pl.json
+python3 - <<'PY'
+import json
+t=open('/tmp/postiz-pl.json').read(); i=t.find('{'); d=json.loads(t[i:])
+pub=[p for p in (d.get('posts') or []) if p.get('state')=='PUBLISHED']
+pub.sort(key=lambda p:p.get('publishDate') or '')
+for p in pub[-8:]:
+    c=(p.get('content') or '').replace('\n',' ')[:38]
+    print(f"  {(p.get('publishDate') or '')[:16]}  {p['id']}  {c}")
+print(f"  ({len(pub)} published total)")
+PY
+echo
+echo "GOLD STANDARD (not Postiz): the account's X-native per-post analytics, or X Premium export."

package/resources/skills/skills/content/postiz-cards/scripts/card.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+# Brand card finisher: composite the brand logo band onto a raw Higgsfield card,
+# optional OCR headline check, optional Postiz upload. Brand-parameterized.
+# Usage: card.sh <raw.png> [out.png] [--brand <name>] [--check "WORDS"] [--upload]
+# Composite tunables via env: BAND_H (220), LOGO_H (180), LOGO_OFF (+0+20)
+set -uo pipefail
+CUE_ROOT="${CUE_REPO_ROOT:-$HOME/Documents/cue}"
+brand="${POSTIZ_BRAND:-volaria}"
+BAND="${BAND_H:-220}"; LH="${LOGO_H:-180}"; OFF="${LOGO_OFF:-+0+20}"
+raw=""; out=""; check=""; do_upload=0
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --brand)  brand="${2:-}"; shift 2;;
+    --check)  check="${2:-}"; shift 2;;
+    --upload) do_upload=1; shift;;
+    -*)       echo "unknown option: $1"; exit 2;;
+    *)        if [ -z "$raw" ]; then raw="$1"; else out="$1"; fi; shift;;
+  esac
+done
+[ -f "$raw" ] || { echo "usage: card.sh <raw.png> [out.png] [--brand <name>] [--check \"WORDS\"] [--upload]"; exit 2; }
+LOGO="$CUE_ROOT/profiles/postizz/brands/$brand/logo.png"
+[ -f "$LOGO" ] || { echo "no logo for brand '$brand' at $LOGO"; exit 1; }
+[ -z "$out" ] && out="${raw%.*}-card.png"
+
+convert "$raw" -background black -gravity north -splice "0x${BAND}" \
+  \( "$LOGO" -resize "x${LH}" \) -gravity north -geometry "${OFF}" -composite "$out"
+echo "composited -> $out ($(identify -format '%wx%h' "$out")) [brand=$brand band=${BAND} logo=x${LH}]"
+
+if [ -n "$check" ]; then
+  if command -v tesseract >/dev/null 2>&1; then
+    txt="$(tesseract "$out" - 2>/dev/null | tr '[:lower:]' '[:upper:]' | tr -d '\n')"
+    miss=""
+    for w in $check; do
+      printf '%s' "$txt" | grep -q "$(printf '%s' "$w" | tr '[:lower:]' '[:upper:]')" || miss="$miss $w"
+    done
+    [ -n "$miss" ] && echo "WARN OCR: words not found ->$miss  (re-roll the card)" || echo "OK   OCR: all check words present"
+  else
+    echo "note: tesseract not installed; OCR headline check skipped"
+  fi
+fi
+
+[ "$do_upload" = 1 ] && { echo -n "uploaded: "; postiz upload "$out" 2>&1 | grep -oE 'https?://[^"]+/uploads/[^"]+\.png' | head -1; }

package/resources/skills/skills/content/postiz-cards/scripts/lint.py

@@ -0,0 +1,38 @@
+#!/usr/bin/env python3
+"""Pre-publish lint for Postiz brand posts (cashtag + em-dash + stat gate).
+
+Usage: lint.py <postfile>      # tweets separated by a line containing only ===
+       cat draft.txt | lint.py
+
+Per tweet, enforces:
+  - <= 1 cashtag ($TICKER)  -> X rejects 2+ as nonRetryable
+  - 0 em-dashes             -> de-slop rule
+  - char count (note if >280; fine on Premium)
+Post-level:
+  - WARN if numeric stats appear with no source link anywhere (finance EEAT gate)
+Exit 1 if any tweet FAILs. Brand-agnostic.
+"""
+import sys, re
+
+data = open(sys.argv[1]).read() if len(sys.argv) > 1 else sys.stdin.read()
+tweets = [t.strip() for t in re.split(r'(?m)^===\s*$', data) if t.strip()]
+has_source = bool(re.search(r'https?://|[Ss]ource\s*:', data))
+fails = 0
+
+for i, tw in enumerate(tweets, 1):
+    cash = [c for c in re.findall(r'\$[A-Za-z]{1,6}\b', tw) if c[1:].isupper()]  # $NVDA, not $5
+    em = tw.count('—')
+    chars = len(tw)
+    stats = re.findall(r'\b\d+(?:\.\d+)?%|\$\d[\d,.]*|\b\d{3,}\b', tw)
+    flags = []
+    if len(cash) > 1: flags.append(f"FAIL cashtags {cash} (max 1/tweet)")
+    if em:           flags.append(f"FAIL em-dash x{em}")
+    if chars > 280:  flags.append(f"note {chars} chars (>280; ok if Premium)")
+    if stats and not has_source: flags.append(f"WARN uncited stats {stats[:4]} (no source link in post)")
+    status = "FAIL" if any(f.startswith("FAIL") for f in flags) else ("WARN" if flags else "PASS")
+    if status == "FAIL": fails += 1
+    print(f"[{status}] tweet {i}: {len(cash)} cashtag, {em} em-dash, {chars} chars")
+    for f in flags: print(f"         - {f}")
+
+print(f"\n{'FAILED' if fails else 'clean'}: {len(tweets)} tweets, {fails} failing, source_present={has_source}")
+sys.exit(1 if fails else 0)

package/resources/skills/skills/design/headless-gif-demo/SKILL.md

@@ -1,5 +1,5 @@
 ---
-description: "When user asks to record a high-quality CLI demo GIF that needs Kitty graphics protocol (real PNG icons inline) — use this headless cage/Wayland + Kitty + tmux + ffmpeg pipeline instead of vhs/asciinema which don't speak the Kitty protocol. Includes auto-redaction of moving text via tesseract OCR."
+description: 'Use when user says "record a CLI demo gif", "make a terminal demo", "capture a tmux session as a gif", "demo gif with brand logos", or "redact text in a screen recording". Headless cage/Wayland + Kitty + tmux + ffmpeg pipeline for high-quality CLI demo GIFs that need Kitty graphics protocol (real PNG icons inline) — instead of vhs/asciinema which don''t speak the Kitty protocol. Includes auto-redaction of moving text via tesseract OCR.'
 requires_mcps: [cue-tty-watch]
 allowed-tools: Bash(cage:*), Bash(weston:*), Bash(Xvfb:*), Bash(kitty:*), Bash(tmux:*), Bash(xdotool:*), Bash(wf-recorder:*), Bash(grim:*), Bash(ffmpeg:*), Bash(/usr/bin/ffmpeg:*), Bash(tesseract:*), Bash(convert:*), Read(*), Write(*), mcp__cue-tty-watch__*
 ---

package/resources/skills/skills/design/readme-svg-design/SKILL.md

@@ -1,5 +1,5 @@
 ---
-description: "When user asks to design a README, create SVG diagrams, or make documentation visually beautiful — generate publication-quality SVG assets and compose them into a well-structured README"
+description: 'Use when user says "design a readme", "make my readme beautiful", "create an svg diagram", "architecture diagram for the readme", or "add a hero banner to the docs". Generates publication-quality SVG assets and composes them into a well-structured, GitHub-compatible README.'
 requires_mcps: []
 allowed-tools: Bash(python3:*), Bash(cairosvg:*), Read(*), Write(*)
 ---

package/resources/skills/skills/eu-funding/grant-outreach/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: grant-outreach
+description: 'Use when user says "grant outreach", "propose grants to companies by email", "grant brokerage", or asks about HU/SK B2B cold-email rules. Matches a grant to a company, drafts a compliant pitch.'
+tags: [eu-funding, outreach, email, grants, compliance, hungary, slovakia]
+---
+
+# Grant outreach (HU / SK B2B)
+
+Turn the funding-research capability into an outreach motion: find a live grant,
+match it to companies that qualify, and email them a compliant proposal. This is a
+brokerage / lead-gen service (not a product). Find the grants first with [[hu-grant-finder]].
+
+## Compliance first (one complaint can outweigh a deal)
+
+HU and SK are **opt-in** countries for marketing email (SK: Act 351/2011 §62; HU: Grt.
++ GDPR). Cold B2B email is defensible only on **GDPR legitimate interest** (Art 6(1)(f)),
+and only done right:
+
+- Email **generic company addresses** (`info@`, `obchod@`), never named persons.
+- The pitch must be **genuinely relevant** (a grant the company actually qualifies for)
+  and tied to their professional role. That relevance *is* the legitimate interest.
+- **Identify yourself** (company, address) and give a **one-click opt-out** in every mail.
+- Keep a written **LIA** (legitimate interest assessment) and an opt-out / suppression log.
+- Throttle, and never re-email an opt-out.
+- Verify with the **Slovak DPA** (`dataprotection.gov.sk`) or **NAIH** (HU) or a lawyer
+  before scaling. This skill is not legal advice.
+
+## Workflow
+
+1. **Find a live grant** via [[hu-grant-finder]] (eligibility: sector, size, region, deadline).
+2. **Build a target list** of companies matching the eligibility, from public registers:
+   SK **ORSR** (`orsr.sk`) / **FinStat** (`finstat.sk`); HU **e-cégjegyzék** / Céginfo /
+   OPTEN. Keep only generic contact addresses.
+3. **Match + rank** each company to the grant: why they qualify, the amount, the deadline.
+4. **Draft** a short, personal email per company (use the `email-sequence-writer` skill for
+   the copy). Lead with their fit, not your service.
+5. **Send compliant** through an ESP with sender-ID + opt-out + throttle + suppression list.
+6. **Track** replies; price as success fee (% of grant won) or retainer.
+
+## Email skeleton (SK / HU, compliant)
+
+```
+Subject: <Program> – <amount> for <their sector> (deadline <date>)
+
+Dobrý deň / Tisztelt <Company>,
+
+<Program X> is open and your company looks eligible: <1-line why: sector, size, region>.
+It is <amount, %>, deadline <date>. Happy to send a 1-page fit check.
+
+<Your name>, <Company>, <address> · <phone>
+Unsubscribe: <link>   (we will not email again)
+```
+
+## Rules
+
+- Compliance is the gate, not an afterthought: generic address + real relevance +
+  sender-ID + opt-out + LIA, or do not send.
+- Relevance is the legitimate-interest argument. A grant the company cannot win is spam;
+  match eligibility hard first via [[hu-grant-finder]].
+- Never email a named individual or a scraped personal address; never re-email an opt-out.
+- This is outreach, not legal counsel. Flag the Slovak DPA / NAIH check before scaling.
+
+## Example
+
+User: "Let's offer Program Slovensko grants to other companies by email."
+
+Pull the open grant + eligibility via [[hu-grant-finder]], build a target list from
+ORSR / FinStat filtered to that eligibility, draft one relevant email per company to its
+generic address with sender-ID + opt-out, log the LIA, and send throttled. Flag that B2B
+cold email needs a legitimate-interest basis and a DPA check before scaling.