Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ Catalog update for AI LABS 8-repo wave adaptation, hygiene patch, and MarkItDown
- Document NVIDIA SkillEvaluator as `FOREIGN_ON_DEMAND`: never installed, absent is not a doctor failure, and a malformed MCP entry still fails closed.
- Execute the stocktake protocol across all 62 catalog items and record it in `docs/stocktake-1.8.3.md`: one verdict per item, 56 `KEEP`, 2 `COMPRESS`, 4 `UPDATE`, 0 `MERGE`, 0 `RETIRE`. `MERGE` is zero on measured evidence, the highest description overlap being 0.359 Jaccard, below the 50% warn line. No item is retired without a no-skill baseline; five candidates are recorded as blocked on the A/B gate.
- Stocktake documentation (`docs/stocktake-1.8.3.md`) now includes `img2threejs` (63 rows, KEEP).
- Neutralize legacy host-name references in tool-family and scratch paths across `skills/visual-studio` and `skills/scroll-world`: replace `GrokBuild` mentions with native image/video tools (`image_gen`, `image_edit`, `image_to_video`, `reference_to_video`) while keeping the `DEGRADED` fallback gate intact, and migrate project scratch paths from `.grok/` to `.scratch/`.
- `README.md`: document optional `stitch` MCP alongside `serena` and `exa`. Enabled only by `opencode-bf stitch enable`, keys referenced as `{env:STITCH_API_KEY}` or omitted with `--oauth`, not an owned core server and not a production UI implementer, absent is not a doctor failure.
- Retire the predecessor `GrokBuild` host-product name from four skill bodies (`ask-matt` description, `chrome-devtools-axi` heading, `adhd`, `visual-studio`). `ask-matt` matters most: its description loads on every session. Tool-family references that name an image/video contract rather than the host are left intact.
- `chrome-devtools-axi`: drop a `$HOME/.grok/bin` fallback that contradicted `rules/00-routing.md` ("Do not depend on `~/.grok` at runtime") and reconcile two duplicated invocation blocks. Port `9223`, the `HEADED`/`AUTO_CONNECT` prohibition, and the never-fall-back-to-Google-Chrome fence are unchanged.
Expand Down
2 changes: 1 addition & 1 deletion docs/stocktake-1.8.3.md
Original file line number Diff line number Diff line change
Expand Up @@ -132,7 +132,7 @@ A baseline cannot be produced from inside a single session that already has the
## Follow-ups

1. Run the A/B gate on the five candidates above before proposing any RETIRE.
2. Decide whether the `GrokBuild image_gen` tool-family name should be renamed catalog-wide, or documented as the intended tool contract.
2. ~~Decide whether the `GrokBuild image_gen` tool-family name should be renamed catalog-wide, or documented as the intended tool contract.~~ Resolved: neutralized host names across `visual-studio` and `scroll-world` to native image/video tools (`image_gen`, `image_edit`, `image_to_video`, `reference_to_video`) while retaining the DEGRADED fallback gate, with scratch paths aligned to `.scratch/`.
3. ~~`impeccable` frontmatter declares `Apache 2.0` while `vendor/license-audit.json` records `Apache-2.0`.~~ Resolved: frontmatter now reads `Apache-2.0`, and the audit evidence string dropped the parenthetical that only existed to flag the mismatch.
4. 28 of 62 skills omit a frontmatter `license` key by design. If that ever becomes confusing, document it in the skill authoring guide rather than adding keys.
5. `img2threejs` added post-#21; not part of the original 1.8.3 execution pass.
12 changes: 6 additions & 6 deletions skills/scroll-world/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: scroll-world
description: "Build a scroll-scrubbed fly-through landing: as the visitor scrolls, a pre-rendered camera flies into each scene and on to the next with no cuts. Use when: 3D world landing, diorama site, Emons-style isometric world, scroll cinematic, browse-through-the-industry hero, camera-scrub page, or the user runs /scroll-world. Uses GrokBuild image_gen, image_edit, and image_to_video plus a portable vanilla-JS scrub engine. Load OpenCode native image tools if present, else DEGRADED before any generate/edit/video call. Not for scroll-led storytelling without a camera world (use scroll-craft), an ordinary landing (use impeccable), photoreal ads/identity with no world page (use visual-studio), or UI chrome motion (use emil-design-eng after Impeccable)."
description: "Build a scroll-scrubbed fly-through landing: as the visitor scrolls, a pre-rendered camera flies into each scene and on to the next with no cuts. Use when: 3D world landing, diorama site, Emons-style isometric world, scroll cinematic, browse-through-the-industry hero, camera-scrub page, or the user runs /scroll-world. Uses native image_gen, image_edit, and image_to_video plus a portable vanilla-JS scrub engine. Load native image tools if present, else DEGRADED before any generate/edit/video call. Not for scroll-led storytelling without a camera world (use scroll-craft), an ordinary landing (use impeccable), photoreal ads/identity with no world page (use visual-studio), or UI chrome motion (use emil-design-eng after Impeccable)."
compatibility: opencode
license: MIT
---
Expand All @@ -9,19 +9,19 @@ license: MIT

