Communitygithub.com

aievolutionpl/social-motion-agent

Create or edit YouTube videos, social shorts, screen tutorials, app showcases, explainers and motion films using this workspace's production records, researched brief and skill routing.

What is social-motion-agent?

social-motion-agent is a Claude Code agent skill that create or edit YouTube videos, social shorts, screen tutorials, app showcases, explainers and motion films using this workspace's production records, researched brief and skill routing.

Works with✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aievolutionpl/social-motion-agent/tree/HEAD/.agents/skills/social-motion-studio

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Social Motion Studio

Use the project root three levels above this skill folder. Read START_HERE.md, AGENTS.md and docs/PRODUCTION.md there.

For every new film invoke the local skills/intake/SKILL.md instructions: exactly five tailored questions with options in one message; wait for answers, summarize and produce. Location: config/routes.json → intake_skill. Respect an explicit user request to skip. Small revisions reuse the current brief.

Research before production. Record read sources and verified on-screen facts. Select only relevant instructions through studio.py route/find. Read the user-provided brand brief when applicable. Keep each production under output/jobs/ with a current HANDOFF.md.

Read docs/PROVIDERS.md for ElevenLabs narration, built-in imagegen and fal H3 Max b-roll. Check actual tools and existing authorization; instructions do not prove connectivity. Keep prompts/request IDs with local assets. Do not silently replace named providers.

Use the working local HTML renderer for motion or FFmpeg assembly for footage. HyperFrames is the primary HTML motion renderer; Hypermotion is a separate optional upstream tool. Inspect a draft before master, then probe, review and package the same hash. State any missing visual/audio checks. Publication requires explicit user approval.

For real website/application recordings use routes showcase or tutorial, then .agents/skills/screen-tutorials/SKILL.md and docs/OPENSCREEN.md. Install OpenScreen separately and set OPENSCREEN_EXECUTABLE. Adapter tests do not prove live desktop capture. Reuse the existing five-question intake for a new lesson.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Related Skills