gen ยท diff
git:20260916.e36170f to git:20260928.2acb2c4
110 added, 21 removed. Audit A to A.
---
name: gen
- description: Generate media and authored web artifacts with Okou, or route connector-backed generation.
+ description: Use Okou generation pipelines for images, presentations, websites, reports, and designs.
---
# Gen
- Route generation requests to the narrowest current Okou command and load only the execution reference that task needs.
+ Use this skill to generate user-facing artifacts through the Okou CLI:
- ## Template Precedence
+ ```bash
+ okou generate -h
+ ```
- An attached generation template takes precedence. Follow its exact commands and resources; do not run `okou generate -h` or list providers unless the template explicitly names type-specific help as a fallback. For any video submission, still honor the applicable preview approval in [video preview](references/video-preview.md).
+ `okou generate` is the source of truth. Always inspect the current command help when exact flags, models, styles, or providers matter.
- ## Route
+ ## Core Commands
- | Request | Command | Read before execution |
- | ------------------------------------------------------------------------------------------- | ---------------------------- | ------------------------------------------------------------------------------------------- |
- | Image or image edit | `okou generate image` | [direct media](references/direct-media.md) |
- | Generated video | `okou generate video` | [direct media](references/direct-media.md) and [video preview](references/video-preview.md) |
- | Talking avatar | `okou generate avatar-video` | [direct media](references/direct-media.md) |
- | Speech audio | `okou generate voice` | [direct media](references/direct-media.md) |
- | Presentation, website, report, docs design, poster, dashboard, mobile-app design, or sprite | `okou generate <type>` | [authored artifacts](references/authored-artifacts.md) |
- | Connector-backed text, code, document, or music | `okou generate <type>` | [connector generation](references/connector-generation.md) |
+ - `okou generate image` - billed image file generation; supports built-in models, image editing/reference inputs, image style registry selection, and connector guidance.
+ - `okou generate presentation` - returns an Open Design resource-selection packet for an HTML presentation that the agent authors and hosts.
+ - `okou generate website` - returns website authoring instructions / an Open Design packet that the agent uses to build and host a static site.
+ - `okou generate report`, `docs-design`, `poster`, `dashboard-design`, `mobile-app-design` - return Open Design resource-selection packets for static HTML artifacts.
+ - `okou generate text`, `code`, `document`, `audio` - list connector-backed options and print connector skill-invocation guidance; these do not have built-in platform pipelines unless the CLI help says otherwise.
- There is no generic `audio` type: use `voice` for speech or `music` for connector-backed music. If no listed type fits, run `okou generate -h` once and do not claim unsupported capability.
+ Run `okou generate <type>` with no generation input to list available providers for that artifact type. Add `--all` when unavailable or not-yet-authorized connectors are relevant.
- ## Command Discipline
+ ## Generation Workflow
- - When the type is known, read `okou generate <type> --help` directly before execution and reuse help already read for the same CLI version and context. Do not unconditionally chain root, group, and leaf help.
- - Run `okou generate <type>` without generation input only when provider or registry discovery is needed. If the user named a provider, request its guidance directly with `--provider <name>` when that type supports providers.
- - Exact flags, models, styles, templates, providers, limits, and result fields come from current CLI help, not examples remembered from this skill.
+ 1. Identify the artifact type from the user's request.
+ - Use `image` for raster images, edits, references, thumbnails, icons, illustrations, and visual assets.
+ - Use Open Design artifact commands for websites, decks, reports, posters, docs, dashboards, and mobile UI prototypes.
+ - Use connector-listing commands for text, code, document, or non-speech audio generation.
- ## Completion Invariants
+ 2. Discover current capability before committing.
+ - Run `okou generate <type> -h` for flags and built-in model support.
+ - Run `okou generate <type>` to see available providers.
+ - If the user asked for a connector/provider by name, run `okou generate <type> --provider <name>` to get invocation guidance, then follow that provider skill.
- After submitting a generation command, wait for that same command or durable job to finish and use what it returns. Do not abandon it, switch approaches, or submit another billed job merely because it is slow. A repeat can create and charge for a second result.
+ 3. Determine whether style discovery is needed.
+ - For styled images, inspect the current style registry from `okou generate image -h`.
+ - Do not hardcode style names or style descriptions in this skill. Treat the registry printed by the CLI as the live source.
+ - Choose a registered style when the user's wording clearly matches a trigger, named style, or visual direction in the registry.
+ - To obtain style-specific prompt guidance, run `okou generate image --style <id> --prompt "<brief>" --compile`, follow the returned packet, then generate with `--compiled-prompt "<final prompt>"`.
+ - Use `--raw-prompt "<final prompt>"` when the user explicitly wants no registry style, wants photorealism/model-native output, supplies a fully specified prompt, or no registry style is a good match.
+ - When no style is obvious but style materially affects the result, ask the user to choose among a few options summarized from the live registry or ask whether to proceed without a style.
- A returned authoring or connector-guidance packet is not a finished artifact. Follow the selected reference until the deliverable exists. A direct-media result is a finished server-side artifact; deliver its returned URL and metadata. If generation fails for insufficient credits, run `okou doctor credit` and follow its result rather than assuming a purchase is available.
+ 4. Decide provider and model.
+ - Prefer `--provider built-in` when the user wants a direct artifact, does not name a connector, and the built-in pipeline supports the request.
+ - Use connector guidance when the user names a provider, needs a provider-specific capability, or the requested artifact type is connector-only.
+ - Ask the user when the choice changes cost, latency, fidelity, licensing, account usage, or final format in a way that is not implied by the request.
+ - Otherwise choose a sensible default from the CLI help and proceed.
+
+ 5. Build the prompt.
+ - Preserve the user's core intent, constraints, audience, brand, source materials, aspect ratio, size, format, and delivery target.
+ - Add operational details only when they improve generation reliability: composition, visual hierarchy, must-include/must-avoid elements, target medium, and reference handling.
+ - For style-guided image generation, let the selected registry style drive stylistic details through the compilation packet.
+ - For prompt text that is long or quote-sensitive, use a file and a safely quoted argument, or stdin when the selected prompt mode supports it.
+
+ 6. Execute and wait for completion.
+ - Run the selected `okou generate <type>` command.
+ - For commands that return an Open Design resource-selection packet, follow the packet: author the artifact, verify it locally if needed, and host static outputs with `okou host`.
+ - For commands that return `/f/` file URLs, keep the URL and metadata for the user.
+ - If generation fails because of missing credits, run `okou doctor credit`.
+ - If connector auth fails, run `okou doctor check-connector` using the environment name or URL from the provider guidance.
+
+ 7. Deliver the result.
+ - Give the user the generated URL or hosted artifact URL.
+ - Mention important parameters used: provider, model, selected style or raw prompt mode, size/aspect ratio, or site slug.
+ - If the output is temporary or provider-hosted with expiration, download or host a durable copy when appropriate.
+
+ ## Asking vs. Choosing
+
+ Ask the user before generation when:
+
+ - The prompt is too underspecified to produce a useful artifact.
+ - Multiple provider/style/model choices are plausible and materially different.
+ - The command will spend meaningful credits and the request did not imply that spend.
+ - The user requested brand, person, legal, medical, financial, or other high-stakes accuracy that needs source material.
+ - Required inputs are missing, such as source images, brand assets, dimensions, or audience.
+
+ Proceed without asking when:
+
+ - The user gave enough context for a reasonable first version.
+ - The built-in default clearly fits the request.
+ - The user asked for speed or explicitly delegated choices.
+ - The missing details can be safely inferred and refined after the first artifact.
+
+ ## Common Patterns
+
+ List current image providers:
+
+ ```bash
+ okou generate image
+ ```
+
+ Inspect current image styles and flags:
+
+ ```bash
+ okou generate image -h
+ ```
+
+ Compile a styled image prompt after selecting a live registry style, then use the packet's final prompt:
+
+ ```bash
+ okou generate image --style "<style-id>" --prompt "<brief>" --compile
+ okou generate image --provider built-in --compiled-prompt "<final prompt>"
+ ```
+
+ Generate an unstyled/model-native image:
+
+ ```bash
+ okou generate image --provider built-in --raw-prompt "<prompt>"
+ ```
+
+ Use connector guidance instead of built-in generation:
+
+ ```bash
+ okou generate image --provider "<connector-name>"
+ ```
+
+ Generate a static Open Design artifact:
+
+ ```bash
+ okou generate website --prompt "<brief>"
+ ```
+
+ Then follow the returned packet to build and host the artifact.