product-demo-seeding

Seed isolated, deterministic Kandev demo scenarios for product screenshots and video captures.

733|110|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/kdlbs/kandev --skill product-demo-seeding
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: product-demo-seeding
Source: https://github.com/kdlbs/kandev/tree/main/.agents/skills/product-demo-seeding
Command: npx skills add https://github.com/kdlbs/kandev --skill product-demo-seeding

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Recording product screenshots and videos requires believable, coherent application state, but ad-hoc seeding often reuses stale builds, leaks developer data, or leaves duplicate fixtures that ruin takes. This Skill builds truthful, disposable demo scenarios from a verified current-main checkout with full isolation.

Core Features & Use Cases

  • Current-main source gate: Fetches origin/main, creates a clean detached capture worktree, and proves HEAD matches before building.
  • Deterministic isolation: Allocates fresh HOME, KANDEV_HOME_DIR, database, ports, display, and browser profile per take, with mock GitHub and Jira providers and no real credentials or network access.
  • Per-take state contracts: Resets to a fresh database before every recorded take, verifies exact record counts, and hands provenance and teardown to the capture step.
  • Use Case: Before filming a GitHub/Jira integration demo, seed a fictional project with fixed provider fixtures, rehearse the route, discard rehearsal state, and record desktop and native-mobile takes from identical pristine baselines.

Quick Start

Seed a disposable Kandev demo scenario from current main with mock GitHub and Jira data for a desktop and mobile product video, without touching my running instance.

Frequently Asked Questions about product-demo-seeding

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I seed demo data for product screenshots and videos?

Build from a clean detached worktree of freshly fetched origin/main, then create fictional workspaces, tasks, sessions, and provider state through the E2E fixture and ApiClient. Seed only enough coherent data to make the story legible, rehearse without a recorder, and reseed a pristine baseline per take.

How do I mock GitHub and Jira for a product demo capture?

Run deterministic mock GitHub and Jira providers at the backend boundary with fixed IDs, timestamps, actors, and ordering from one versioned fixture document. Keep provider credentials unset, block live network calls, and prove mock routing in backend logs before recording.

Can I reuse my existing Kandev database for demo capture?

No. The skill forbids copying or querying a developer's database or instance, including scripts/dev-isolated --copy-db. Every take starts from a fresh disposable database with its own temp HOME, ports, display, and browser profile.

Why do repeated recording takes show duplicate tasks on the board?

Rehearsal and failed takes mutate product state, so recording against the same database accumulates duplicate tasks and provider-created records. Start each recorded take from a fresh database or a proven complete reset, and assert exact record counts before RECORD.

What are the limitations of DOM patching during product capture?

DOM deletion, CSS hiding, and capture-time text replacement are prohibited because they mask real product state and responsive defects. If a surface is broken, report the bug and choose another truthful native route that demonstrates the same capability.