Awesome-omni-skill content-publisher

Autonomous content creation, review, and multi-platform publishing for ACT ecosystem. Includes Empathy Ledger Content Hub for photography, videography, and storytelling with AI-powered tagging and ecosystem syndication.

install

source · Clone the upstream repo

git clone https://github.com/diegosouzapw/awesome-omni-skill

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/content-media/content-publisher" ~/.claude/skills/diegosouzapw-awesome-omni-skill-content-publisher && rm -rf "$T"

manifest: skills/content-media/content-publisher/SKILL.md

source content

Content Publisher - ACT Communications Automation

Empathy Ledger Content Hub (NEW)

Empathy Ledger serves as the central content hub for the ACT ecosystem - photography, videography, writing, and storytelling with intelligent tagging and API-driven syndication.

Content Hub Architecture

┌─────────────────────────────────────────────────────────────────────┐
│                    CONTENT SOURCES                                   │
│  • Your photography and videography                                  │
│  • Storyteller contributions                                         │
│  • ACT project milestones                                           │
│  • Ralph-generated content                                          │
└────────────────────────────┬────────────────────────────────────────┘
                             ↓
┌─────────────────────────────────────────────────────────────────────┐
│              EMPATHY LEDGER CONTENT HUB                              │
│                                                                      │
│  ┌─────────────────────────────────────────────────────────────┐    │
│  │ MEDIA INTELLIGENCE (Consent-Gated)                           │    │
│  │ • Auto-tag objects/scenes in photos (Claude Vision)          │    │
│  │ • Face recognition → link to storyteller profiles            │    │
│  │ • Theme extraction → narrative connections                   │    │
│  │ • ALMA integration (interventions, evidence)                 │    │
│  └─────────────────────────────────────────────────────────────┘    │
│                                                                      │
│  ┌─────────────────────────────────────────────────────────────┐    │
│  │ THREE-TIER VISIBILITY                                        │    │
│  │ • Private: Storyteller only                                  │    │
│  │ • Community: ACT ecosystem + approved partners               │    │
│  │ • Public: Anyone with attribution                            │    │
│  └─────────────────────────────────────────────────────────────┘    │
│                                                                      │
│  ┌─────────────────────────────────────────────────────────────┐    │
│  │ CONTENT SYNDICATION API                                      │    │
│  │ • GET /api/v1/content-hub/stories                           │    │
│  │ • GET /api/v1/content-hub/articles                          │    │
│  │ • GET /api/v1/content-hub/media/library                     │    │
│  │ • GET /api/v1/content-hub/themes                            │    │
│  │ • POST /api/v1/content-hub/syndicate                        │    │
│  └─────────────────────────────────────────────────────────────┘    │
└────────────────────────────┬────────────────────────────────────────┘
                             ↓
┌─────────────────────────────────────────────────────────────────────┐
│                    DISTRIBUTION                                      │
│                                                                      │
│  ACT Projects (via API)          External Users           Social    │
│  • JusticeHub                    • Partner orgs           • GHL     │
│  • ACT Farm                      • Researchers            • Social  │
│  • The Harvest                   • Media                  • Posts   │
│  • Goods on Country                                                 │
│  • ACT Placemat                                                     │
└─────────────────────────────────────────────────────────────────────┘

Content Hub Database Tables

Table	Purpose
`media_ai_analysis`	Smart photo/video tagging (consent-gated)
`media_person_recognition`	Face recognition with two-party consent
`media_narrative_themes`	Theme extraction and story linking
`articles`	Blog/article content for syndication
`content_syndication`	Track content distribution

Media Intelligence Pipeline

// Photo analysis with consent gate
import { createPhotoAnalyzer } from './lib/media-intelligence/photo-analyzer';

const analyzer = createPhotoAnalyzer();

// 1. Grant consent (REQUIRED before any AI analysis)
await analyzer.grantConsent(mediaAssetId, storytellerId, grantedBy);

// 2. Analyze photo
const result = await analyzer.analyzePhoto({
  mediaAssetId,
  storytellerId,
  imageUrl,
  consentGranted: true
});

