Skip to content
Back to search

video-to-social-marketplace

AI-powered Claude Code skill that turns YouTube videos into viral-ready Shorts with automatic highlight detection, video editing, subtitles, and social media publishing via Publora MCP.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 20 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/aleenafarizkhan/claude-video-to-social-skill with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/aleenafarizkhan/claude-video-to-social-skill'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/aleenafarizkhan--claude-video-to-social-skill/badge.svg)](/listings/aleenafarizkhan--claude-video-to-social-skill)

HTML

<a href="/listings/aleenafarizkhan--claude-video-to-social-skill"><img src="/api/listings/aleenafarizkhan--claude-video-to-social-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 13 lines
  1. {
  2. "name": "video-to-social-marketplace",
  3. "owner": {
  4. "name": "aleenafarizkhan"
  5. },
  6. "plugins": [
  7. {
  8. "name": "video-to-social",
  9. "source": "./",
  10. "description": "Shorts/Reels generation and Publora MCP posting"
  11. }
  12. ]
  13. }
README.md · README · 75 lines
  1. # Video to Social — Claude Code Plugin
  2. **Author:** aleenafarizkhan
  3. A standalone Claude Code plugin for turning authorized videos into captioned short-form clips and managing publishing workflows through Publora MCP. This is an independent project and is not affiliated with Publora.
  4. ## Choose your skill
  5. Both skills are installed side-by-side and work independently:
  6. | Skill | When to use | Command |
  7. | --- | --- | --- |
  8. | `video-to-social` | General Shorts + captions + optional Publora drafts/posts | `python scripts/pipeline.py ...` |
  9. | `video-to-shorts-cutter` | Gameplay-focused full-screen crop with adjustable character offset, no blur, optional hook and captions | `python scripts/shorts_cutter.py ...` |
  10. Choose explicitly in Claude Code: **“Use video-to-shorts-cutter”** or **“Use video-to-social”**. Use Publora publishing instructions from `video-to-social` for either skill when requested and authorized.
  11. Example cutter commands:
  12. ```bash
  13. python scripts/shorts_cutter.py "my-gameplay.mp4" --start 20 --end 50 --mode character --crop-x 300 --hook "EPIC MOMENT"
  14. python scripts/shorts_cutter.py "https://youtu.be/VIDEO_ID" --count 3 --mode character
  15. ```
  16. The cutter's crop offset is static, not AI character tracking; verify framing on every source.
  17. ## Features
  18. - Paste an authorized public YouTube URL or a local video path
  19. - Whisper speech transcription with word timestamps
  20. - Heuristic highlight detection and candidate ranking
  21. - 1080×1920 9:16 FFmpeg center-crop exports with burned subtitles
  22. - Manifest with clip timestamps, rough hooks and captions
  23. - Claude Code skill orchestrates draft / upload / scheduling via the **official hosted Publora MCP**
  24. - Default **review first**; no unapproved automatic publishing
  25. ## Prerequisites
  26. Python 3.10+, FFmpeg/ffprobe and a Publora account with social connections. `yt-dlp` can only fetch content allowed by platform access and terms. First Whisper model run downloads weights; internet is necessary. Performance depends on hardware, language, video resolution and link availability.
  27. ```bash
  28. python -m venv .venv
  29. # Linux/macOS:
  30. source .venv/bin/activate
  31. # Windows PowerShell:
  32. # .venv\\Scripts\\Activate.ps1
  33. pip install -r requirements.txt
  34. ffmpeg -version
  35. claude mcp add --transport http --scope user publora https://mcp.publora.com/mcp
  36. # In Claude Code use /mcp -> publora -> Authenticate
  37. ```
  38. Install as a Claude Code plugin from a locally available marketplace directory:
  39. ```text
  40. /plugin marketplace add /absolute/path/to/video-to-social-skill
  41. /plugin install video-to-social@video-to-social-marketplace
  42. ```
  43. Or put the `skills/video-to-social/SKILL.md` skill into your Claude Code project skills directory and ask Claude to use it.
  44. ## Run just the local pipeline
  45. ```bash
  46. python scripts/pipeline.py 'https://youtu.be/VIDEO_ID' --output output/demo --count 3 --clip-length 35
  47. python scripts/pipeline.py '/path/to/owned-video.mp4' --output output/demo
  48. ```
  49. Produced: `output/demo/manifest.json`, `transcript.json`, `clip_01.mp4` … and ASS subtitle files. The pipeline itself **does not publish**; Claude Code uses the skill to run Publora MCP after rendering. Ask Claude: **“Use video-to-social to create three captioned Shorts from this authorized link, review and save Publora drafts for my YouTube and Instagram connections.”**
  50. ## Posting steps (Publora)
  51. Claude must run `account_context` → `list_connections` → `create_post` (draft, one per clip with idempotency key) → `get_upload_url` → presigned PUT via `scripts/upload_signed.py` → `complete_media` → `get_post` → (if authorized) `update_post` → `get_post`. Posting is asynchronous; the final status must be verified. The `.mcp.json` contains the OAuth URL without secrets.
  52. ## Limits & security
  53. - Downloading, subtitle generation and upload require a working network and correct third-party services. A successful render does not guarantee social publishing.
  54. - Automatic highlight score uses transcript features; no video-vision AI or guaranteed virality.
  55. - Center crop may cut out off-center subjects. Review clips before posting.
  56. - Only use content for which you have rights to edit and repost.
  57. - Never commit API keys, private presigned URLs, user source files or video outputs.
  58. Documentation: https://docs.publora.com/mcp/client-setup and https://docs.publora.com/mcp/tools-reference

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.