Skip to content

docs: rename the Workflows nav group to Make a video and drop retired workflow steps - #5655

Open
WaterrrForever wants to merge 1 commit into
miao/oss-skills-slimfrom
miao/docs-make-a-video-nav
Open

WaterrrForever wants to merge 1 commit into
miao/oss-skills-slimfrom
miao/docs-make-a-video-nav

Conversation

@WaterrrForever

Copy link
Copy Markdown
Collaborator

What

Renames the docs sidebar group Workflows to Make a video (docs/docs.json, one line) and makes small wording fixes in six of its guide pages so they describe the seven-skill pack as it is. No page is added, removed, or moved; every URL stays the same.

Stacked on #5651. The base is miao/oss-skills-slim, so this diff shows only the docs change. Retarget to main after #5651 merges.

Why

#5651 retires the workflow skills (product-launch-video, faceless-explainer, pr-to-video, general-video, motion-graphics, music-to-video, ...). Their guide pages now say "Using /hyperframes", but they were still grouped under "Workflows", and several still described the retired skills' confirmation step: the agent "proposes a direction and confirms", "Before it builds / Confirm:". That was the old interview and BRIEF.md gate. The hyperframes skill now builds what is asked, offers a storyboard on request (references/storyboard.md), and answers a loose idea with a proposal.

The rename was first made inside #5651 and then reverted there (bc4653c). scripts/check-catalog-source-pr.mjs lists docs/docs.json as generated catalog output, and refuses it in any PR that also touches registry/{blocks,components,examples}/ sources. #5651 touches those sources; this PR does not.

Related work

Refs #5651

How

  • docs/docs.json: "group": "Workflows" → "group": "Make a video". The catalog generators (scripts/generate-catalog-pages.ts, scripts/build-docs-gallery-nav.mjs) only rewrite the Catalog tab, so a later catalog publish will not revert this.
  • What check-catalog-source-pr.mjs allows: if the diff touches no registry/(blocks|components|examples)/ file, the script returns immediately. A docs-nav-only PR therefore passes, and scripts/catalog-publication.test.mjs asserts the same (committedCatalogOutputs(["docs/docs.json"]) is []).
  • Guide wording (each a sentence or two):
    • product-launch-video: the agent captures the product and builds from it; ask for a storyboard first if you want to approve the shots.
    • faceless-explainer, general-video, motion-graphics: "the agent proposes ... and confirms" becomes "say X in the request, or ask for a proposal first". The motion-graphics page no longer capitalizes "Motion Graphics" as a product name.
    • pr-to-video, captions-and-recuts: "Before it builds / Confirm:" becomes "Settle these in the request, or ask the agent to propose them first:".
    • pr-to-video keeps its release-state claim, because references/film.md still says "Never invent a version".
  • Unchanged: workflows.mdx, music-to-video, slideshow and hyperframes-vs-remotion already describe the current skills. No page mentions skills update <workflow>.

Test plan

The CI, Docs and PR captures workflows run only for PRs into main, so they will run when this PR is retargeted.

No visible change

This PR changes docs only. Nothing under packages/studio or packages/player changes.

🤖 Generated with Claude Code

… workflow steps

The per-workflow guides now route through /hyperframes, so the sidebar group
names what the reader wants to do rather than skills that no longer ship. The
guides no longer promise a confirmation round the retired workflow skills ran
(the interview and brief); they say what to put in the request and when to ask
for a proposal or storyboard first. URLs are unchanged.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant