Skip to content

feat: ship Lenis as a Codex and ChatGPT plugin - #545

Open
arzafran wants to merge 5 commits into
mainfrom
feat/agent-plugin
Open

arzafran wants to merge 5 commits into
mainfrom
feat/agent-plugin

Conversation

@arzafran

@arzafran arzafran commented Sep 30, 2026 •

Copy link
Copy Markdown
Member

What this does

Codex and ChatGPT can now answer Lenis questions from our own instructions instead of old training data. The repo becomes an installable plugin with one skill that covers setup, GSAP ScrollTrigger, Tempus ordering, and the mistakes people usually make. The same skill file also works in Claude Code and Cursor.

Part of #544.

Summary

Review in this order:

  1. skills/lenis/SKILL.md: the skill itself. Every snippet was checked against packages/* and satus's Lenis, GSAP, and Tempus wiring. The Tempus order, WebGL rounding, scroll-callback performance and sticky-pin guidance comes from our team-knowledge notes (lenis-first-in-tempus-order, hamo-scroll-trigger-floors-webgl-rect-rounds, no-layout-reads-in-frame-loops, css-custom-property-writes-per-frame-cost, sticky-first-scroll-pins, webgl-follows-a-dom-box, gate-offscreen-animations), with client names left out.
  2. plugin.json: Agent Plugins manifest. Listing fields sit under extensions.com.openai.interface, credited to Darkroom Engineering.
  3. .agents/plugins/marketplace.json: repo marketplace that points at the repo root.
  4. scripts/update-readme.js: keeps the plugin.json version on the published version during releases.

Test plan

  • codex plugin marketplace add darkroomengineering/lenis --ref feat/agent-plugin, then codex plugin add lenis@darkroomengineering: installs and shows installed, enabled 1.3.26
  • bun run readme leaves plugin.json at 1.3.26
  • bunx biome check plugin.json .agents scripts/update-readme.js passes
  • assets/icon.png is in the installed plugin (180×180 Lenis mark)
  • In a fresh Next.js app with the plugin installed, ask Codex to add Lenis with ScrollTrigger. It should import lenis/dist/lenis.css, use one frame driver, and set lagSmoothing(0)
  • Install through a local marketplace in ChatGPT and try one of the default prompts

@vercel

vercel Bot commented Sep 30, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
lenis-playground Ready Ready Preview Oct 1, 2026 1:42pm UTC

@arzafran
arzafran marked this pull request as ready for review October 1, 2026 13:17

@lsoengas lsoengas left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

This branch was successfully deployed

1 active deployment
Preview — 0fe4538a Deployed Oct 1, 2026 by vercel[bot]
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.

2 participants