Agent skill

Apple Bento Grid

by hubeiqiao in hubeiqiao/apple-bento-grid

Create Apple-inspired bento grid presentation cards for showcasing project stats, timelines, and achievements.

MITAuto-check passedMedia & Creative

Install Apple Bento Grid

skills CLI
$ npx skills add hubeiqiao/apple-bento-grid --skill apple-bento-grid -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hubeiqiao/apple-bento-grid apple-bento-grid --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
apple-bento-grid
GitHub stars
236
Token cost
~2.8k tokens
SKILL.md length
1,458 words
Files
34 (incl. scripts)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Create Apple-inspired bento grid presentation cards for showcasing project stats, timelines, and achievements.

  • Works in 10 steps: Read the design system selectively:… → Gather the user's content — what stats,… → Choose a theme — suggest light, dark, or… → …
  • The user asks to build stat cards
  • SKILL.md covers Problem, Overview, Workflow and Visual Review, plus 12 more sections
  • Calls npm, npx and node

What it does

Apple Bento Grid is an agent skill from hubeiqiao/apple-bento-grid. Create Apple-inspired bento grid presentation cards for showcasing project stats, timelines, and achievements. Generates self-contained HTML files with zero-gap grids, stat cards, pill tags, bar charts, and dark quote cards — optimized for screenshot export. Supports both light (Apple signature f5f5f7) and dark (000) themes. Use when the user asks to build stat cards, bento grids, project summary cards, dashboard cards, Apple-style presentation layouts, project overviews, achievement showcases, or any visual…

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 36 other files, including scripts (for example `.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json` and `README.md`). Compatibility notes: Requires internet for Google Fonts. Optional Playwright for screenshot export.

It sits in Media & Creative, covering Infographics, Slides and decks and Project management. The repository describes itself as: Agent skill that generates Apple-inspired bento grid presentation cards. For Claude Code, Codex, and any AI coding agent. The licence is MIT.

When your agent uses it

  • The user asks to build stat cards
  • Project summary cards
  • Dashboard cards
  • Apple-style presentation layouts

Example prompts

  • “/apple-bento-grid”

Requirements

  • Node.js
  • Compatibility (from SKILL.md): Requires internet for Google Fonts. Optional Playwright for screenshot export.

Workflow steps

10 steps, taken from the first numbered list in SKILL.md.

  1. Read the design system selectively: Reference design-system.md as needed
  2. Gather the user's content — what stats, milestones, categories, and quotes to showcase
  3. Choose a theme — suggest light, dark, or both based on the context (see Theme Selection below)
  4. Choose a layout — pick from the 3 layout templates based on card count and orientation
  5. Compose cards — select card types and fill with the user's content; prioritize density (no empty-feeling cards)
  6. Ask about logos/images — if the user has a logo or images, incorporate them (see Logos & Images below)
  7. Generate the HTML — produce a single self-contained HTML file
  8. Visual review — open the HTML in a browser and screenshot it to check for issues (see Visual Review below)
  9. Offer a vertical version — after generating a landscape grid, ask: "Want a vertical (portrait) version for social media?" and generate a…
  10. Screenshot (optional) — use the Playwright script to capture PNGs at 2x

What it can do on your machine

Read from SKILL.md and the folder at commit 235f740. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • npm
    • npx
    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm and npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires internet for Google Fonts. Optional Playwright for screenshot export.

    From compatibility in the SKILL.md frontmatter.

Context cost

Apple Bento Grid loads about 2.8k tokens when it runs. Until then it costs about 169 tokens; SKILL.md has 1,458 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~169
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from hubeiqiao/apple-bento-grid at commit 235f740, republished under its MIT licence (© hubeiqiao). 1,458 words, ~2,809 tokens.