A landing where **scroll drives a camera**. The camera flies into a scene,
then on to the next, as one connected flight. Stills and clips come from
GrokBuild tools. The page only scrubs pre-rendered video by scroll
native image/video tools. The page only scrubs pre-rendered video by scroll
position.

## Load first

Before any `image_gen`, `image_edit`, `image_to_video`, or
`reference_to_video` call, load OpenCode native image tools if the session exposes them; otherwise write prompt files and mark DEGRADED. Tool choice, prompt
`reference_to_video` call, load native image tools if the session exposes them; otherwise write prompt files and mark DEGRADED. Tool choice, prompt
length, real-people references, shot length, and ffmpeg live there. Do
not restate them here.

## Hard rules

- Use only GrokBuild image/video tools. Do not call an external
- Use only native image/video tools. Do not call an external
image/video API, CLI, or MCP.
- Do not invent tool parameters. There is no end-image lock and no
video-to-video. Missing capability uses the fallback in
Expand Down Expand Up @@ -54,7 +54,7 @@ chain. Do not load visual-studio for an ordinary landing.
## Run

1. Interview only what is missing. Write the pack at
`.grok/scroll-world/<slug>/`. Templates:
`.scratch/scroll-world/<slug>/`. Templates:
[prompts.md](references/prompts.md).
2. Generate stills. One style preamble, byte-for-byte, on every still.
Review cohesion before any video.
Expand Down Expand Up @@ -95,7 +95,7 @@ across a seam. Locked-iso is A plus the locked-iso clause in every leg.

**B — dive + aerial hop (diorama only).** One dive per scene from that
scene's still. A connector starts on dive *i*'s actual last frame and
flies toward scene *i+1*. Grok cannot lock the connector's last frame to
flies toward scene *i+1*. Native tools cannot lock the connector's last frame to
the next dive. The engine crossfade covers the near-miss. If a hop is
unusable, set that connector to `null` (direct crossfade). Do not use B
on a grounded photoreal walkthrough without saying it will read as a
Expand Down
6 changes: 3 additions & 3 deletions skills/scroll-world/references/pipeline.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# Pipeline

Grok tools + ffmpeg. Shot length (6s default, 10s only if asked) lives
in OpenCode native image tools if the session exposes them; otherwise write prompt files and mark DEGRADED. Do not invent end-image, video-to-video, or extra
Native tools + ffmpeg. Shot length (6s default, 10s only if asked) lives
in native image tools if the session exposes them; otherwise write prompt files and mark DEGRADED. Do not invent end-image, video-to-video, or extra
durations.

Project pack: `.grok/scroll-world/<slug>/`
Project pack: `.scratch/scroll-world/<slug>/`

Site assets: `./assets` (stills as webp) and `./assets/vid` (mp4).

