---
name: ellmos-ai/community-outreach
source: https://app.decimal.ai/s/ellmos-ai-community-outreach@1/SKILL.md
source_sha256: 99ea54eeebfc
---

<img src="banner.png" width="100%" alt="community-outreach banner">

# Community Outreach & Solution Recommender

Ein anbieter-, LLM- und betriebssystemneutraler Skill zur automatisierten, lösungsorientierten Vorstellung von Open-Source-Software, Repositories und Werkzeugen in Entwickler-Communities, Reddit-Threads, Foren und Videokommentaren.

---

## 🌟 Kernprinzipien & Sicherheits-Garantien

1. **Human-in-the-Loop & EU AI Act Konformität:**
   * Kein automatischer Post geht ohne menschliche Sichtung live.
   * Entwürfe werden in `POST-EINGANG.md` vorgelegt. Erst durch das Setzen des Häkchens `- [x] Genehmigt` wird der Beitrag zum Veröffentlichen freigegeben.
2. **Anti-Spam & 100% Relevanz („Lieber kein Post als ein unpassender“):**
   * Jeder Post löst ein konkret im Ziel-Thread formuliertes technisches Problem.
   * Strikte Beachtung der jeweiligen Community- und Plattformregeln (keine Schleichwerbung, transparente Nennung als Autor/Maintainer).
3. **Strikter Duplikatschutz:**
   * Globales `POSTVERZEICHNIS.md` protokolliert jede bespielte Ziel-URL.
   * Kein Thread oder Video wird jemals doppelt adressiert.
4. **Fair Round-Robin & Plattform-Rotation:**
   * Projekte werden nach längster Abstinenz rotiert (jedes Repo kommt gleichmäßig zum Zug).
   * Plattformen werden abgewechselt (Reddit $\rightarrow$ YouTube $\rightarrow$ Dev.to / Fachforen $\rightarrow$ Reddit).
5. **Cut-and-Clue Selbstarchivierung:**
   * Historische Postausgänge werden bei Erreichen einer Größengrenze automatisch nach `_archive/` ausgelagert und im Header referenziert.

---

## 📂 Standard-Infrastruktur

Der Skill baut in einem Ziel-Verzeichnis (`<workspace_root>/.COMMUNITY_OUTREACH/` o. ä.) folgende modulare Struktur auf:

| Datei | Zweck |
| :--- | :--- |
| `USECASES.md` | Übersicht aller Repositories, deren Usecases und gelöster Zielprobleme |
| `usecases.json` | Maschinenlesbare Rotations-Datenbank mit Zeitstempeln und Metadaten |
| `POST-EINGANG.md` | Human-in-the-Loop Genehmigungs-Queue mit `- [ ] Genehmigt` Checkboxen |
| `POST-AUSGANG.md` | Monitoring veröffentlichter Beiträge und Inbound-Community-Feedback |
| `POSTVERZEICHNIS.md` | Globaler URL- und Thread-Duplikatschutz-Index |
| `ACCOUNTVERZEICHNIS.md` | Übersicht autorisierter Profile und SSO-Login-Mechanismen |
| `config.json` | Instanz-Konfiguration (Repos, Frequenzen, Zielplattformen) |

---

## 🔄 Der 4-Phasen-Laufzyklus

```mermaid
flowchart TD
    A[Start Laufzyklus] --> B[Phase 1: Inbound Check auf Feedback]
    B --> C[Phase 2: Outbound Execution für freigegebene Posts]
    C --> D[Phase 3: Research & Staging für nächstes Repo]
    D --> E[Phase 4: Cut & Clue Selbstarchivierung]
    E --> F[Abschluss & Logging]
```

1. **Phase 1 (Inbound Feedback Check):** Prüft aktive Threads in `POST-AUSGANG.md` auf Community-Rückfragen oder Feedback.
2. **Phase 2 (Outbound Execution):** Sucht in `POST-EINGANG.md` nach freigegebenen Einträgen (`- [x] Genehmigt`), setzt diese über den Browser ab, verschiebt sie nach `POST-AUSGANG.md` und registriert die URL in `POSTVERZEICHNIS.md`.
3. **Phase 3 (Research & Staging):** Wählt via Fair Round-Robin das am längsten nicht bespielte Repo aus, recherchiert nach echten aktuellen Problemstellungen im Netz, formuliert einen passgenauen Lösungsvorschlag und legt ihn als `- [ ] Genehmigt` in `POST-EINGANG.md` ab.
4. **Phase 4 (Selbstarchivierung):** Archiviert überlaufende Dateien automatisch nach `_archive/` mit Rückwärts-Pointern.

---

## ⚙️ Multi-Scheduler & Multi-Agent Betrieb

Der Skill unterstützt alle gängigen Scheduler- und Agentenumgebungen:

### 1. Antigravity Sidecar / Scheduled Task
Wird als nativer Sidecar in `.gemini/config/sidecars/community-outreach/sidecar.json` registriert.
* **Vorteil:** Läuft nur bei geöffneter App, vollständige Kontrolle im GUI-Dashboard.
* **Frequenz:** z. B. 1x täglich (`0 10 * * *`) oder 4x täglich (`0 8,12,16,20 * * *`).

### 2. Codex & Claude Code Scheduled Task / Cron
* Registrierung über System-Cron (`crontab -e`) oder Task-Runner:
  ```bash
  python scripts/outreach_engine.py --full-run
  ```

### 3. Windows Task Scheduler (`schtasks`)
* Optional für autarke OS-Hintergrundausführung:
  ```powershell
  python scripts/setup_scheduler.py --backend windows --schedule daily --time 09:00
  ```

### 4. ellmos-scheduler / Universelle Daemon-Schleife
* Systemweiter Daemon für Multi-Agenten-Setups:
  ```bash
  python scripts/setup_scheduler.py --backend ellmos --interval 86400
  ```

---

## 📋 Schnellstart (Bootstrap)

1. **Workspace initialisieren:**
   ```bash
   python scripts/init_outreach_workspace.py --target-dir ./outreach_data --repo-list ./repos.json
   ```
2. **Testlauf durchführen (Dry-Run):**
   ```bash
   python scripts/outreach_engine.py --workspace ./outreach_data --dry-run
   ```
3. **Scheduler aktivieren:**
   ```bash
   python scripts/setup_scheduler.py --backend antigravity --workspace ./outreach_data
   ```

---

## 🔒 Private / Lokale Konfiguration

Spezifische Pfade, Anmeldedaten und persönliche SSO-Profile werden in `config.private.json` oder `.env` gespeichert. Diese Dateien sind per `.gitignore` ausgeschlossen und gelangen niemals in öffentliche Repositories.

---

## Changelog

### 1.0.0 (2026-08-13)
- Initiales Release: Universeller Community Outreach & Solution Recommender Skill.
- 4-Phasen-Engine mit Human-in-the-Loop, Duplikatschutz, Fair-Round-Robin und Cut-and-Clue Archivierung.
- Multi-Scheduler Support (Antigravity, Windows Task Scheduler, Cron, ellmos-scheduler, Codex, Claude Code).