Download SKILL.mdSave it as .claude/skills/apple-bento-grid/SKILL.md (or your agent's skills folder). This skill also uses 33 other files; get the full folder from GitHub.
name
apple-bento-grid
description
Create Apple-inspired bento grid presentation cards for showcasing project stats, timelines, and achievements. Generates self-contained HTML files with zero-gap grids, stat cards, pill tags, bar charts, and dark quote cards — optimized for screenshot export. Supports both light (Apple signature #f5f5f7) and dark (#000) themes. Use when the user asks to build stat cards, bento grids, project summary cards, dashboard cards, Apple-style presentation layouts, project overviews, achievement showcases, or any visual summary of numbers and milestones. Also use when the user wants to create slides, infographics, or visual reports with a clean Apple aesthetic.
compatibility
Requires internet for Google Fonts. Optional Playwright for screenshot export.
license
MIT
metadata.author
Joe Hu
metadata.version
1.0.0
metadata.date
2026-03-17

Apple Bento Grid

Problem

Creating visually polished presentation graphics typically requires design tools like Figma or Keynote. This skill generates Apple-quality bento grid layouts as self-contained HTML files that screenshot into pixel-perfect images — no design tool needed.

Overview

Generate self-contained HTML files that render Apple-inspired bento card grids. Each output is a single HTML file with inline CSS — no dependencies except Google Fonts. Cards fill a tight CSS grid with minimal gaps, ready for Playwright screenshot export at 2x resolution. Both light and dark themes are available.

Workflow

  1. Read the design system selectively: Reference design-system.md as needed:
    • Always read: Section 2 (Zero-Gap Grid) + Section 3 (Layout Templates) — the grid foundation
    • Read per card type: Section 5.1–5.7 as needed for the cards you're using
    • Read for theme: Section 1 (light tokens) or Section 9 (dark tokens)
    • Read once for first generation: Section 8 (HTML Skeleton) as a structural starting point
  2. Gather the user's content — what stats, milestones, categories, and quotes to showcase
  3. Choose a theme — suggest light, dark, or both based on the context (see Theme Selection below)
  4. Choose a layout — pick from the 3 layout templates based on card count and orientation
  5. Compose cards — select card types and fill with the user's content; prioritize density (no empty-feeling cards)
  6. Ask about logos/images — if the user has a logo or images, incorporate them (see Logos & Images below)
  7. Generate the HTML — produce a single self-contained HTML file
  8. Visual review — open the HTML in a browser and screenshot it to check for issues (see Visual Review below)
  9. Offer a vertical version — after generating a landscape grid, ask: "Want a vertical (portrait) version for social media?" and generate a Template C adaptation if yes
  10. Screenshot (optional) — use the Playwright script to capture PNGs at 2x

Visual Review

After generating the HTML, always view the output to catch visual issues before presenting to the user. Use Playwright, browser MCP tools, or open to render the file, then check for:

Orphan lines — A single pill tag or word wrapping alone to a new row. Fix by removing one pill so the remaining pills fill evenly, or add enough pills to fill two full rows.

Empty space — Cards that look sparse with too much whitespace. Fix by adding a subtitle, badge, or extra description text to fill the card.

Text overflow — Numbers or labels that are too long for their card width. Fix by reducing font-size or abbreviating (e.g., "$2.4M" not "$2,400,000").

Broken grid — Visible row gaps or misaligned cards. Check: no align-items: start, gap is exactly 6px, all grid cells are occupied.

Font fallback — Text rendering in system fonts instead of Sora/DM Sans. Ensure Google Fonts link is present and page has network access.

Screenshot clipping — Right or bottom edges of cards cut off in the exported PNG. Fix by ensuring viewport width matches the grid CSS width exactly and the clip uses box.x/box.y from boundingBox(), not x: 0, y: 0.

If any issues are found, fix the HTML and re-check. Do not present to the user until the output passes visual review.

Theme Selection

Suggest a theme based on context. When unsure, generate both.

ContextSuggested Theme
Slide deck / presentationDark — higher visual impact on projectors
Social media / portfolioDark — stands out in feeds
Report / document embedLight — matches white page backgrounds
Print / PDFLight — saves ink, better legibility
User says "Apple style"Light — Apple's signature look
User says "modern" or "sleek"Dark — contemporary feel
No preference statedBoth — generate two files, let user choose

See design-system.md Section 9 for complete dark theme tokens, or Section 1 for light theme tokens.

Output Format

Always produce a single self-contained HTML file with:

  • <!DOCTYPE html> + <html lang="en">
  • Google Fonts <link> tags in <head>
  • All CSS in a single <style> block
  • All content in <body> — no JavaScript needed

Card Types Available

CardUse ForKey Feature
HeroTaglines, headlinesGradient top-border, spans 2 rows
StatNumbers + labelsColor-coded accent per category
CategoryGrouped items (phases, teams, quarters)Color label + subtitle + pill tags
Bar ChartGrowth / comparison over timeGradient bars, header badge
BadgeTool attribution, featured calloutIcon pill + stat number
QuoteMission statement, testimonialDark bg, white text, green <em>
HighlightHero number (3x, 10x, 100%)Full-gradient background

Layout Templates

TemplateColumnsWidthAspect RatioBest For
A: Horizontal4-col1200px52/2512-16 cards, slides
B: Horizontal3-col1100px52/228-10 cards, focused
C: Vertical2-col600pxnone (content)8-14 cards, social

Critical: Zero-Gap Grid Rules

These 5 rules are mandatory for Apple-like appearance. See design-system.md Section 2 for details.

  1. NEVER set align-items: start — default stretch fills cells
  2. Use aspect-ratio on horizontal layouts to lock container shape
  3. Rows: 1fr for horizontal, auto for vertical
  4. Gap: 6px (not 8px)
  5. Every grid cell must be occupied — no empty cells
Show full SKILL.md (654 more words)Show less

Screenshot Export

Use the Playwright script at scripts/screenshot.mjs to capture pixel-perfect PNGs.

bash
cd scripts
npm install
npx playwright install chromium
node screenshot.mjs

Edit the pages array in screenshot.mjs to point to your HTML files. Each entry needs: file (HTML path), output (PNG path), viewportWidth (match grid width).

Critical: Viewport must match grid width. If the viewport is wider than the grid, the grid gets centered and the clip can cut off the right edge. Always set viewportWidth to the exact grid CSS width (1200 for 4-col, 1100 for 3-col, 600 for 2-col).

Critical: Clip must use element position. When clipping to the grid element, use box.x and box.y from boundingBox(), not x: 0, y: 0. If the grid is centered in a wider viewport, x: 0 will start the clip before the grid and cut off the right side.

After screenshotting, always view the output image to verify no edges are clipped. Check that the rightmost and bottommost cards are fully visible with their border-radius intact.

Logos & Images

Users can add their own logos or images to bento grid cards. Ask the user if they have any logos or images they'd like included.

Placement options:

LocationHowBest For
Hero card corner<img> with position: absolute; top: 20px; right: 20px; width: 40px;Company logo
Badge card iconReplace the SVG in .badge-pill with an <img> tag (width: 16px; height: 16px; border-radius: 4px;)Tool/framework logo
Full card backgroundbackground-image: url(...) with overlay gradient for text readabilityFeature screenshots
Standalone image card<img> filling the card with object-fit: cover; border-radius: 18px;Product photos

Guidelines:

  • Use <img src="path/to/file.png"> with a local file path — the HTML is for screenshot export, not hosting
  • Keep logos small (24–48px) so they don't dominate the card
  • For dark theme, ensure logos work on dark backgrounds (use white/light versions)
  • Always add alt text for accessibility

Content Adaptation

User's DataRecommended TemplateCard Mix
3–5 stats, no categoriesC (2-col vertical)1 Hero + 3–5 Stats + 1 Quote
6–8 stats, 1–2 categoriesB (3-col horizontal)1 Hero + 4–6 Stats + 1–2 Categories + 1 Chart
8–12 stats, 3+ categoriesA (4-col horizontal)Full mix: Hero, Stats, Categories, Chart, Badge, Quote, Highlight
Social / portrait formatC (2-col vertical)Any mix, smaller fonts

Density rule: Every card should feel full. If a card looks sparse, add a subtitle, badge, or pill tags. If the grid has visible empty space, either span a card across cells or add a supporting card.

Customization Checklist

  1. Gather content — stats, categories, milestones, quotes
  2. Choose theme — light, dark, or both
  3. Choose layout — 4-col, 3-col, or 2-col
  4. Name grid areas — readable names matching content
  5. Select card types — Hero, Stat, Category, Chart, Badge, Quote, Highlight
  6. Assign accent colors — one per category, max 3–4 accents
  7. Set dimensions — viewport width matches grid width
  8. Lock aspect ratio — horizontal only; omit for vertical
  9. Verify density — no empty-feeling cards, no unused grid cells, gap 6px
  10. Scale for orientation — vertical gets smaller fonts, padding, radius
  11. Screenshot — Playwright at 2x, viewport matches grid width

Verification

After generating a bento grid HTML file:

  1. Open in Chrome or Safari — verify all grid cells are filled with no visible row gaps
  2. Check font loading — Sora and DM Sans should render (not system fallback)
  3. For dark theme — verify card backgrounds are #1a1a1a, not #fff
  4. Screenshot at the correct viewport width (1200/1100/600) at 2x resolution
  5. Confirm density — no card should have excessive whitespace

Notes

  • Google Fonts requires internet access; grids fall back to system fonts offline
  • Playwright screenshot is optional; users can take manual browser screenshots
  • aspect-ratio is only for horizontal layouts; vertical layouts flow from content height
  • Maximum 3–4 accent colors per grid to maintain Apple-like restraint
  • This skill produces static HTML for screenshot export, not interactive dashboards
  • For grids with fewer than 6 data points, Template C (2-col vertical) usually works best

Reference Files

© hubeiqiao, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 33 other files (scripts) in the repository root of hubeiqiao/apple-bento-grid.

  • SKILL.md
  • .claude-plugin/marketplace.json
  • .claude-plugin/plugin.json
  • .gitignore
  • LICENSE
  • README.md
  • design-system.md
  • evals/evals.json
  • examples/dark-horizontal.html
  • examples/dark-horizontal.png
  • examples/light-horizontal.html
  • examples/light-horizontal.png
  • examples/light-vertical.html
  • examples/light-vertical.png
  • examples/real-cny-2026-square.html
  • examples/real-cny-2026-square.png
  • examples/real-corpus-dark-horizontal.html
  • examples/real-corpus-dark-horizontal.jpg
  • … and 16 more

Open the folder on GitHubat commit 235f740

Compare with similar skills

Apple Bento Grid next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Apple Bento Grid compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Apple Bento Grid this skillhubeiqiao/apple-bento-grid236—~2.8kAutomated safety check: PassMIT
Strategy Consulting Visualizationkgraph57/mckinsey-style-visualization-skill129—~3.2kAutomated safety check: PassMIT
Visual Explainernicobailon/visual-explainer10k—~3.5kAutomated safety check: PassMIT
Guizang Material Illustrationop7418/guizang-material-illustration1.2k—~1.6kAutomated safety check: PassNone
Gemini Carouselcharlie947/social-media-skills3.8k—~1.7kAutomated safety check: PassMIT
Img2pptxLancelot-Xie/img2pptx163—~5.9kAutomated safety check: PassApache-2.0

Similar skills

  • Strategy Consulting Visualization

    kgraph57/mckinsey-style-visualization-skill

    A skill your agent uses when turning any content into clear, professional visualizations - board slides, reports, proposals, research summaries, training materials, technical diagrams, infographics…

    129 GitHub stars~3.2k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Visual Explainer

    nicobailon/visual-explainer

    Turns systems, code changes, plans and data into self-contained HTML pages where figures carry the explanation, with options for slide decks and narrated MP4 videos.

    10k GitHub stars~3.5k tokensUpdated today
    Media & CreativeAuto-check passed
  • Guizang Material Illustration

    op7418/guizang-material-illustration

    Generate Guizang-style material illustrations, labeled explanatory visuals, material-styled chart illustrations, and data-first editorial images from articles, notes, product concepts, workplace…

    1.2k GitHub stars~1.6k tokensUpdated 3 mo ago
    Media & CreativeAuto-check passed
  • Gemini Carousel

    charlie947/social-media-skills

    Generate a branded slide-by-slide LinkedIn carousel using Gemini.

    3.8k GitHub stars~1.7k tokensUpdated 26 days ago
    Media & CreativeAuto-check passed
  • Img2pptx

    Lancelot-Xie/img2pptx

    Reconstruct raster reference images as one-slide editable, modular, auditable PPTX files containing a complete SVG.

    163 GitHub stars~5.9k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Carousels

    TheCraigHewitt/skills

    Turns a piece of Craig's content (an email, a YouTube script, an essay, or pasted text) into a polished image carousel publishable to both LinkedIn and Instagram from one set of 1080x1350 slides.

    159 GitHub stars~2.3k tokensUpdated 4 mo ago
    Media & CreativeAuto-check passed

Questions about Apple Bento Grid

What does Apple Bento Grid do?

Create Apple-inspired bento grid presentation cards for showcasing project stats, timelines, and achievements. Apple Bento Grid is an agent skill from hubeiqiao/apple-bento-grid. Create Apple-inspired bento grid presentation cards for showcasing project stats, timelines, and achievements.

When should I use Apple Bento Grid?

Apple Bento Grid fits situations like: the user asks to build stat cards; project summary cards; dashboard cards; apple-style presentation layouts.

How do I install Apple Bento Grid in Claude Code?

Run `npx skills add hubeiqiao/apple-bento-grid --skill apple-bento-grid -a claude-code`. Or copy the skill folder (the hubeiqiao/apple-bento-grid repository) into .claude/skills/apple-bento-grid in your project. Claude Code loads it when a task matches its description.

How do I install Apple Bento Grid in Codex?

Run `npx skills add hubeiqiao/apple-bento-grid --skill apple-bento-grid -a codex`. Or copy the skill folder (the hubeiqiao/apple-bento-grid repository) into .agents/skills/apple-bento-grid in your project. Codex loads it when a task matches its description.

Can I use Apple Bento Grid in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hubeiqiao/apple-bento-grid --skill apple-bento-grid -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/apple-bento-grid, .gemini/skills/apple-bento-grid, .github/skills/apple-bento-grid and .opencode/skills/apple-bento-grid in your project.

What does Apple Bento Grid need to run?

Going by SKILL.md and its folder, Apple Bento Grid needs the command-line tools its instructions call (npm, npx and node). Our summary lists: Node.js. Compatibility (from SKILL.md): Requires internet for Google Fonts. Optional Playwright for screenshot export..

Does Apple Bento Grid access the network?

SKILL.md contains no URLs. Its commands use npm and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Apple Bento Grid safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Apple Bento Grid use?

Apple Bento Grid is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Apple Bento Grid use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Apple Bento Grid?

Skills that share tags, products or a category with Apple Bento Grid: Strategy Consulting Visualization (kgraph57/mckinsey-style-visualization-skill, 129 stars), Visual Explainer (nicobailon/visual-explainer, 10k stars), Guizang Material Illustration (op7418/guizang-material-illustration, 1.2k stars) and Gemini Carousel (charlie947/social-media-skills, 3.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Apple Bento Grid?

hubeiqiao (a GitHub user) maintains it in hubeiqiao/apple-bento-grid, which has 236 GitHub stars. The repository was last updated on March 17, 2026.

Source: hubeiqiao/apple-bento-grid on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.