# Iopho Product Context

> >

- **Type:** Skill
- **Install:** `agentstack add skill-iopho-team-iopho-skills-iopho-product-context`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [iopho-team](https://agentstack.voostack.com/s/iopho-team)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [iopho-team](https://github.com/iopho-team)
- **Source:** https://github.com/iopho-team/iopho-skills/tree/main/skills/iopho-product-context

## Install

```sh
agentstack add skill-iopho-team-iopho-skills-iopho-product-context
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# iopho-product-context

Generate structured `context.md` for video production — the foundation file all other iopho skills read.

## When to Use

- Starting a new video project (product demo, launch video, explainer, VSL)
- Onboarding a client project (like a client project)
- Any iopho skill asks for context but none exists yet
- Updating an existing context file with new information

## Quick Start

```
/iopho-product-context ./exp/my-project
/iopho-product-context ./exp/my-project --quick           # 5 core questions only
/iopho-product-context ./exp/my-project --from-file README.md  # pre-fill from docs
```

## How It Works

### Mode 1: Interactive (default)

Ask the user these questions IN ORDER. Accept answers in any language (CN/EN/mixed).

**Core Questions (always ask)**:

1. **What's the product?** — Name, URL, one-sentence description
2. **Who is it for?** — Primary audience + their pain point
3. **What makes it different?** — Top 3 differentiators from competitors
4. **What video do you want?** — Type (demo/explainer/launch/teaser), duration, platforms
5. **Any brand rules?** — Colors, fonts, tone of voice, design system files

**Deep-Dive Questions (ask unless `--quick`)**:

6. **Who are the competitors?** — List 2-5 competitors, their strengths/weaknesses
7. **Founder visibility?** — Should founders/team appear? (public / anonymous / team-only)
8. **Hero feature?** — The ONE feature that must be the centerpiece of the video
9. **What to avoid?** — Anything off-limits (features, messaging, visuals)
10. **Reference videos?** — Any video styles they like (provide URLs → feed to iopho-searching-videos)
11. **Languages?** — Which languages for VO and subtitles
12. **Call to action?** — What should viewers do after watching

### Mode 2: Auto-Detect (`--from-file`)

Before asking questions, scan the project directory for existing context:

```
Look for and read (if present):
├── README.md              → product name, description, features
├── package.json           → name, description, keywords
├── **/brand.ts            → colors, fonts (Remotion projects)
├── **/*DesignPrompts*     → design system (client project pattern)
├── **/questionaire.md     → existing intake (client project pattern)
├── **/context.md          → previous context file (update mode)
└── website URL            → scrape tagline, features, pricing (if provided)
```

Pre-fill answers from detected files, then ask user to CONFIRM or CORRECT each field. Skip questions already answered by auto-detection.

### Mode 3: Update

If `context.md` already exists in the project directory, read it and ask:
> "Found existing context.md. What needs updating?"

Only modify the fields the user mentions. Preserve everything else.

## Output

Generate `{project-dir}/context.md` using the template at `templates/context-template.md`.

**Output rules**:
- YAML frontmatter: machine-readable fields (name, URL, colors as hex, platforms as array)
- Markdown body: human-readable prose (features, audience, competitors, notes)
- All hex colors validated (6-char format)
- All URLs as full https:// format
- Bilingual content preserved as-is (don't translate user's words)

## Validation

After generating context.md, verify:
- [ ] Product name is not empty
- [ ] At least 1 target audience defined
- [ ] At least 1 video platform specified
- [ ] At least 1 language specified
- [ ] Brand colors are valid hex (if provided)
- [ ] Founder visibility preference is set

If any critical field is missing, ask the user — don't guess.

## Real-World Examples

**[App Name]** (a reader/learning app):
- Product: AI read-later app → Explainer video, 78s, YouTube/Product Hunt
- Brand: `#007AFF` primary, SF Pro font, warm/approachable tone
- Hero feature: AI reflow + instant summary
- Context existed in: `{project}/video-strategy.md`

**[CLI Tool]** (a developer networking tool):
- Product: P2P agent collaboration → Launch video, 90s, YouTube/GitHub
- Brand: `#1D3557` deep ocean, `#E63946` lobster red, cinematic/authoritative
- Hero feature: ASCII globe + npx install
- Context existed in: `{project}/questionaire.md` + `{project}/product-codex.md`
- Founder visibility: **anonymous** (user requested)

## Related Skills

- `/iopho-video-director` — calls this skill as Phase 0 step 1
- `/iopho-searching-videos` — uses reference video URLs from context
- `/vsl-storyboard-writer` — reads context for audience/positioning
- `/storyboard` — reads context for product understanding

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [iopho-team](https://github.com/iopho-team)
- **Source:** [iopho-team/iopho-skills](https://github.com/iopho-team/iopho-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-iopho-team-iopho-skills-iopho-product-context
- Seller: https://agentstack.voostack.com/s/iopho-team
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