// Result includes:
// - detectedObjects: [{label, confidence}]
// - sceneClassification: 'portrait' | 'ceremony' | etc.
// - autoTags: ['community', 'gathering', ...]
// - culturalReviewRequired: boolean
// - emotionalTone: 'hopeful' | 'reflective' | etc.

Face Recognition (Two-Party Consent)

import { createFaceRecognition } from './lib/media-intelligence/face-recognition';

const faces = createFaceRecognition();

// Step 1: Uploader grants consent
await faces.grantUploaderConsent(recognitionId, uploaderId);

// Step 2: Person in photo grants consent
await faces.grantPersonConsent(recognitionId, storytellerId, personId, canBePublic);

// Only after BOTH consents can identity be linked

Content Hub API Reference

Endpoint	Method	Description
`/api/v1/content-hub/stories`	GET	List published stories
`/api/v1/content-hub/stories/:id`	GET	Single story with full content
`/api/v1/content-hub/articles`	GET	List published articles
`/api/v1/content-hub/articles/:slug`	GET	Single article by slug
`/api/v1/content-hub/media/library`	GET	Browse media library
`/api/v1/content-hub/themes`	GET	Discover content by themes
`/api/v1/content-hub/search`	GET	Full-text search
`/api/v1/content-hub/syndicate`	POST	Register syndication

Content Hub File References

Need	Reference
Database migration	`empathy-ledger-v2/supabase/migrations/20260109000001_content_hub_schema.sql`
Photo analyzer	`references/photo-analyzer.ts`
Face recognition	`references/face-recognition.ts`
Theme extractor	`references/theme-extractor.ts`
Syndication API	`references/content-syndication-api.ts`

When to Use

Creating social media content from project milestones
Generating posts from Ralph PRD completions
Publishing approved content to social platforms
Checking content sync status
Generating content ideas from ecosystem activity

Quick Commands

Command	Description
`generate <topic>`	Create draft post from ecosystem knowledge
`sync`	Sync all sources (Notion + Empathy Ledger) to GHL
`sync --notion-only`	Sync only Notion content to GHL
`sync --empathy-only`	Sync only Empathy Ledger content to GHL
`status`	Check publishing pipeline status
`schedule <date>`	Schedule content for specific date
`ideas`	Generate post ideas from recent activity

Content Flow

┌─────────────────────────────────────────────────────┐
│  1. CONTENT SOURCES                                  │
│  • Ralph PRD completions → auto-generate posts       │
│  • Sprint milestones → project updates               │
│  • Codebase commits → technical insights             │
│  • Brand alignment skill → voice/tone check          │
│  • Empathy Ledger articles & stories (NEW)          │
└─────────────────────┬───────────────────────────────┘
                      ↓
┌─────────────────────────────────────────────────────┐
│  2A. NOTION CONTENT HUB                              │
│  Database: e400e93e-fd9d-4a21-810c-58d67ed9fe97     │
│                                                      │
│  Status Flow:                                        │
│  Story in Development → Ready to Connect →           │
│  Conversation Scheduled → Connected & Delighted      │
└─────────────────────┬───────────────────────────────┘
                      │
┌─────────────────────┴───────────────────────────────┐
│  2B. EMPATHY LEDGER CONTENT HUB                      │
│  URL: EMPATHY_LEDGER_URL (default: localhost:3000)  │
│                                                      │
│  Status Flow:                                        │
│  Draft → In Review → Elder Review → Published        │
│                                                      │
│  Article Types:                                      │
│  • story_feature, program_spotlight                  │
│  • research_summary, community_news                  │
│  • editorial, impact_report                          │
│                                                      │
│  Stories with syndication_enabled = true             │
└─────────────────────┬───────────────────────────────┘
                      ↓
