feat: promotion-assistant skill package v0.1.0

2026-08-14 17:25:38 +02:00
commit fb8724d095
9 changed files with 945 additions and 0 deletions
--- a/PROVENANCE.md
+++ b/PROVENANCE.md
@@ -0,0 +1,31 @@
+# Data provenance — promotion-assistant
+
+Where the content of this skill package comes from, counted by
+content items (tasks, competences, tools, evidence entries, curated
+knowledge). Rendered live by Gitea:
+
+```mermaid
+%%{init: {'theme':'base','themeVariables':{'pie1':'#f9a825','pie2':'#1e88e5','pie3':'#ff355e','pie4':'#d97757','pie5':'#8e24aa','pieOuterStrokeWidth':'0px','pieSectionTextColor':'#fff'}}}%%
+pie showData
+    title Content sources — promotion-assistant
+    "ESCO (occupation & competences)" : 23
+    "O*NET (tasks & tools)" : 175
+    "Job boards (market evidence)" : 69
+    "Anthropic official Claude skills" : 8
+    "External AI skill packs (mapped)" : 138
+```
+
+| Source | Items | Share | Files |
+|---|---|---|---|
+| ESCO (occupation & competences) | 23 | 5.6 % | references/profile.md, references/skills.md |
+| O*NET (tasks & tools) | 175 | 42.4 % | references/tasks.md, references/tools.md |
+| Job boards (market evidence) | 69 | 16.7 % | references/market.md (full report) + "Market evidence" headline sections |
+| Wikipedia & AI expert curation | 0 | 0.0 % | glossary, literature, usecases, intake, quality, evals/ |
+| Anthropic official Claude skills | 8 | 1.9 % | references/ai-skills.md, section "anthropics/skills" (official Claude Code skills) |
+| External AI skill packs (mapped) | 138 | 33.4 % | references/ai-skills.md (per-source attribution inside) |
+| Stack Exchange practitioner Q&A (CC-BY-SA) | 0 | 0.0 % | references/practitioner-qa.md (per-entry attribution inside) |
+
+Licensing: O*NET (USDOL/ETA, CC BY 4.0) · ESCO (© European Union) ·
+job-ad evidence via official APIs (JSearch/Adzuna) · Wikipedia content
+paraphrased with source URLs — never copied · external AI skills are
+linked, not copied (Apache-2.0/MIT/source-available, see ai-skills.md).
--- a/SKILL.md
+++ b/SKILL.md
@@ -0,0 +1,58 @@
+---
+name: promotion-assistant
+description: "Occupational skill for the role 'promotion assistant' (also: events and promotion assistant, marketing promotion assistant, promotions assistant, assistant promoter, promotional assistant). Use when the user asks for typical promotion assistant work such as: typical promotion assistant responsibilities"
+---
+
+# Promotion Assistant
+
+Promotion assistants provide support in the implementation of programs and promotional efforts in points-of-sale. They research and administer all the information required by managers to decide whether promotional programs are required. If so, they support in getting of materials and resources for the promotional action.
+
+## Core workflow
+
+
+## How to use this skill
+
+- Read [references/profile.md](references/profile.md) for the occupation profile and scope.
+- Consult [references/tasks.md](references/tasks.md) for the full task and activity inventory.
+- Check [references/skills.md](references/skills.md) for essential vs. optional competences.
+- Check [references/tools.md](references/tools.md) for the software commonly used in this role.
+- See [references/ai-skills.md](references/ai-skills.md) — matched external AI agent skills (per-source attribution).
+
+## Key competences (essential)
+
+- advertising techniques
+- assist in developing marketing campaigns
+- communication principles
+- help coordinate promotional activities
+- perform business research
+- perform clerical duties
+- perform office routine activities
+- support managers
+
+## Hot technologies
+
+- Adobe Acrobat
+- Adobe After Effects
+- Adobe Creative Cloud software
+- Adobe Illustrator
+- Adobe InDesign
+- Adobe Photoshop
+- Amazon Redshift
+- Apache Hadoop
+- Apache Hive
+- Apple macOS
+
+
+<!-- hot-tech -->
+
+## Hot technologies
+
+Top tools from 34 gated job ads (see references/market.md, as of 2026-07-19):
+
+- Microsoft Office — 15 %
+- social media platforms — 9 %
+
+<!-- hot-tech -->
+
+---
+*Sources: ESCO v1.2.1 (http://data.europa.eu/esco/occupation/21af40bb-2ae3-4fc7-9b28-d2cdd8308912), O*NET 30.3 (13-1161.00, manual nearest match). See manifest.json for licensing/attribution.*
--- a/manifest.json
+++ b/manifest.json
@@ -0,0 +1,202 @@
+{
+  "name": "promotion-assistant",
+  "title": "promotion assistant",
+  "version": "0.1.0",
+  "layer": "core",
+  "language": "en",
+  "generated": "2026-07-07",
+  "ids": {
+    "esco_uri": "http://data.europa.eu/esco/occupation/21af40bb-2ae3-4fc7-9b28-d2cdd8308912",
+    "esco_code": "2431.16",
+    "isco_group": "2431",
+    "onet_soc": "13-1161.00",
+    "crosswalk_match": "manual nearest via ISCO 2431 (Market Research Analysts and Marketing Specialists)"
+  },
+  "sources": [
+    {
+      "name": "ESCO",
+      "version": "1.2.1",
+      "url": "https://esco.ec.europa.eu/"
+    },
+    {
+      "name": "O*NET",
+      "version": "30.3",
+      "url": "https://www.onetcenter.org/",
+      "license": "CC BY 4.0"
+    }
+  ],
+  "attribution": "This package includes information from the O*NET Database (v30.3) by the U.S. Department of Labor, Employment and Training Administration (USDOL/ETA), CC BY 4.0. skillfactor is not endorsed by USDOL/ETA. ESCO data (v1.2.1) (c) European Union, used per the ESCO download conditions: https://esco.ec.europa.eu/en/use-esco/download",
+  "counts": {
+    "tasks": 0,
+    "dwas": 0,
+    "skills_essential": 8,
+    "skills_optional": 14,
+    "software": 0
+  },
+  "enrichment_ai_skills": {
+    "generated": "2026-07-14",
+    "method": "deterministic mapping (ISCO prefix + title/competence keywords)",
+    "sources": {
+      "anthropics/skills": {
+        "repo": "https://github.com/anthropics/skills",
+        "commit": "f6656c1",
+        "license": "Apache-2.0; the document skills (docx/pdf/pptx/xlsx) are source-available \u2014 see the LICENSE.txt in the upstream skill folder",
+        "skills": 5
+      },
+      "wshobson/agents": {
+        "repo": "https://github.com/wshobson/agents",
+        "commit": "6fd3247",
+        "license": "MIT (c) Seth Hobson",
+        "skills": 12
+      },
+      "google/skills": {
+        "repo": "https://github.com/google/skills",
+        "commit": "b15f327",
+        "license": "Apache-2.0",
+        "skills": 8
+      },
+      "coreyhaines31/marketingskills": {
+        "repo": "https://github.com/coreyhaines31/marketingskills",
+        "commit": "33218ff",
+        "license": "MIT",
+        "skills": 12
+      },
+      "realkimbarrett/advertising-skills": {
+        "repo": "https://github.com/realkimbarrett/advertising-skills",
+        "commit": "45f4a4a",
+        "license": "no explicit license \u2014 referenced by link only",
+        "skills": 6
+      },
+      "resend/resend-skills": {
+        "repo": "https://github.com/resend/resend-skills",
+        "commit": "2caefff",
+        "license": "MIT",
+        "skills": 5
+      },
+      "ConardLi/garden-skills": {
+        "repo": "https://github.com/ConardLi/garden-skills",
+        "commit": "fbd6453",
+        "license": "MIT",
+        "skills": 1
+      },
+      "vibeeval/vibecosystem": {
+        "repo": "https://github.com/vibeeval/vibecosystem",
+        "commit": "cea9462",
+        "license": "MIT",
+        "skills": 2
+      },
+      "rampstackco/claude-skills": {
+        "repo": "https://github.com/rampstackco/claude-skills",
+        "commit": "bc6d961",
+        "license": "MIT",
+        "skills": 2
+      },
+      "infrasity-labs/dev-gtm-claude-skills": {
+        "repo": "https://github.com/infrasity-labs/dev-gtm-claude-skills",
+        "commit": "02cfefb",
+        "license": "MIT",
+        "skills": 3
+      },
+      "mukul975/Anthropic-Cybersecurity-Skills": {
+        "repo": "https://github.com/mukul975/Anthropic-Cybersecurity-Skills",
+        "commit": "673da1f",
+        "license": "Apache-2.0",
+        "skills": 2
+      },
+      "nexscope-ai/eCommerce-Skills": {
+        "repo": "https://github.com/nexscope-ai/eCommerce-Skills",
+        "commit": "56f3288",
+        "license": "MIT",
+        "skills": 1
+      },
+      "davepoon/buildwithclaude": {
+        "repo": "https://github.com/davepoon/buildwithclaude",
+        "commit": "3c94e0c",
+        "license": "MIT",
+        "skills": 3
+      },
+      "ljagiello/ctf-skills": {
+        "repo": "https://github.com/ljagiello/ctf-skills",
+        "commit": "d19f35f",
+        "license": "MIT",
+        "skills": 1
+      },
+      "alirezarezvani/claude-skills": {
+        "repo": "https://github.com/alirezarezvani/claude-skills",
+        "commit": "0241f43",
+        "license": "MIT",
+        "skills": 3
+      },
+      "davila7/claude-code-templates": {
+        "repo": "https://github.com/davila7/claude-code-templates",
+        "commit": "fa79251",
+        "license": "MIT",
+        "skills": 4
+      },
+      "brycewang-stanford/Auto-Empirical-Research-Skills": {
+        "repo": "https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills",
+        "commit": "85bf545",
+        "license": "CC-BY-4.0",
+        "skills": 3
+      },
+      "a5c-ai/babysitter": {
+        "repo": "https://github.com/a5c-ai/babysitter",
+        "commit": "44a5d58b",
+        "license": "MIT",
+        "skills": 2
+      },
+      "mohitagw15856/pm-claude-skills": {
+        "repo": "https://github.com/mohitagw15856/pm-claude-skills",
+        "commit": "876fa30",
+        "license": "MIT",
+        "skills": 2
+      },
+      "nexu-io/open-design": {
+        "repo": "https://github.com/nexu-io/open-design",
+        "commit": "4b66023",
+        "license": "Apache-2.0",
+        "skills": 1
+      },
+      "K-Dense-AI/claude-scientific-skills": {
+        "repo": "https://github.com/K-Dense-AI/claude-scientific-skills",
+        "commit": "4d97e29",
+        "license": "MIT",
+        "skills": 1
+      },
+      "K-Dense-AI/scientific-agent-skills": {
+        "repo": "https://github.com/K-Dense-AI/scientific-agent-skills",
+        "commit": "4d97e29",
+        "license": "MIT",
+        "skills": 1
+      }
+    },
+    "total_skills": 80,
+    "tiers": {
+      "core": 39,
+      "adjacent": 41
+    }
+  },
+  "provenance": {
+    "items": {
+      "esco": 23,
+      "onet": 175,
+      "jobads": 69,
+      "wiki_ai": 0,
+      "anthropic": 8,
+      "ai_skills": 138,
+      "stackx": 0
+    },
+    "share_percent": {
+      "esco": 5.6,
+      "onet": 42.4,
+      "jobads": 16.7,
+      "wiki_ai": 0.0,
+      "anthropic": 1.9,
+      "ai_skills": 33.4,
+      "stackx": 0.0
+    },
+    "method": "content items per source category"
+  },
+  "collar": "white",
+  "computer_work": true
+}
--- a/references/ai-skills.md
+++ b/references/ai-skills.md
@@ -0,0 +1,274 @@
+# External AI agent skills — promotion-assistant
+
+Proven, publicly available AI agent skills mapped to this occupation.
+Nothing is copied from the sources: every entry is a name, a one-line
+summary and a link to the upstream skill package. Each section names
+its source repository, commit, license and retrieval date.
+
+**Tiers:** `core` = the skill directly exercises a top market hard
+skill, tool or method (from gated job-ad evidence) or an essential
+ESCO competence of this occupation; `adjacent` =
+plausibly useful, secondary. Entries are capped at 12 per source
+and 80 in total per occupation (core first,
+strongest matches survive); everything beyond the caps is excluded
+and logged in the pipeline audit trail, not in this package.
+
+_Matched deterministically (ISCO group + title/competence keywords,
+tiered against market evidence + ESCO essentials) by
+`pipeline/p5_enrich_ai_skills.py` on 2026-07-14._
+
+## Source: anthropics/skills
+
+- Repository: [https://github.com/anthropics/skills](https://github.com/anthropics/skills) (commit `f6656c1`, retrieved 2026-07-14)
+- License: Apache-2.0; the document skills (docx/pdf/pptx/xlsx) are source-available — see the LICENSE.txt in the upstream skill folder
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `brand-guidelines` | adjacent | Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | [source](https://github.com/anthropics/skills/tree/main/skills/brand-guidelines) |
+| `pptx` | adjacent | Use this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even … | [source](https://github.com/anthropics/skills/tree/main/skills/pptx) |
+| `docx` | adjacent | Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to … | [source](https://github.com/anthropics/skills/tree/main/skills/docx) |
+| `pdf` | adjacent | Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating … | [source](https://github.com/anthropics/skills/tree/main/skills/pdf) |
+| `slack-gif-creator` | adjacent | Knowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack. | [source](https://github.com/anthropics/skills/tree/main/skills/slack-gif-creator) |
+
+## Source: wshobson/agents
+
+- Repository: [https://github.com/wshobson/agents](https://github.com/wshobson/agents) (commit `6fd3247`, retrieved 2026-07-14)
+- License: MIT (c) Seth Hobson
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `content-marketer (agent)` | core | Elite content marketing strategist specializing in AI-powered content creation, omnichannel distribution, SEO optimization, and data-driven performance marketing. Masters modern content tools, social media automation, and conversion … | [source](https://github.com/wshobson/agents/tree/main/plugins/content-marketing/agents/content-marketer.md) |
+| `search-specialist (agent)` | core | Expert web researcher using advanced search techniques and synthesis. Masters search operators, result filtering, and multi-source verification. Handles competitive analysis and fact-checking. Use PROACTIVELY for deep research, information … | [source](https://github.com/wshobson/agents/tree/main/plugins/content-marketing/agents/search-specialist.md) |
+| `social-publishing` | core | Schedule and publish social media posts across 13 platforms (X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest) via the SocialClaw API. Use when the user wants to publish, schedule, or … | [source](https://github.com/wshobson/agents/tree/main/plugins/social-publishing/skills/social-publishing) |
+| `brand-landingpage` | adjacent | Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, … | [source](https://github.com/wshobson/agents/tree/main/plugins/brand-landingpage/skills/brand-landingpage) |
+| `seo-content-planner (agent)` | adjacent | Creates comprehensive content outlines and topic clusters for SEO. Plans content calendars and identifies topic gaps. Use PROACTIVELY for content strategy and planning. | [source](https://github.com/wshobson/agents/tree/main/plugins/seo-content-creation/agents/seo-content-planner.md) |
+| `seo-authority-builder (agent)` | adjacent | Analyzes content for E-E-A-T signals and suggests improvements to build authority and trust. Identifies missing credibility elements. Use PROACTIVELY for YMYL topics. | [source](https://github.com/wshobson/agents/tree/main/plugins/seo-analysis-monitoring/agents/seo-authority-builder.md) |
+| `seo-cannibalization-detector (agent)` | adjacent | Analyzes multiple provided pages to identify keyword overlap and potential cannibalization issues. Suggests differentiation strategies. Use PROACTIVELY when reviewing similar content. | [source](https://github.com/wshobson/agents/tree/main/plugins/seo-analysis-monitoring/agents/seo-cannibalization-detector.md) |
+| `seo-content-auditor (agent)` | adjacent | Analyzes provided content for quality, E-E-A-T signals, and SEO best practices. Scores content and provides improvement recommendations based on established guidelines. Use PROACTIVELY for content review. | [source](https://github.com/wshobson/agents/tree/main/plugins/seo-content-creation/agents/seo-content-auditor.md) |
+| `seo-content-refresher (agent)` | adjacent | Identifies outdated elements in provided content and suggests updates to maintain freshness. Finds statistics, dates, and examples that need updating. Use PROACTIVELY for older content. | [source](https://github.com/wshobson/agents/tree/main/plugins/seo-analysis-monitoring/agents/seo-content-refresher.md) |
+| `seo-content-writer (agent)` | adjacent | Writes SEO-optimized content based on provided keywords and topic briefs. Creates engaging, comprehensive content following best practices. Use PROACTIVELY for content creation tasks. | [source](https://github.com/wshobson/agents/tree/main/plugins/seo-content-creation/agents/seo-content-writer.md) |
+| `seo-keyword-strategist (agent)` | adjacent | Analyzes keyword usage in provided content, calculates density, suggests semantic variations and LSI keywords based on the topic. Prevents over-optimization. Use PROACTIVELY for content optimization. | [source](https://github.com/wshobson/agents/tree/main/plugins/seo-technical-optimization/agents/seo-keyword-strategist.md) |
+| `seo-meta-optimizer (agent)` | adjacent | Creates optimized meta titles, descriptions, and URL suggestions based on character limits and best practices. Generates compelling, keyword-rich metadata. Use PROACTIVELY for new content. | [source](https://github.com/wshobson/agents/tree/main/plugins/seo-technical-optimization/agents/seo-meta-optimizer.md) |
+
+## Source: realkimbarrett/advertising-skills
+
+- Repository: [https://github.com/realkimbarrett/advertising-skills](https://github.com/realkimbarrett/advertising-skills) (commit `45f4a4a`, retrieved 2026-07-14)
+- License: no explicit license — referenced by link only
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `performance-diagnosis` | adjacent | Diagnose why campaigns are underperforming. Trigger on "low performance", "high CPL", "bad ads". | [source](https://github.com/realkimbarrett/advertising-skills/tree/45f4a4a/skills/operator-os/performance-diagnosis) |
+| `ad-angle-multiplier` | adjacent | Expand a core idea into multiple distinct ad angles. Trigger on "more ads", "creative testing", "scale campaigns". | [source](https://github.com/realkimbarrett/advertising-skills/tree/45f4a4a/skills/operator-os/ad-angle-multiplier) |
+| `full-funnel-campaign-orchestrator` | adjacent | Coordinate all skills to build a complete advertising campaign. Trigger on "build a campaign", "full funnel", "ads + funnel". | [source](https://github.com/realkimbarrett/advertising-skills/tree/45f4a4a/skills/orchestrators/full-funnel-campaign-orchestrator) |
+| `conversion-path-builder` | adjacent | Design the optimal funnel from click to conversion. Trigger on "funnel", "conversion path", "booked calls". | [source](https://github.com/realkimbarrett/advertising-skills/tree/45f4a4a/skills/operator-os/conversion-path-builder) |
+| `mechanism-builder` | adjacent | Use when you need to explain why your solution works and others failed. Trigger on "unique mechanism", "why this works", "different angle", "positioning". | [source](https://github.com/realkimbarrett/advertising-skills/tree/45f4a4a/skills/copy-chief/mechanism-builder) |
+| `scroll-stopping-creative` | adjacent | Create ad concepts that stop attention in the first 3 seconds. Trigger on "ad creative", "thumbstopper", "video ideas". | [source](https://github.com/realkimbarrett/advertising-skills/tree/45f4a4a/skills/operator-os/scroll-stopping-creative) |
+
+## Source: ConardLi/garden-skills
+
+- Repository: [https://github.com/ConardLi/garden-skills](https://github.com/ConardLi/garden-skills) (commit `fbd6453`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `kb-retriever` | adjacent | 面向本地知识库目录的检索和问答助手。核心流程：(1)分层索引导航 (2)遇到PDF/Excel时必须先读取references学习处理方法 (3)处理文件后再检索。按文件类型组合使用 grep、Read、pdfplumber、pandas 进行渐进式检索，避免整文件加载。用户问题涉及"从知识库目录回答问题/检索信息/查资料"时使用。 | [source](https://github.com/ConardLi/garden-skills/tree/fbd6453/skills/kb-retriever) |
+
+## Source: a5c-ai/babysitter
+
+- Repository: [https://github.com/a5c-ai/babysitter](https://github.com/a5c-ai/babysitter) (commit `44a5d58b`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `aiml-security` | core | AI/ML model security testing and adversarial research capabilities. Generate adversarial examples, test model robustness, perform model extraction attacks, test for data poisoning, analyze model fairness, and support ART framework … | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/security-research/skills/aiml-security) |
+| `memlab-analysis` | core | Expert skill for JavaScript memory leak detection using Facebook MemLab. Configure MemLab scenarios, execute memory leak detection runs, analyze heap snapshots, identify detached DOM elements, find event listener leaks, and integrate with … | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/performance-optimization/skills/memlab-analysis) |
+
+## Source: alirezarezvani/claude-skills
+
+- Repository: [https://github.com/alirezarezvani/claude-skills](https://github.com/alirezarezvani/claude-skills) (commit `0241f43`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `paid-ads` | core | When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ad copy,' 'ad creative,' 'ROAS,' 'CPA,' … | [source](https://github.com/alirezarezvani/claude-skills/tree/0241f43/marketing-skill/skills/paid-ads) |
+| `free-tool-strategy` | core | When the user wants to build a free tool for marketing — lead generation, SEO value, or brand awareness. Use when they mention 'engineering as marketing,' 'free tool,' 'calculator,' 'generator,' 'checker,' 'grader,' 'marketing tool,' 'lead … | [source](https://github.com/alirezarezvani/claude-skills/tree/0241f43/marketing-skill/skills/free-tool-strategy) |
+| `social-media-analyzer` | core | Social media campaign analysis and performance tracking. Calculates engagement rates, ROI, and benchmarks across platforms. Use when analyzing social media performance, calculating engagement rate, measuring campaign ROI, comparing … | [source](https://github.com/alirezarezvani/claude-skills/tree/0241f43/marketing-skill/skills/social-media-analyzer) |
+
+## Source: brycewang-stanford/Auto-Empirical-Research-Skills
+
+- Repository: [https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills) (commit `85bf545`, retrieved 2026-07-14)
+- License: CC-BY-4.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `survival-analysis-guide` | core | Conduct Kaplan-Meier, Cox regression, and time-to-event analyses | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/analysis/statistics/survival-analysis-guide) |
+| `molecular-dynamics-guide` | core | Molecular dynamics simulation setup, execution, and trajectory analysis | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/domains/chemistry/molecular-dynamics-guide) |
+| `particle-physics-guide` | core | Particle physics data analysis with ROOT, HEPData, and event processing | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/domains/physics/particle-physics-guide) |
+
+## Source: davepoon/buildwithclaude
+
+- Repository: [https://github.com/davepoon/buildwithclaude](https://github.com/davepoon/buildwithclaude) (commit `3c94e0c`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `calendly-automation` | core | Automate Calendly scheduling, event management, invitee tracking, availability checks, and organization administration via Rube MCP (Composio). Always search tools first for current schemas. | [source](https://github.com/davepoon/buildwithclaude/tree/3c94e0c/plugins/all-skills/skills/calendly-automation) |
+| `lead-research-assistant` | core | Identifies high-quality leads for your product or service by analyzing your business, searching for target companies, and providing actionable contact strategies. Perfect for sales, business development, and marketing professionals. | [source](https://github.com/davepoon/buildwithclaude/tree/3c94e0c/plugins/all-skills/skills/lead-research-assistant) |
+| `ops-marketing` | core | Marketing command center. Email campaigns (Klaviyo), paid ads (Meta/Google), analytics (GA4), SEO, and social media metrics. One dashboard for all marketing channels. | [source](https://github.com/davepoon/buildwithclaude/tree/3c94e0c/plugins/claude-ops/skills/ops-marketing) |
+
+## Source: davila7/claude-code-templates
+
+- Repository: [https://github.com/davila7/claude-code-templates](https://github.com/davila7/claude-code-templates) (commit `fa79251`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `paid-ads` | core | When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ad copy,' 'ad creative,' 'ROAS,' 'CPA,' … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/business-marketing/paid-ads) |
+| `executing-marketing-campaigns` | core | Plans, creates, and optimizes marketing campaigns including content strategy, social media, email, and analytics. Helps develop go-to-market strategies, campaign messaging, and performance measurement. | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/creative-design/executing-marketing-campaigns) |
+| `free-tool-strategy` | core | When the user wants to plan, evaluate, or build a free tool for marketing purposes — lead generation, SEO value, or brand awareness. Also use when the user mentions "engineering as marketing," "free tool," "marketing tool," "calculator," … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/business-marketing/free-tool-strategy) |
+| `lead-research-assistant` | core | Identifies high-quality leads for your product or service by analyzing your business, searching for target companies, and providing actionable contact strategies. Perfect for sales, business development, and marketing professionals. | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/business-marketing/lead-research-assistant) |
+
+## Source: infrasity-labs/dev-gtm-claude-skills
+
+- Repository: [https://github.com/infrasity-labs/dev-gtm-claude-skills](https://github.com/infrasity-labs/dev-gtm-claude-skills) (commit `02cfefb`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `ads` | core | When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ROAS,' 'CPA,' 'ad campaign,' … | [source](https://github.com/infrasity-labs/dev-gtm-claude-skills/tree/02cfefb/.claude/skills/ads) |
+| `customer-research` | core | When the user wants to conduct, analyze, or synthesize customer research. Use when the user mentions "customer research," "ICP research," "talk to customers," "analyze transcripts," "customer interviews," "survey analysis," "support ticket … | [source](https://github.com/infrasity-labs/dev-gtm-claude-skills/tree/02cfefb/marketing-skills/customer-research) |
+| `free-tools` | core | When the user wants to plan, evaluate, or build a free tool for marketing purposes — lead generation, SEO value, or brand awareness. Also use when the user mentions "engineering as marketing," "free tool," "marketing tool," "calculator," … | [source](https://github.com/infrasity-labs/dev-gtm-claude-skills/tree/02cfefb/.claude/skills/free-tools) |
+
+## Source: K-Dense-AI/claude-scientific-skills
+
+- Repository: [https://github.com/K-Dense-AI/claude-scientific-skills](https://github.com/K-Dense-AI/claude-scientific-skills) (commit `4d97e29`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `open-notebook` | core | Self-hosted, open-source alternative to Google NotebookLM for AI-powered research and document analysis. Use when organizing research materials into notebooks, ingesting diverse content sources (PDFs, videos, audio, web pages, Office … | [source](https://github.com/K-Dense-AI/claude-scientific-skills/tree/4d97e29/skills/open-notebook) |
+
+## Source: K-Dense-AI/scientific-agent-skills
+
+- Repository: [https://github.com/K-Dense-AI/scientific-agent-skills](https://github.com/K-Dense-AI/scientific-agent-skills) (commit `4d97e29`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `open-notebook` | core | Self-hosted, open-source alternative to Google NotebookLM for AI-powered research and document analysis. Use when organizing research materials into notebooks, ingesting diverse content sources (PDFs, videos, audio, web pages, Office … | [source](https://github.com/K-Dense-AI/scientific-agent-skills/tree/4d97e29/skills/open-notebook) |
+
+## Source: ljagiello/ctf-skills
+
+- Repository: [https://github.com/ljagiello/ctf-skills](https://github.com/ljagiello/ctf-skills) (commit `d19f35f`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `ctf-forensics` | core | Provides digital forensics and signal analysis techniques for CTF challenges. Use when analyzing disk images, memory dumps, event logs, network captures, cryptocurrency transactions, steganography, PDF analysis, Windows registry, … | [source](https://github.com/ljagiello/ctf-skills/tree/d19f35f/ctf-forensics) |
+
+## Source: mohitagw15856/pm-claude-skills
+
+- Repository: [https://github.com/mohitagw15856/pm-claude-skills](https://github.com/mohitagw15856/pm-claude-skills) (commit `876fa30`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `community-management-playbook` | core | Build a community management playbook for a brand's social media channels. Use when asked to create guidelines for managing comments, DMs, and community interactions, define a moderation policy, or build response frameworks for social … | [source](https://github.com/mohitagw15856/pm-claude-skills/tree/876fa30/plugins/pm-social/skills/community-management-playbook) |
+| `lifecycle-crm-plan` | core | Design lifecycle marketing / CRM journeys across the customer lifecycle. Use when asked to plan onboarding emails, lifecycle/CRM campaigns, drip sequences, re-engagement or winback flows, or a messaging calendar. Produces a lifecycle plan … | [source](https://github.com/mohitagw15856/pm-claude-skills/tree/876fa30/plugins/pm-growth/skills/lifecycle-crm-plan) |
+
+## Source: mukul975/Anthropic-Cybersecurity-Skills
+
+- Repository: [https://github.com/mukul975/Anthropic-Cybersecurity-Skills](https://github.com/mukul975/Anthropic-Cybersecurity-Skills) (commit `673da1f`, retrieved 2026-07-14)
+- License: Apache-2.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `analyzing-macro-malware-in-office-documents` | core | Analyzes malicious VBA macros embedded in Microsoft Office documents (Word, Excel, PowerPoint) to identify download cradles, payload execution, persistence mechanisms, and anti-analysis techniques. Uses olevba, oledump, and VBA … | [source](https://github.com/mukul975/Anthropic-Cybersecurity-Skills/tree/673da1f/skills/analyzing-macro-malware-in-office-documents) |
+| `performing-brand-monitoring-for-impersonation` | core | Monitor for brand impersonation attacks across domains, social media, mobile apps, and dark web channels to detect phishing campaigns, fake sites, and unauthorized brand usage targeting your organization. | [source](https://github.com/mukul975/Anthropic-Cybersecurity-Skills/tree/673da1f/skills/performing-brand-monitoring-for-impersonation) |
+
+## Source: nexscope-ai/eCommerce-Skills
+
+- Repository: [https://github.com/nexscope-ai/eCommerce-Skills](https://github.com/nexscope-ai/eCommerce-Skills) (commit `56f3288`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `brand-monitoring` | core | Brand monitoring tool for tracking mentions across social media platforms. Monitor Reddit, Google News, YouTube, and DuckDuckGo for brand mentions. Includes sentiment analysis, trend tracking, crisis detection, and competitor comparison. … | [source](https://github.com/nexscope-ai/eCommerce-Skills/tree/56f3288/brand-monitoring) |
+
+## Source: nexu-io/open-design
+
+- Repository: [https://github.com/nexu-io/open-design](https://github.com/nexu-io/open-design) (commit `4b66023`, retrieved 2026-07-14)
+- License: Apache-2.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `magazine-web-ppt` | core | For marketing and gtm work: bind launches, campaigns, events, and brand plans to growth and pipeline outcomes. Built around the core query "annual-marketing-plan", with GTM strategy lead judgment, buyer-ready proof, and this outcome: … | [source](https://github.com/nexu-io/open-design/tree/4b66023/design-templates/guizang-ppt) |
+
+## Source: rampstackco/claude-skills
+
+- Repository: [https://github.com/rampstackco/claude-skills](https://github.com/rampstackco/claude-skills) (commit `bc6d961`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `product-analytics-setup` | core | How to actually instrument product analytics correctly. Event taxonomy, property design, naming conventions, schema versioning, identity stitching, funnel design, retention cohorts, North Star metric selection, dashboard hygiene, … | [source](https://github.com/rampstackco/claude-skills/tree/bc6d961/skills/product-analytics-setup) |
+| `discovery-research-synthesis` | core | Turning research artifacts into actionable PM insight. Customer interviews, user research notes, support ticket reviews, sales call transcripts, survey data, in-app feedback, all synthesized into the decisions they are meant to inform. The … | [source](https://github.com/rampstackco/claude-skills/tree/bc6d961/skills/discovery-research-synthesis) |
+
+## Source: vibeeval/vibecosystem
+
+- Repository: [https://github.com/vibeeval/vibecosystem](https://github.com/vibeeval/vibecosystem) (commit `cea9462`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `saas-analytics-patterns` | core | SaaS analytics event taxonomy, metric formulas (MRR, churn, LTV), provider-agnostic tracking, funnel analysis, cohort setup, and privacy-respecting instrumentation. | [source](https://github.com/vibeeval/vibecosystem/tree/cea9462/skills/saas-analytics-patterns) |
+| `product-analytics` | core | Product analytics - event taxonomy, funnel analysis, A/B testing, retention metrikleri. | [source](https://github.com/vibeeval/vibecosystem/tree/cea9462/skills/product-analytics) |
+
+## Source: google/skills
+
+- Repository: [https://github.com/google/skills](https://github.com/google/skills) (commit `b15f327`, retrieved 2026-07-14)
+- License: Apache-2.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `google-ads-api-quickstart` | adjacent | Guides developers through Google Ads API quickstart: credential setup, choosing from 6 client libraries/REST, configuring environments, and running a "retrieve campaigns" script. Troubleshoots common setup errors: USER_PERMISSION_DENIED, … | [source](https://github.com/google/skills/tree/b15f327/skills/ads/google-ads-api/google-ads-api-quickstart) |
+| `google-ads-api-mcp-setup` | adjacent | Guides developers through downloading, configuring, and installing the official open-source Google Ads MCP Server. Use this skill when a user wants to connect their AI assistant (such as Gemini, Claude Code, or Cursor) to their Google Ads … | [source](https://github.com/google/skills/tree/b15f327/skills/ads/google-ads-api/google-ads-api-mcp-setup) |
+| `google-mobile-ads-android-migrate-to-next-gen` | adjacent | Migrates Android applications from the old, legacy Google Mobile Ads (GMA) SDK (com.google.android.gms:play-services-ads) to the new GMA Next-Gen SDK (com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk). Provides comprehensive … | [source](https://github.com/google/skills/tree/b15f327/skills/ads/google-mobile-ads/google-mobile-ads-android-migrate-to-next-gen) |
+| `google-mobile-ads-banner` | adjacent | Provides instructions to implement, integrate, or configure Google Mobile Ads (GMA) banner ads in Android and iOS mobile applications. Use when the task involves setting up banner ads in a mobile application. | [source](https://github.com/google/skills/tree/b15f327/skills/ads/google-mobile-ads/google-mobile-ads-banner) |
+| `google-mobile-ads-get-started` | adjacent | Provides instructions for integrating the Google Mobile Ads (GMA) SDK. Use this skill when the user wants to get started with, install, integrate, set up, or configure the SDK for AdMob or Ad Manager, GMA Next-Gen SDK or mobile ads … | [source](https://github.com/google/skills/tree/b15f327/skills/ads/google-mobile-ads/google-mobile-ads-get-started) |
+| `google-mobile-ads-interstitial` | adjacent | Provides instructions for implementing, integrating, or configuring Google Mobile Ads (GMA) SDK interstitial ads in Android and iOS mobile applications. Use this skill when the task involves setting up interstitial ads. Don't use for … | [source](https://github.com/google/skills/tree/b15f327/skills/ads/google-mobile-ads/google-mobile-ads-interstitial) |
+| `google-mobile-ads-rewarded` | adjacent | Provides instructions for implementing, integrating, or configuring Google Mobile Ads (GMA) SDK rewarded ads in Android or iOS mobile applications. Use this skill when the task involves setting up rewarded ads. Don't use for "rewarded … | [source](https://github.com/google/skills/tree/b15f327/skills/ads/google-mobile-ads/google-mobile-ads-rewarded) |
+| `workload-manager-basics` | adjacent | Use this skill to manage Google Cloud Workload Manager evaluations, rules, scanned resources, and validation results by using public client libraries and the REST API. Use when you need to inspect workload best-practice rules, create and … | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/workload-manager-basics) |
+
+## Source: coreyhaines31/marketingskills
+
+- Repository: [https://github.com/coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills) (commit `33218ff`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `ads` | core | When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ROAS,' 'CPA,' 'ad campaign,' … | [source](https://github.com/coreyhaines31/marketingskills/tree/33218ff/skills/ads) |
+| `free-tools` | core | When the user wants to plan, evaluate, or build a free tool for marketing purposes — lead generation, SEO value, or brand awareness. Also use when the user mentions "engineering as marketing," "free tool," "marketing tool," "calculator," … | [source](https://github.com/coreyhaines31/marketingskills/tree/33218ff/skills/free-tools) |
+| `social` | core | When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms, or wants to do social listening and engagement triage. Also use when the user … | [source](https://github.com/coreyhaines31/marketingskills/tree/33218ff/skills/social) |
+| `co-marketing` | core | When the user wants to find co-marketing partners, plan joint campaigns, or brainstorm partnership opportunities. Use when the user says 'co-marketing,' 'partner marketing,' 'joint campaign,' 'who should we partner with,' 'integration … | [source](https://github.com/coreyhaines31/marketingskills/tree/33218ff/skills/co-marketing) |
+| `lead-magnets` | core | When the user wants to create, plan, or optimize a lead magnet for email capture or lead generation. Also use when the user mentions "lead magnet," "gated content," "content upgrade," "downloadable," "ebook," "cheat sheet," "checklist," … | [source](https://github.com/coreyhaines31/marketingskills/tree/33218ff/skills/lead-magnets) |
+| `revops` | adjacent | When the user wants help with revenue operations, lead lifecycle management, or marketing-to-sales handoff processes. Also use when the user mentions 'RevOps,' 'revenue operations,' 'lead scoring,' 'lead routing,' 'MQL,' 'SQL,' 'pipeline … | [source](https://github.com/coreyhaines31/marketingskills/tree/33218ff/skills/revops) |
+| `image` | adjacent | When the user wants to create, generate, edit, or optimize images for marketing — blog heroes, social graphics, product mockups, profile banners, listing visuals, or brand assets. Also use when the user mentions 'AI image generation,' … | [source](https://github.com/coreyhaines31/marketingskills/tree/33218ff/skills/image) |
+| `sms` | adjacent | When the user wants to plan, build, or optimize SMS or MMS marketing — including welcome flows, abandoned cart texts, post-purchase, win-back, promotional sends, or transactional/auth SMS. Also use when the user mentions "SMS marketing," … | [source](https://github.com/coreyhaines31/marketingskills/tree/33218ff/skills/sms) |
+| `cold-email` | adjacent | Write B2B cold emails and follow-up sequences that get replies. Use when the user wants to write cold outreach emails, prospecting emails, cold email campaigns, sales development emails, or SDR emails. Also use when the user mentions "cold … | [source](https://github.com/coreyhaines31/marketingskills/tree/33218ff/skills/cold-email) |
+| `community-marketing` | adjacent | Build and leverage online communities to drive product growth and brand loyalty. Use when the user wants to create a community strategy, grow a Discord or Slack community, manage a forum or subreddit, build brand advocates, increase … | [source](https://github.com/coreyhaines31/marketingskills/tree/33218ff/skills/community-marketing) |
+| `cro` | adjacent | When the user wants to optimize, improve, or increase conversions on any marketing page or form — including homepage, landing pages, pricing pages, feature pages, lead capture forms, or contact forms. Also use when the user says 'CRO,' … | [source](https://github.com/coreyhaines31/marketingskills/tree/33218ff/skills/cro) |
+| `marketing-ideas` | adjacent | When the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the user asks for 'marketing ideas,' 'growth ideas,' 'how to market,' 'marketing strategies,' 'marketing tactics,' 'ways to … | [source](https://github.com/coreyhaines31/marketingskills/tree/33218ff/skills/marketing-ideas) |
+
+## Source: resend/resend-skills
+
+- Repository: [https://github.com/resend/resend-skills](https://github.com/resend/resend-skills) (commit `2caefff`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `agent-email-inbox` | adjacent | Use when building any system where email content triggers actions — AI agent inboxes, automated support handlers, email-to-task pipelines, or any workflow processing untrusted inbound email. Always use this skill when the user wants to … | [source](https://github.com/resend/resend-skills/tree/2caefff/skills/agent-email-inbox) |
+| `email-best-practices` | adjacent | Use when building email features, emails going to spam, high bounce rates, setting up SPF/DKIM/DMARC authentication, implementing email capture, ensuring compliance (CAN-SPAM, GDPR, CASL), handling webhooks, retry logic, making emails … | [source](https://github.com/resend/resend-skills/tree/2caefff/skills/email-best-practices) |
+| `react-email` | adjacent | Use when building HTML email templates with React components, adding a visual email editor to an application using the React Email visual editor, rendering emails to HTML, or sending emails with Resend. Covers welcome emails, password … | [source](https://github.com/resend/resend-skills/tree/2caefff/skills/react-email) |
+| `resend` | adjacent | Use when working with the Resend email API — sending transactional emails (single or batch), receiving inbound emails via webhooks, managing email templates, tracking delivery events, managing domains, contacts, broadcasts, webhooks, API … | [source](https://github.com/resend/resend-skills/tree/2caefff/skills/resend) |
+| `resend-cli` | adjacent | Operate the Resend platform from the terminal — send emails (including React Email .tsx templates via --react-email), manage domains, contacts, broadcasts, templates, webhooks, API keys, logs, automations, and events via the `resend` CLI. … | [source](https://github.com/resend/resend-skills/tree/2caefff/skills/resend-cli) |
--- a/references/market.md
+++ b/references/market.md
@@ -0,0 +1,121 @@
+# Market evidence report — promotion-assistant
+
+Source: **34 real job ads** (JSearch API, countries: us 34), extracted into the MSSQL evidence store; as of 2026-07-19.
+This report contains extracted, aggregated facts only — no ad text is
+reproduced (copyright / platform terms).
+
+## Seniority distribution
+
+| Seniority | Ads | Share |
+|---|---|---|
+| junior | 31 | 91 % |
+| n/a | 3 | 9 % |
+
+## Tools — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+| 1 | Microsoft Office | 5 | 15 % |
+| 2 | social media platforms | 3 | 9 % |
+
+## Hard skills — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+| 1 | event execution | 7 | 21 % |
+| 2 | event planning | 7 | 21 % |
+| 3 | customer engagement | 4 | 12 % |
+| 4 | equipment maintenance | 4 | 12 % |
+| 5 | event setup | 4 | 12 % |
+| 6 | event coordination | 3 | 9 % |
+| 7 | promotional activity execution | 3 | 9 % |
+
+## Methods — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+
+## Responsibilities — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+| 1 | event execution | 9 | 26 % |
+| 2 | customer engagement | 7 | 21 % |
+| 3 | brand representation | 5 | 15 % |
+| 4 | event setup | 5 | 15 % |
+| 5 | equipment setup | 4 | 12 % |
+| 6 | promotion execution | 4 | 12 % |
+| 7 | station representation | 4 | 12 % |
+| 8 | customer interaction | 3 | 9 % |
+| 9 | event assistance | 3 | 9 % |
+| 10 | listener communication | 3 | 9 % |
+
+## Regional breakdown
+
+> **Corpus note:** 34 relevant ads in total — below the 100-ad target for a fully reliable ranking. Percentages above should be read as indicative.
+
+### US (us)
+
+34 ads.
+
+**Top hard skills:**
+
+- event execution — 21 % (7 ads)
+- event planning — 21 % (7 ads)
+- customer engagement — 12 % (4 ads)
+- equipment maintenance — 12 % (4 ads)
+- event setup — 12 % (4 ads)
+- event coordination — 9 % (3 ads)
+- promotional activity execution — 9 % (3 ads)
+- audio equipment setup — 6 % (2 ads)
+- brand awareness — 6 % (2 ads)
+- brand promotion — 6 % (2 ads)
+
+**Top tools:**
+
+- Microsoft Office — 15 % (5 ads)
+- social media platforms — 9 % (3 ads)
+- Photoshop — 6 % (2 ads)
+
+**Seniority:** junior 91 % · n/a 9 %
+
+### UK (gb)
+
+**Insufficient evidence** — 0 ads (minimum for a regional ranking: 30). No ranking is reported for this region.
+
+### EU/DACH (de, at, ch, nl)
+
+**Insufficient evidence** — 0 ads (minimum for a regional ranking: 30). No ranking is reported for this region.
+
+
+## Job title variants in the market
+
+| Title | Ads |
+|---|---|
+| Promotions Assistant | 5 |
+| R1 Promotions Assistant | 4 |
+| Part-Time Promotions Assistant | 3 |
+| Entry Level Marketing Assistant at MGN Richmond, VA | 1 |
+| Entry-Level Event Promotions Assistant | No Experience Required | Paid Training | 1 |
+| Entry-Level Marketing & Promotions Specialist – On-Site | 1 |
+| Event & Promotions Assistant — Paid Training | 1 |
+| Event and Promotions Assistant - Entry Level at Smart Solutions Fairfax, VA | 1 |
+| Event Assistant (Entry-Level) | 1 |
+| Event Marketing & Promotions Assistant - Entry-Level | 1 |
+| Event Marketing & Promotions Assistant (Entry Level) | 1 |
+| Event Marketing & Promotions Associate | 1 |
+| Event Marketing Assistant | 1 |
+| Event Marketing Assistant — Hands-On Promotions & Research | 1 |
+| Event Promotions Assistant - Entry Level | 1 |
+| Event Promotions Assistant - Entry-Level | 1 |
+| Events Assistant | 1 |
+| Junior Events & Promotions Assistant - Paid Training | 1 |
+| Marketing and Promotions Assistant | 1 |
+| Marketing Promotions Assistant | Entry-Level | 1 |
+| On-Site Promotions Specialist (Part-Time) | 1 |
+| Part-Time Programming/Promotions Assistant & Radio Host at Townsquare Media Inc. Ocean City, NJ | 1 |
+| Promotions & Events Assistant | 1 |
+| Radio Promotions & Events Assistant | 1 |
+| Temporary Events & Promotions Assistant | 1 |
+
+Methodology: entities extracted per ad ({hard_skills, tools, methods, responsibilities, seniority}), normalized, counted as DISTINCT ads per entity; report threshold ≥ 3 ads. Headline sections in skills.md/tools.md use the stricter ≥ 20 % threshold.
--- a/references/profile.md
+++ b/references/profile.md
@@ -0,0 +1,21 @@
+# Occupation profile — promotion assistant
+
+- **ESCO URI:** http://data.europa.eu/esco/occupation/21af40bb-2ae3-4fc7-9b28-d2cdd8308912
+- **ESCO code:** 2431.16
+- **ISCO-08 group:** 2431 — Advertising and marketing professionals
+
+## Description (ESCO)
+
+Promotion assistants provide support in the implementation of programs and promotional efforts in points-of-sale. They research and administer all the information required by managers to decide whether promotional programs are required. If so, they support in getting of materials and resources for the promotional action.
+
+## Definition
+
+nan
+
+## Alternative labels
+
+- events and promotion assistant
+- marketing promotion assistant
+- promotions assistant
+- assistant promoter
+- promotional assistant
--- a/references/skills.md
+++ b/references/skills.md
@@ -0,0 +1,49 @@
+# Competences — promotion assistant
+
+Source: ESCO v1.2.1 occupation-skill relations (http://data.europa.eu/esco/occupation/21af40bb-2ae3-4fc7-9b28-d2cdd8308912).
+
+## Essential
+
+- **advertising techniques** (knowledge)
+- **assist in developing marketing campaigns** (skill/competence)
+- **communication principles** (knowledge)
+- **help coordinate promotional activities** (skill/competence)
+- **perform business research** (skill/competence)
+- **perform clerical duties** (skill/competence)
+- **perform office routine activities** (skill/competence)
+- **support managers** (skill/competence)
+
+## Optional
+
+- coordinate events (skill/competence)
+- create advertisements (skill/competence)
+- develop promotional tools (skill/competence)
+- ensure equipment availability (skill/competence)
+- graphic design (knowledge)
+- keep promotions records (skill/competence)
+- liaise with distribution channel managers (skill/competence)
+- manage budgets (skill/competence)
+- manage the handling of promotional materials (skill/competence)
+- meet expectations of target audience (skill/competence)
+- motion graphics (knowledge)
+- operate a camera (skill/competence)
+- perform video editing (skill/competence)
+- sales promotion techniques (knowledge)
+
+<!-- market-evidence -->
+
+## Market evidence (job-ad analysis, 34 ads, as of 2026-07-19)
+
+Share of analyzed job ads mentioning the item (threshold ≥ 20 %). Source: JSearch/Adzuna APIs.
+
+### Hard skills
+
+- event execution — **21 %**
+- event planning — **21 %**
+
+### Responsibilities
+
+- event execution — **26 %**
+- customer engagement — **21 %**
+
+<!-- market-evidence -->
--- a/references/tasks.md
+++ b/references/tasks.md
@@ -0,0 +1,34 @@
+# Tasks & work activities — promotion assistant
+
+Source: O*NET 30.3, occupation 13-1161.00 (Market Research Analysts and Marketing Specialists) — manual nearest-occupation mapping via ISCO group 2431; the official ESCO crosswalk has no entry for this ESCO occupation.
+
+## Task statements
+
+- **[Core]** Collect and analyze data on customer demographics, preferences, needs, and buying habits to identify potential markets and factors affecting product demand.
+- **[Core]** Prepare reports of findings, illustrating data graphically and translating complex findings into written text.
+- **[Core]** Measure and assess customer and employee satisfaction.
+- **[Core]** Forecast and track marketing and sales trends, analyzing collected data.
+- **[Core]** Seek and provide information to help companies determine their position in the marketplace.
+- **[Core]** Measure the effectiveness of marketing, advertising, and communications programs and strategies.
+- **[Core]** Conduct research on consumer opinions and marketing strategies, collaborating with marketing professionals, statisticians, pollsters, and other professionals.
+- **[Core]** Attend staff conferences to provide management with information and proposals concerning the promotion, distribution, design, and pricing of company products or services.
+- **[Core]** Gather data on competitors and analyze their prices, sales, and method of marketing and distribution.
+- **[Core]** Monitor industry statistics and follow trends in trade literature.
+- **[Core]** Devise and evaluate methods and procedures for collecting data, such as surveys, opinion polls, or questionnaires, or arrange to obtain existing data.
+- **[Core]** Develop and implement procedures for identifying advertising needs.
+- **[Core]** Direct trained survey interviewers.
+
+## Detailed work activities
+
+- Analyze consumer trends.
+- Analyze industry trends.
+- Analyze market conditions or trends.
+- Conduct surveys in organizations.
+- Develop business or market strategies.
+- Discuss business strategies, practices, or policies with managers.
+- Establish business management methods.
+- Gather organizational performance information.
+- Measure effectiveness of business strategies or practices.
+- Monitor business indicators.
+- Prepare research reports.
+- Supervise employees.
--- a/references/tools.md
+++ b/references/tools.md
@@ -0,0 +1,155 @@
+# Tools & technology — promotion assistant
+
+Source: O*NET 30.3, occupation 13-1161.00 (Market Research Analysts and Marketing Specialists) — manual nearest-occupation mapping via ISCO group 2431; the official ESCO crosswalk has no entry for this ESCO occupation.
+
+| Software | Category | Hot technology |
+|---|---|---|
+| Adobe Acrobat | Document management software | yes |
+| Adobe After Effects | Video creation and editing software | yes |
+| Adobe Creative Cloud software | Graphics or photo imaging software | yes |
+| Adobe Illustrator | Graphics or photo imaging software | yes |
+| Adobe InDesign | Desktop publishing software | yes |
+| Adobe Photoshop | Graphics or photo imaging software | yes |
+| Amazon Redshift | Data base user interface and query software | yes |
+| Apache Hadoop | Data base management system software | yes |
+| Apache Hive | Data base management system software | yes |
+| Apple macOS | Operating system software | yes |
+| Asana | Cloud-based data access and sharing software | yes |
+| Canva | Graphics or photo imaging software | yes |
+| Cascading style sheets CSS | Web platform development software | yes |
+| ESRI ArcGIS software | Geographic information system | yes |
+| Facebook | Web page creation and editing software | yes |
+| Google Analytics | Data mining software | yes |
+| Google Docs | Word processing software | yes |
+| Google Looker Analytics | Business intelligence and data analysis software | yes |
+| HubSpot software | Sales and marketing software | yes |
+| Hypertext markup language HTML | Web platform development software | yes |
+| IBM SPSS Statistics | Analytical or scientific software | yes |
+| JavaScript | Web platform development software | yes |
+| Marketo Marketing Automation | Sales and marketing software | yes |
+| Microsoft Access | Data base user interface and query software | yes |
+| Microsoft Excel | Spreadsheet software | yes |
+| Microsoft Office software | Office suite software | yes |
+| Microsoft Outlook | Electronic mail software | yes |
+| Microsoft PowerPoint | Presentation software | yes |
+| Microsoft Project | Project management software | yes |
+| Microsoft SharePoint | Document management software | yes |
+| Microsoft SQL Server | Data base user interface and query software | yes |
+| Microsoft Visio | Process mapping and design software | yes |
+| Microsoft Visual Basic | Development environment software | yes |
+| Microsoft Visual Basic for Applications VBA | Development environment software | yes |
+| Microsoft Word | Word processing software | yes |
+| MySQL | Data base user interface and query software | yes |
+| Oracle PeopleSoft | Enterprise resource planning ERP software | yes |
+| PHP | Web platform development software | yes |
+| R | Object or component oriented development software | yes |
+| Red Hat Enterprise Linux | Operating system software | yes |
+| Salesforce software | Customer relationship management CRM software | yes |
+| SAP software | Enterprise resource planning ERP software | yes |
+| SAS | Analytical or scientific software | yes |
+| Slack | Cloud-based data access and sharing software | yes |
+| Structured query language SQL | Data base user interface and query software | yes |
+| Tableau | Business intelligence and data analysis software | yes |
+| Teradata Database | Data base management system software | yes |
+| The MathWorks MATLAB | Analytical or scientific software | yes |
+| TikTok | Video creation and editing software | yes |
+| WordPress | Web page creation and editing software | yes |
+| Zoom | Video conferencing software | yes |
+| 3M Post-it App | Word processing software |  |
+| AcaStat Software | Analytical or scientific software |  |
+| Act! | Customer relationship management CRM software |  |
+| Adaptive conjoint analysis ACA software | Analytical or scientific software |  |
+| Adobe ActionScript | Development environment software |  |
+| Adobe Dreamweaver | Web page creation and editing software |  |
+| Adxstudio, for Microsoft | Content workflow software |  |
+| Airtable | Data base user interface and query software |  |
+| AndersonBell Abstat | Analytical or scientific software |  |
+| Apache Pig | Data base management system software |  |
+| Apple Final Cut Pro | Video creation and editing software |  |
+| Apple Keynote | Presentation software |  |
+| Aprimo Marketing | Enterprise resource planning ERP software |  |
+| Basecamp | Project management software |  |
+| Blackbaud The Raiser's Edge | Customer relationship management CRM software |  |
+| ClassApps SelectSurveyASP | Project management software |  |
+| Cytel LogXact | Analytical or scientific software |  |
+| Cytel Software XLMiner | Data mining software |  |
+| Data analysis software | Analytical or scientific software |  |
+| Database software | Data base user interface and query software |  |
+| Delphi Technology | Financial analysis software |  |
+| Digivey software (expert system feature) | Expert system software |  |
+| Digivey software (point of sale feature) | Point of sale POS software |  |
+| Dropbox | Cloud-based data access and sharing software |  |
+| Drupal | Web platform development software |  |
+| Dynamic hypertext markup language DHTML | Web platform development software |  |
+| Evernote | Word processing software |  |
+| Extensible hypertext markup language XHTML | Web platform development software |  |
+| Factiva | Information retrieval or search software |  |
+| FedBizOps | Information retrieval or search software |  |
+| FileMaker Pro | Data base user interface and query software |  |
+| Financial planning software | Financial analysis software |  |
+| Galilee Enterprise TargetPro | Customer relationship management CRM software |  |
+| Geographic information system GIS marketing software | Data base user interface and query software |  |
+| GLOBE Claritas | Analytical or scientific software |  |
+| GMI NET-MR | Data base user interface and query software |  |
+| Google Ads | Sales and marketing software |  |
+| Google Drive | Cloud-based data access and sharing software |  |
+| Google Slides | Presentation software |  |
+| GroupMe | Instant messaging software |  |
+| IBM Cognos Impromptu | Business intelligence and data analysis software |  |
+| IBM Information Management System (IMS) | Data base user interface and query software |  |
+| IBM Intelligent Miner | Data mining software |  |
+| IBM Notes | Electronic mail software |  |
+| Insightful Corporation Confirmit | Customer relationship management CRM software |  |
+| Insightful S-PLUS | Analytical or scientific software |  |
+| Instagram | Web page creation and editing software |  |
+| Intellimed | Data base user interface and query software |  |
+| LexisNexis | Information retrieval or search software |  |
+| LinkedIn | Web page creation and editing software |  |
+| LogiXML Ad-HOC | Desktop publishing software |  |
+| LogMeIn GoToMeeting | Video conferencing software |  |
+| LogMeIn GoToWebinar | Network conferencing software |  |
+| Loom | Video creation and editing software |  |
+| Map Maker | Categorization or classification software |  |
+| Medstat/INFORUM | Information retrieval or search software |  |
+| Microsoft Dynamics | Enterprise resource planning ERP software |  |
+| Microsoft Publisher | Desktop publishing software |  |
+| MicroStrategy | Business intelligence and data analysis software |  |
+| Minitab | Analytical or scientific software |  |
+| Mintel Reports | Information retrieval or search software |  |
+| NCR Teradata Warehouse Miner | Data mining software |  |
+| Neoforma Healthcare Products Information Services HPIS Market Intelligence | Information retrieval or search software |  |
+| NetSuite ERP | Enterprise resource planning ERP software |  |
+| NortonLifeLock cybersecurity software | Transaction security and virus protection software |  |
+| Oracle Business Intelligence Enterprise Edition | Business intelligence and data analysis software |  |
+| Oracle Darwin | Data mining software |  |
+| Oracle Eloqua | Customer relationship management CRM software |  |
+| Oracle Hyperion | Enterprise resource planning ERP software |  |
+| Palisade StatTools | Analytical or scientific software |  |
+| Perseus SurveySolutions | Project management software |  |
+| Provalis Research Simstat | Analytical or scientific software |  |
+| Qlik Tech QlikView | Business intelligence and data analysis software |  |
+| SAP Business Objects | Enterprise resource planning ERP software |  |
+| SAP Crystal Reports | Data base reporting software |  |
+| Sawtooth Choice-Base Conjoint CBS | Analytical or scientific software |  |
+| Sawtooth Composite Product Mapping CPM | Analytical or scientific software |  |
+| Sawtooth SSI Web | Desktop publishing software |  |
+| SmugMug Flickr | Graphics or photo imaging software |  |
+| Social media sites | Web page creation and editing software |  |
+| StataCorp Stata | Analytical or scientific software |  |
+| StatPac | Analytical or scientific software |  |
+| Survey software | Analytical or scientific software |  |
+| TechExcel ServiceWise | Customer relationship management CRM software |  |
+| Thomson Dialog | Graphics or photo imaging software |  |
+| Thomson Financial Investext | Information retrieval or search software |  |
+| TNS MarketWhys | Analytical or scientific software |  |
+| TNS Miriad | Analytical or scientific software |  |
+| TranspoLink BidLeads | Data base user interface and query software |  |
+| UNISTAT Statistical Package | Analytical or scientific software |  |
+| Vantage MCIF | Customer relationship management CRM software |  |
+| Verispan Patient Parameters | Information retrieval or search software |  |
+| Walmart Retail Link | Information retrieval or search software |  |
+| Web browser software | Internet browser software |  |
+| WeVideo | Video creation and editing software |  |
+| WinCross | Analytical or scientific software |  |
+| WorldAPP KeySurvey Suite | Data base user interface and query software |  |
+| YouTube | Video creation and editing software |  |