Holo Card skill
The skill builds an interactive holographic card from an image: parallax layers, contour glow, offline HTML and a ZIP.
- 277 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The installer replaces the skill folder, and API mode can make paid calls with a provider key.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/holo-cardDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The installer replaces the skill folder, and API mode can make paid calls with a provider key.
This is third-party code. Review the repository files before installing.
What it does
Holo Card is a Codex skill with an optional local API service. The agent takes an attached image and splits it into a coloured foreground, a reconstructed background, a text and frame layer, and contours, then assembles a standalone `index.html` page and a `card.zip` archive. A card rotates with the mouse and flips on click, parallax depth runs from minus 3 to plus 3 and contour glow from 0 to 3. Invoke the skill with `$holo-card`. The local helper `native.py` saves jobs, validates layers and assembles output, while the layers themselves come from Codex's built-in image tool.
Who it is for. Designers and collectible-card authors who want to turn finished artwork into an interactive web card without separating layers by hand.
Good fit when
- Character artwork should appear with a holographic-card effect.
- A mockup must reach a client as one offline file.
- Background areas hidden behind text are reconstructed, not redrawn.
- Effect depth is tuned with a slider and previewed in the browser.
- A series of cards is built through the local service.
Not a fit when
- You lack rights to process and publish the source image.
- The agent environment cannot generate images.
- A real 3D model is needed rather than flat parallax layers.
Example request
$holo-card Turn this image into an interactive holographic card.Limitations
Pixels hidden under lettering are reconstructed approximately, so check lettering, shape alignment and mask edges by eye. The renderer is flat, not 3D. Python with Pillow, filesystem access, a browser and image generation are required, and availability depends on the Codex environment. The API service needs Node.js 24+, pnpm and a provider key, with paid calls enabled only explicitly. Job files keep source images, so store them outside public repositories.
How to disable. Delete `~/.codex/skills/holo-card` and stop the local server. Job outputs live elsewhere, so delete them manually.
FAQ
Is a Gemini key needed?
No. The skill uses Codex's built-in image tool. Only the local API service needs a provider key.
What is inside the archive?
`card.zip` holds the HTML and card layers, while `index.html` works offline on its own.
How is the effect controlled?
Depth runs from minus 3 to plus 3, contour glow from 0 to 3, and the card rotates by dragging and flips on click or Enter.
How is a double charge avoided in API mode?
After a paid-call timeout reuse the existing idempotency key and inspect status; a new job is never started automatically.
What license applies?
MIT. Dependencies keep their own licenses, and artwork belongs to its owners.
Discussion
No questions or reviews yet.
Related
SkillsHolo Card Studio builds a collectible holographic card from four image layers, a Blender scene and a Three.js web viewer.
A skill that turns one sentence or a reference image into a 3D holographic card web page and an editable Blender project
A Codex skill that redraws your photo as a watercolor illustration on white paper, with wide margins and a handwritten caption
A Codex skill that builds an animated companion from two or more of your photos and generates it on your own machine
A Codex skill that renders images, SVGs and scripts as hand-drawn whiteboard videos, with 30 styles and narration
A skill that turns a topic into a short animated card with facts from found sources and Live Photo assets for the iPhone
README in short
The project is an independent implementation of the idea; the original author is credited without implied endorsement. Artwork in the demo belongs to its owners.