Back to search
page-mascot
SkillGitHub
A mascot that watches the cursor and blinks when you poke it
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/nilbuild--page-mascot)HTML
<a href="/listings/nilbuild--page-mascot"><img src="/api/listings/nilbuild--page-mascot/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
npm i page-mascot
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 97 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <img src=".github/fox.png" width="160" alt="">
- # page-mascot
- An interactive character that watches the cursor and blinks when you poke it.
- **[See the fifty-two →](https://koboyo.com/page-mascot)**
- ## Install
- ```bash
- npm i page-mascot
- ```
- ## Use existing mascots
- Pick a character on the [demo page](https://koboyo.com/page-mascot) and download its two
- sheets into `public/mascots`, then point the component at them:
- ```tsx
- import { Mascot } from 'page-mascot'
- <Mascot
- directions="/mascots/fox-directions.webp"
- reactions="/mascots/fox-reactions.webp"
- />
- ```
- The paths are whatever your app serves, so imported images work too.
- Or let an agent do it, once the skill below is installed:
- ```
- /page-mascot put the fox on my page
- ```
- ## Draw your own
- Install the skill:
- ```bash
- npx skills add nilbuild/page-mascot --skill page-mascot --global --yes
- ```
- Then ask your agent:
- ```
- /page-mascot a chibi otter with chocolate-brown fur
- /page-mascot make one that looks like me [attach a photo]
- /page-mascot a chibi fox, in the riso style
- ```
- It draws the nine directions and nine expressions, builds them into two aligned sheets,
- checks the character does not jump between them, and puts the component on your page, with
- the same two props as above.
- Drawing needs an image tool. Codex has its own; Claude Code goes through the OpenAI images
- API:
- ```bash
- export OPENAI_API_KEY=sk-...
- ```
- Or take the [prompts](skills/page-mascot/reference/prompts.md) and use them in any chat
- UI.
- ## Props
- | prop | default | |
- | --- | --- | --- |
- | `directions` | none | path to the directions sheet |
- | `reactions` | none | path to the reactions sheet |
- | `size` | `140` | px, square |
- | `label` | `'mascot'` | what a screen reader calls it |
- | `className` | | |
- Tracking switches off without a fine pointer, and the click squash honours
- `prefers-reduced-motion`.
- ## How it works
- Each character is two 3×3 sprite sheets: nine head directions, and nine expressions.
- 
- The pointer's angle picks a cell on the directions sheet, with a dead zone so the head
- settles when the cursor is close. A click shows a cell from the reactions sheet for half a
- second.
- The same character can be drawn in six styles: colour, ink, sketch, riso, paper and pixel.
- Only the rendering changes, so the alignment holds.
- 
- ## License
- MIT © [Kamran Ahmed](https://kamran.fyi)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.