┌─────────────────────────────────────────────────────┐
│  3. GHL PUBLISHING                                   │
│  Script: scripts/sync-content-to-ghl.mjs            │
│                                                      │
│  Syncs from BOTH sources automatically:              │
│  • Notion "Ready to Connect" items                   │
│  • Empathy Ledger published articles/stories         │
│                                                      │
│  Connected Accounts:                                 │
│  • LinkedIn (Company) - A Curious Tractor           │
│  • LinkedIn (Personal) - Benjamin Knight            │
│  • YouTube - A Curious Tractor                      │
│  • Google Business Profile                          │
│  • Bluesky - A Curious Tractor                      │
│                                                      │
│  View engagement: GHL Dashboard → Social Planner    │
└─────────────────────────────────────────────────────┘

Target Accounts

Account	Env Variable	Best For
LinkedIn (Company)	`GHL_LINKEDIN_ACCOUNT_ID`	Professional updates, milestones
LinkedIn (Personal)	`GHL_LINKEDIN_PERSONAL_ID`	Personal stories, reflections
YouTube	`GHL_YOUTUBE_ACCOUNT_ID`	Video announcements
Google Business	`GHL_GBP_ACCOUNT_ID`	Local updates, events
Bluesky	`GHL_BLUESKY_ACCOUNT_ID`	Tech community, open source

Content Generation

From Ralph Completions

When Ralph completes a PRD feature, auto-generate announcement:

// Read ralph/progress.txt for recent completions
// Generate post using act-brand-alignment voice
// Create in Notion with "Story in Development" status

From Sprint Milestones

Query sprint tracking for completed items, generate weekly digest.

From Ecosystem Activity

Scan all 7 project codebases for:

New releases/tags
Significant commits
Documentation updates
Test coverage improvements

Publishing Commands

Sync All Sources (Notion + Empathy Ledger)

node scripts/sync-content-to-ghl.mjs

Sync Only Notion

node scripts/sync-content-to-ghl.mjs --notion-only

Sync Only Empathy Ledger

node scripts/sync-content-to-ghl.mjs --empathy-only

Dry Run (Preview)

node scripts/sync-content-to-ghl.mjs --dry-run

Check Status

node scripts/sync-content-to-ghl.mjs --status

Check GHL Posts

node scripts/check-ghl-engagement.mjs

Brand Alignment Integration

Always invoke

act-brand-alignment

skill before publishing to ensure:

Farm metaphors (seeds, harvest, cultivating)
Community ownership language
No savior framing
Proper voice/tone

Notion API Notes

API Version: 2025-09-03
Endpoint:
```
/data_sources/{id}/query
```
(not
```
/databases/
```
)
Create pages: Use database ID
```
7005d0d1-41d3-436c-9f86-526d275c2f10
```
Query content: Use data source ID
```
e400e93e-fd9d-4a21-810c-58d67ed9fe97
```

Automated Content Pipeline

Full Workflow

┌─────────────────────────────────────────────────────────────┐
│  1. AGGREGATE ECOSYSTEM KNOWLEDGE                            │
│     node scripts/aggregate-ecosystem-knowledge.mjs           │
│                                                              │
│  Scans: Git activity, Ralph progress, Notion sprints,       │
│         Documentation updates, Deployments                   │
└─────────────────────┬───────────────────────────────────────┘
                      ↓
┌─────────────────────────────────────────────────────────────┐
│  2. GENERATE CONTENT                                         │
│     node scripts/generate-content-from-knowledge.mjs         │
│                                                              │
│  Types: weekly-activity, feature-shipped, sprint-milestone,  │
│         technical-insight, project-spotlight                 │
│                                                              │
│  Output: Drafts in Notion with "Story in Development"       │
└─────────────────────┬───────────────────────────────────────┘
                      ↓
┌─────────────────────────────────────────────────────────────┐
│  3. HUMAN REVIEW (Notion)                                    │
│     Edit content, add images, approve                        │
│     Change status to "Ready to Connect"                      │
└─────────────────────┬───────────────────────────────────────┘
                      ↓
┌─────────────────────────────────────────────────────────────┐
│  4. PUBLISH                                                  │
│     node scripts/sync-content-to-ghl.mjs                    │
│                                                              │
│  Auto-syncs approved content to social platforms             │
└─────────────────────────────────────────────────────────────┘

Quick Commands

# Generate content drafts from ecosystem knowledge
node scripts/generate-content-from-knowledge.mjs

