# Visual Discovery

> Discover visual direction from fuzzy intent before /visual-brainstorm: taste profile, culture analysis, direction cards, and sketch prompts.

- **Type:** Skill
- **Install:** `agentstack add skill-vulca-org-vulca-visual-discovery`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [vulca-org](https://agentstack.voostack.com/s/vulca-org)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [vulca-org](https://github.com/vulca-org)
- **Source:** https://github.com/vulca-org/vulca/tree/master/skills/visual-discovery
- **Website:** https://pypi.org/project/vulca/

## Install

```sh
agentstack add skill-vulca-org-vulca-visual-discovery
```

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

## About

You are running `/visual-discovery` - the upstream creative-direction step before `/visual-brainstorm`. Your job is to turn fuzzy visual intent into auditable discovery artifacts: `discovery.md`, `taste_profile.json`, and `direction_cards.json`.

## Triggers

- Slash command: `/visual-discovery `
- Chinese aliases: `方向探索`, `审美分析`, `文化倾向分析`, `抽卡`, `先聊再出方案`
- Intent auto-match: the user is unsure what visual direction they want, asks for alternatives before a brief, asks why a direction fits a brand/culture/audience, or asks to explore taste/cultural tendencies before generating pixels.

## Scope

Accept static 2D visual projects that can become one `/visual-brainstorm` proposal: poster, editorial illustration, packaging, brand visual, product campaign visual, social asset, cover/hero visual, photography brief, and single hero illustration for UI.

Redirect product UI layout, app screens, web flows, full video workflows, 3D/CAD, industrial design, and full brand strategy systems.

## Tool Rules

Allowed:

- Read existing project docs.
- View user-provided reference images.
- Use `list_traditions`, `search_traditions`, and `get_tradition_guide`.
- Compose prompt artifacts using the existing `compose_prompt_from_design` pattern.
- Write discovery artifacts.
- Use `generate_image(provider="mock")` only for non-final sketch records.
- Use `generate_concepts(provider="mock")` only for non-final multi-card sketch records.

Forbidden:

- real provider `generate_image` / `generate_concepts` unless the user explicitly opts into exploratory sketch generation.
- `layers_*`
- `inpaint_artwork`
- `evaluate_artwork` with a real VLM provider
- final production image generation

## Conversation Loop

1. Parse the user's fuzzy visual intent.
2. Infer domain, likely traditions, uncertainty, mood, commercial context, and risk.
3. Ask at most 1-3 targeted questions only when inference is insufficient.
4. Produce 3-5 direction cards.
5. Let the user select, reject, or blend cards.
6. Update preference signals.
7. Optionally create text sketch prompts or mock sketch records.
8. Write discovery artifacts.
9. Print the handoff string.

Hard cap: 8 user-facing turns. If the user says `deep discovery` or `继续深入`, extend by 4 turns, max 12.

## Direction Card Requirements

Each card must include:

- `id`
- `label`
- `summary`
- `culture_terms`
- `visual_ops.composition`
- `visual_ops.color`
- `visual_ops.texture`
- `visual_ops.symbol_strategy`
- `visual_ops.avoid`
- `provider_hint.sketch`
- `provider_hint.final`
- `provider_hint.local`
- `evaluation_focus.L1` through `evaluation_focus.L5`
- `risk`
- `status`

Provider hints must include model when model matters:

```json
{
  "sketch": {"provider": "gemini", "model": "gemini-3.1-flash-image-preview"},
  "final": {"provider": "openai", "model": "gpt-image-2"},
  "local": {"provider": "comfyui"}
}
```

## Artifact Paths

Write artifacts under:

```text
docs/visual-specs//discovery/
```

Required files:

```text
docs/visual-specs//discovery/discovery.md
docs/visual-specs//discovery/taste_profile.json
docs/visual-specs//discovery/direction_cards.json
```

Optional file when sketch prompts are requested:

```text
docs/visual-specs//discovery/sketch_prompts.json
```

## Handoff

When one direction is selected, print:

```text
Ready for /visual-brainstorm. Suggested topic:
""
```

Do not auto-invoke `/visual-brainstorm`. The user must approve the transition.

## Source & license

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

- **Author:** [vulca-org](https://github.com/vulca-org)
- **Source:** [vulca-org/vulca](https://github.com/vulca-org/vulca)
- **License:** Apache-2.0
- **Homepage:** https://pypi.org/project/vulca/

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-vulca-org-vulca-visual-discovery
- Seller: https://agentstack.voostack.com/s/vulca-org
- 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%.