sedarged/debug-render-failure
.cursor/skills/debug-render-failure/SKILL.md
Debug render pipeline failures. Use when investigating failed or stuck renders, dry-run issues, or pipeline errors.
$ install --global
skillsauthnpx skillsauth add sedarged/TikTok-AI-Agent debug-render-failureInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 1:50 AM4.1s1 file scanned
SKILL.md
- name:
- debug-render-failure
- description:
- Debug render pipeline failures. Use when investigating failed or stuck renders, dry-run issues, or pipeline errors.
- compatibility:
- TikTok-AI-Agent, Node, Express, Prisma. Render pipeline in apps/server; APP_RENDER_DRY_RUN, FFmpeg.
Debug Render Failure
Use this skill when debugging render pipeline issues.
Environment
- APP_RENDER_DRY_RUN=1 – Run full pipeline without paid APIs; outputs are placeholder files.
- APP_DRY_RUN_FAIL_STEP=<step> – Simulate failure at a specific step. Valid steps:
tts_generate,asr_align,images_generate,captions_build,music_build,ffmpeg_render,finalize_artifacts. - APP_DRY_RUN_STEP_DELAY_MS – Optional delay (ms) before each dry-run step.
Where to look
- Run state:
Run.logsJson(array of log messages),Run.resumeStateJson(completed steps, resume data). DB via Prisma ordb:studio. - Pipeline:
apps/server/src/services/render/renderPipeline.ts. CheckcompletedSteps,saveResumeState,handlePipelineError, and queue processing (processNextInQueue). - Retry:
POST /api/run/:runId/retrysupports optionalfromStepto resume from a specific step.
Checks
- Confirm Run status (
queued/running/failed/done/canceled/qa_failed). - Inspect
logsJsonandresumeStateJsonfor the last completed step and error message. - Reproduce with
APP_RENDER_DRY_RUN=1and optionallyAPP_DRY_RUN_FAIL_STEPto test error handling. - Ensure FFmpeg is available when not in dry-run; check
ARTIFACTS_DIRand disk space.
References
- renderPipeline.ts, run routes
- .github/copilot-instructions.md (Test Modes, Debug render failures)
Related Skills
sedarged/validate
development
VerifiedTrustedCommunity
Run lint, typecheck, test, and test:render; summarize pass/fail. Complements the validate command. Use when user asks to "validate", "run checks", or "run full validation".
1SKILL.mdUpdated Apr 16, 2026
sedarged/repo-audit
development
VerifiedTrustedCommunity
Run lint, typecheck, test, and test:render; collect results and produce a short audit report. Use when asked to "audit the repo", "check project health", or "run full validation".
1SKILL.mdUpdated Apr 16, 2026
sedarged/plan-to-tasks
testing
VerifiedTrustedCommunity
Turn product plan or requirements into a checklist or task list (e.g. for STATUS.md). Use when given a plan fragment, roadmap, or requirements to break down into concrete tasks.
1SKILL.mdUpdated Apr 16, 2026
sedarged/hello-skill
tools
VerifiedTrustedCommunity
Say hello and list project commands. Use for a quick project intro or when the user asks "what can this project do" or "list commands".
1SKILL.mdUpdated Apr 16, 2026