# Preview without creating (dry run)
node scripts/generate-content-from-knowledge.mjs --dry-run

# Generate specific type
node scripts/generate-content-from-knowledge.mjs --type weekly-activity

# Sync approved content to social
node scripts/sync-content-to-ghl.mjs

# Check status
node scripts/sync-content-to-ghl.mjs --status

# Ralph content runner (combines all)
./ralph/ralph-content.sh

Content Types

Type	Description	Best Accounts
`weekly-activity`	Ecosystem commit summary	LinkedIn (Company)
`feature-shipped`	Ralph completion announcement	Both LinkedIn
`sprint-milestone`	Sprint progress update	LinkedIn (Company)
`technical-insight`	Technical learnings	LinkedIn (Personal)
`project-spotlight`	Project deep dive	Both LinkedIn

Automated Schedule (GitHub Actions)

Schedule	Action
Sunday 10pm UTC (Monday 8am AEST)	Generate weekly content
Every 4 hours	Sync approved content to GHL

Trigger manually: Actions → Content Pipeline → Run workflow

Media Handling

Media Service

import { createMediaService } from './scripts/lib/media-service.mjs';

const media = createMediaService();

// Get brand asset
const logoUrl = media.getBrandAsset('logo');

// Get project hero image
const heroUrl = media.getProjectAsset('JusticeHub');

// Upload local file
const result = await media.uploadFile('./image.png');

// Suggest image from content
const suggestion = media.suggestImage('Building ecosystem together');

Media Storage

Supabase:

tednluwflfhxyucgwigh.supabase.co/storage/v1/object/public/content-media/

Brand assets:
```
brand/
```
folder
Project assets:
```
projects/
```
folder
Uploads:
```
uploads/
```
folder

Image Recommendations

Content generation auto-suggests images:

Project mentions → Project hero image
Growth/seeds keywords → Pattern asset
Community keywords → Cockatoo asset
Default → ACT logo

For custom images:

Upload to Supabase storage
Add URL to Notion "Image" field or "Notes"
GHL will use the URL when publishing

File References

Need	Reference
Content generation	`scripts/generate-content-from-knowledge.mjs`
Knowledge aggregator	`scripts/aggregate-ecosystem-knowledge.mjs`
Media service	`scripts/lib/media-service.mjs`
Sync script	`scripts/sync-content-to-ghl.mjs`
GHL social service	`scripts/lib/ghl-social-service.mjs`
Empathy Ledger service	`scripts/lib/empathy-ledger-content.mjs`
Content PRD template	`ralph/content-prd-template.json`
Ralph content runner	`ralph/ralph-content.sh`
GitHub Action	`.github/workflows/content-pipeline.yml`
Notion database IDs	`config/notion-database-ids.json`
Post creation template	`references/post-template.mjs`
Content ideas generator	`references/content-ideas.md`

Empathy Ledger Environment Variables

Variable	Description	Default
`EMPATHY_LEDGER_URL`	Empathy Ledger API base URL	`http://localhost:3000`
`CONTENT_HUB_API_KEY`	API key for Content Hub access	Auto-generated

Empathy Ledger Content Fetcher API

import { createEmpathyLedgerService } from './lib/empathy-ledger-content.mjs';

const el = createEmpathyLedgerService({
  baseUrl: 'https://empathyledger.com',
  apiKey: process.env.CONTENT_HUB_API_KEY
});

// Get published articles
const articles = await el.getArticles({ type: 'story_feature', limit: 10 });

// Get public stories
const stories = await el.getStories({ visibility: 'public', limit: 20 });

// Get content ready for GHL sync
const content = await el.getContentForGHLSync();
// Returns: { articles: [...], stories: [...], total: N }

// Transform to GHL post format
const ghlPost = el.articleToGHLPost(article, { accountIds: [...] });

// Register syndication
await el.registerSyndication({
  contentType: 'article',
  contentId: article.id,
  destinationType: 'ghl_social',
  ghlPostId: 'xxx'
});

// Health check
const health = await el.healthCheck();
// Returns: { healthy: true, baseUrl, articlesAvailable }