OGRAF HTML 动画OGRAF HTML 动画

Develop and publish OGRAF animations with AI

Works with any AI Agent — Codex, Claude Code, WorkBuddy, Qoder and more.

01

Install ograf-creator-skill in an AI Agent

Choose your AI Agent and open a local working folder for your animations. Use the Codex or WorkBuddy example below to install the Skill.

Codex

Send this message in Codex to install from GitHub with skill-installer.

Send to Codex
$skill-installer Install https://github.com/minghe36/ograf-creator-skill

After installation, ask to use ograf-creator-skill to create an animation. Restart Codex if the Skill does not appear.

Codex documentation

WorkBuddy

Choose a local working folder in WorkBuddy, create a task and send this message.

Send to WorkBuddy
Install this Skill: https://github.com/minghe36/ograf-creator-skill

Ask WorkBuddy to use ograf-creator-skill to create an animation and confirm it has read the matching SKILL.md.

WorkBuddy documentation

Cannot access GitHub?

Ask your AI Agent to download the ZIP from the CDN, extract it and install the Skill. This instruction works for both Codex and WorkBuddy.

Send to your AI Agent
Download and extract https://cdn.haoai.pro/assets/ograf-creator-skill.zip, then install ograf-creator-skill.

If you already downloaded the Skill, give your AI Agent the local ograf-creator-skill directory path and ask it to install it. Sign-in and upload require the complete version containing scripts/ograf_auth.py.

02

Create your first animation

Open a local working folder in Codex. Describe the name, purpose, visuals, motion and supported orientations. Attach a reference image if you have one. Creating, previewing and validating all happen locally and need no ograf.app account.

Send to Codex
Use ograf-creator-skill to create a simple title animation: center “Hello, OGRAF” in white on a transparent background, fade it in slowly and hold it for a total duration of 3 seconds. Support 1920×1080 landscape, with editable title, color and font size.

Open a local preview when ready. Do not upload yet.
  • Check that the component metadata matches your name, description and orientation choices.
  • Review the actual preview and verify that editable parameters update the visuals.
03

Iterate with AI

Continue in the same Codex conversation. Describe the element to change, the desired effect and what should stay unchanged. Add references, colors or timing details as needed.

Send to Codex
Change the title to “My first animation”, use purple text and set the fade-in duration to 1 second. Preview the updated animation.
  • Focus each request on a related set of changes. Ask Codex for a screenshot or a local preview when helpful.
  • Once the visuals, parameters and motion are approved, ask Codex to validate and package the component. A working preview does not mean it has been published.
04

Sign in to ograf.app

Creating and iterating are local and need no account. An ograf.app account is only needed to upload or publish: send this message and complete HaoAI sign-in in the browser it opens. Signing in to Codex is separate from signing in to ograf.app.

Send to Codex
Use OGRAF Creator Skill to sign in to ograf.app. Run scripts/ograf_auth.py login from the Skill directory, open the sign-in page and check the authentication status afterward.
  • Return to Codex after browser sign-in and confirm success. The Skill stores upload credentials locally and reuses them for later uploads, code syncs and edits.
  • Ask Codex to run scripts/ograf_auth.py status to check the saved account. Sign in again only when the credentials are missing or rejected, for example when an upload returns 401.
05

Package and publish to the community

After approving the preview, explicitly ask Codex to upload and publish. Uploading creates a workspace draft; community publication is a separate step before a public page is available.

Send to Codex
The preview is approved. Use OGRAF Creator Skill to validate and package this animation, upload it to my ograf.app workspace and publish it to the community.

Preserve the approved name, description, parameters and supported orientations. Check both upload and publication results and return the public URL. If only a draft was uploaded, report that it is not published yet and complete publication.
  • Upload limits: ZIP package up to 500 KB, each JS file up to 500 KB, each image up to 1 MB, at most 200 files and 2 MB after extraction. Videos are not allowed. Use local assets; dynamic code execution, sensitive APIs and external resources are rejected by the script scan.
  • Reuse local credentials after the first sign-in. Keep the local files if upload fails and retry after fixing the issue.
  • Open the returned public URL and check the preview, title, configuration and download. For later edits, ask Codex to update the existing work rather than create a duplicate.