Expand Down
4 changes: 2 additions & 2 deletions skills/scroll-world/references/prompts.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,12 +4,12 @@ Fill-in-the-slots. Keep the **style preamble** byte-for-byte identical
across every scene still — that identical text is what makes the world
one place.

Shot length, prompt length, and tool choice live in OpenCode native image tools if the session exposes them; otherwise write prompt files and mark DEGRADED.
Shot length, prompt length, and tool choice live in native image tools if the session exposes them; otherwise write prompt files and mark DEGRADED.
Do not restate them here.

## Intake

Write into `.grok/scroll-world/<slug>/lock.txt`:
Write into `.scratch/scroll-world/<slug>/lock.txt`:

- `SUBJECT` — business + one-line pitch.
- `BRAND_NAME` — display name.
Expand Down
6 changes: 3 additions & 3 deletions skills/visual-studio/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: visual-studio
description: "Produce photoreal product stills, reusable identity packs, UGC/ad videos, cinematic VFX shots, and video thumbnails with GrokBuild image_gen, image_edit, image_to_video, and reference_to_video. Use when: product photo, studio shot, lifestyle, Pinterest pin, hero banner, carousel, ad pack, virtual try-on, UGC, unboxing, product review, TV spot, cinematic video, VFX, character sheet, size-ref, face-lock, YouTube thumbnail, Shorts cover, or the user runs /visual-studio. Load OpenCode native image tools if present, else DEGRADED before any generate/edit/video call. Not for UI/frontend (use impeccable), game sprites or tiles (use game-asset-core), or UI motion (use emil-design-eng)."
description: "Produce photoreal product stills, reusable identity packs, UGC/ad videos, cinematic VFX shots, and video thumbnails with native image_gen, image_edit, image_to_video, and reference_to_video. Use when: product photo, studio shot, lifestyle, Pinterest pin, hero banner, carousel, ad pack, virtual try-on, UGC, unboxing, product review, TV spot, cinematic video, VFX, character sheet, size-ref, face-lock, YouTube thumbnail, Shorts cover, or the user runs /visual-studio. Load native image tools if present, else DEGRADED before any generate/edit/video call. Not for UI/frontend (use impeccable), game sprites or tiles (use game-asset-core), or UI motion (use emil-design-eng)."
compatibility: opencode
license: MIT
---
Expand All @@ -14,13 +14,13 @@ identity, modes, and VFX method.
## Load first

Before any `image_gen`, `image_edit`, `image_to_video`, or
`reference_to_video` call, load OpenCode native image tools if the session exposes them; otherwise write prompt files and mark DEGRADED. Tool choice, prompt
`reference_to_video` call, load native image tools if the session exposes them; otherwise write prompt files and mark DEGRADED. Tool choice, prompt
length, real-people references, exact text, shot length, and ffmpeg concat
live there. Do not restate them here.

## Hard rules

- Use only GrokBuild image/video tools. Do not call an external image/video
- Use only native image/video tools. Do not call an external image/video
API, CLI, or MCP.
- Do not invent tool parameters. If a capability is missing (video-to-video,
15s one-take, trained identity models), use the fallback in the matching
Expand Down
4 changes: 2 additions & 2 deletions skills/visual-studio/references/cinematic-vfx.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# Cinematic VFX

Recreate or invent a photoreal shot as a planned sequence of stills, then
short videos. GrokBuild has no video-to-video. Do not pretend it does.
short videos. Native tools have no video-to-video. Do not pretend they do.

Identity, face-lock, size-ref, and prompt blocks: [pipeline.md](pipeline.md).
Tool contract: OpenCode native image tools if the session exposes them; otherwise write prompt files and mark DEGRADED.
Tool contract: native image tools if the session exposes them; otherwise write prompt files and mark DEGRADED.

## Order

Expand Down
2 changes: 1 addition & 1 deletion skills/visual-studio/references/pipeline.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Build identity once. Derive every later still and shot from it.

## Identity pack

Project path: `.grok/visual-studio/<slug>/`
Project path: `.scratch/visual-studio/<slug>/`

| File | What it is |
|---|---|
Expand Down
Loading