Skip to content

docs(skills): text corrections from prompt-guide validation#2109

Open
vanceingalls wants to merge 1 commit into
mainfrom
fix/prompt-guide-validation-bugs
Open

docs(skills): text corrections from prompt-guide validation#2109
vanceingalls wants to merge 1 commit into
mainfrom
fix/prompt-guide-validation-bugs

Conversation

@vanceingalls

@vanceingalls vanceingalls commented Jul 9, 2026

Copy link
Copy Markdown
Collaborator

Summary

Documentation-only updates surfaced by the prompt-guide validation campaign (~40 builds of published prompts, executed exactly as written). The behavior fixes from the same campaign were split out to #2110; Tier 3 block bugs are tracked in #2107.

  • hyperframes-core SKILL.md — new "First-pass lint gotchas" subsection: the root composition element must carry data-start="0" (root_composition_missing_data_start), and initial states belong in gsap.fromTo, never a CSS transform paired with a GSAP tween on the same property (gsap_css_transform_conflict). Both were guaranteed first-build lint failures for agents writing compositions cold.
  • docs/concepts/compositions.mdxdata-composition-src paths resolve relative to the project root, not the referencing file (previously undocumented; a nested composition one level deep still writes compositions/foo.html).
  • gsap-transforms-and-perf.md — runtime-created SVG (createElementNS) has no reliable center pivot; draw geometry at local (0,0) inside a positioning <g> so scale/rotation pivot on the shape's middle.

Dropped in rebase: a media-use SKILL.md "local-model defaults" correction — superseded by #2027/#2065, which changed the actual default to the HeyGen free-usage path and rewrote that row.

(skills-manifest.json hash churn is the pre-commit hook keeping the manifest in sync.)

Test plan

  • Every correction verified against actual behavior during the validation campaign (lint failures reproduced; data-composition-src resolution confirmed; pivot bug reproduced + workaround validated in a shipped composition)
  • oxfmt clean on changed files

🤖 Generated with Claude Code

@vanceingalls vanceingalls force-pushed the fix/prompt-guide-validation-bugs branch from 40d3095 to 745168e Compare July 9, 2026 18:59
@vanceingalls vanceingalls changed the title fix(skills): resolve prompt-guide validation findings across skill pipelines docs(skills): text corrections from prompt-guide validation Jul 9, 2026
Documentation-only updates surfaced by the prompt-guide validation
campaign. The behavior fixes from the same campaign are in a separate
PR (pipeline fixes); Tier 3 block bugs are tracked in #2107.

- hyperframes-core SKILL.md: new "First-pass lint gotchas" subsection —
  the root composition element must carry data-start="0"
  (root_composition_missing_data_start), and initial states belong in
  gsap.fromTo, never a CSS transform paired with a GSAP tween on the
  same property (gsap_css_transform_conflict). Both were guaranteed
  first-build lint failures for agents writing compositions cold.
- media-use SKILL.md: "Weak local-model defaults" row corrected — local
  Kokoro TTS is the free default with HeyGen as the paid upsell (was
  described backwards), and bg-removal runs via the hyperframes CLI.
- docs/concepts/compositions.mdx: document that data-composition-src
  paths resolve relative to the project root, not the referencing file.
- gsap-transforms-and-perf.md: runtime-created SVG (createElementNS)
  has no reliable center pivot — draw geometry at local (0,0) inside a
  positioning <g> so scale/rotation pivot on the shape's middle.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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