Agent skill

M5Paper Card Widgets

by op7418 in op7418/ai-desk-card

Pushes glanceable info such as todos, calendar, weather and AI status to an M5Paper e-ink desk card through a local daemon, picking slots and widget types.

Custom licenceAuto-check: notesProductivity & Automation

Install M5Paper Card Widgets

skills CLI
$ npx skills add op7418/ai-desk-card --skill card-widget -a claude-code

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

GitHub CLI
$ gh skill install op7418/ai-desk-card card-widget --agent claude-code

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

Manual copy
$ git clone --depth 1 https://github.com/op7418/ai-desk-card.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugin/skills/card-widget .claude/skills/card-widget && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

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

Facts

Skill name
card-widget
GitHub stars
151
Token cost
~3k tokens
SKILL.md length
1,020 words
Files
23 (incl. scripts)
Skills in repo
4
Repo updated
First seen
Licence
Custom licence

At a glance

Pushes glanceable info such as todos, calendar, weather and AI status to an M5Paper e-ink desk card through a local daemon, picking slots and widget types.

  • Works in 4 steps: Ask user what's most important (or infer… → One headline widget → middle. The… → Two glance widgets → top-left +… → …
  • Showing today's calendar, next meeting or todos on a desk e-ink display
  • SKILL.md covers Transport & latency (v0.8), Layout cheat-sheet, Widget catalog and Disambiguation — common…, plus 5 more sections
  • Runs Python scripts from its folder; calls curl and bash

What it does

The card is a 540 × 960 e-ink panel placed beside the monitor. The agent picks from 16 widget types, fills in data that matches each widget's JSON schema, and posts one to four widgets to a local daemon, by default at 127.0.0.1:9877, which renders a single frame. Traffic stays on loopback, so individual widget writes do not trigger approval prompts in the agent.

The screen has four slots. The two top slots are 270 px wide and suit glance widgets such as weather, inbox, ai-status or git-status. The middle slot is the largest and takes the headline widget (calendar, focus or next-meeting), and the bottom slot holds list-style widgets like todo, deadlines, pr-queue or messages. If you have no preference, the default puts weather top-left and ai-status top-right.

Update frequency matters on e-ink. Changing one widget's content is fine, but streaming per keystroke is ruled out because every push refreshes the panel and wears it over time. ai-status gets one push at the start and one at the end, and live timers at most every 30 seconds. The daemon picks Wi-Fi, USB or BLE at startup: a single-widget update takes about 0.2 s over Wi-Fi but much longer on USB, where a full frame takes about 32 s, so the skill suggests /card-wifi-setup. Two Python scripts fetch notifications and todo reminders.

When your agent uses it

  • Showing today's calendar, next meeting or todos on a desk e-ink display
  • Putting AI task status, git status or a PR queue on a secondary screen
  • Choosing which four widgets and slots the card should show

Example prompts

  • “Show my next meeting in the middle slot of the card and weather in the top left.”
  • “Put my todo list on the e-ink display and refresh it when I finish tasks.”
  • “Push an ai-status widget to the card when you start this refactor and again when it's done.”

Requirements

  • An M5Paper ai-desk-card with its local daemon running
  • Python for the bundled fetch scripts
  • Pre-approved tools (allowed-tools): Bash, Read, Write

Workflow steps

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

  1. Ask user what's most important (or infer from context). The card
  2. One headline widget → middle. The biggest, most readable slot.
  3. Two glance widgets → top-left + top-right. Pick widgets whose
  4. One detail widget → bottom. Lists, multi-row info (todo, deadlines,

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Write

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • curl
    • bash

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

  • Network

    No URLs in SKILL.md. Its commands use curl, 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.

Context cost

M5Paper Card Widgets loads about 3k tokens when it runs. Until then it costs about 120 tokens; SKILL.md has 1,020 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Write

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,020 words (~2,961 tokens).

“The card is a 540 × 960 e-ink panel sitting next to the user's monitor. You push 1-4 widgets and the daemon renders a single frame; transfer time depends on the transport.”

— opening of SKILL.md by op7418, Custom licence
name
card-widget
allowed-tools
Bash, Read, Write
trigger_keywords
card widget, 卡片, 副屏, 墨水屏, paper card, 显示器副屏, secondary display

Read the full SKILL.md on GitHub

Files

SKILL.md and 22 other files (scripts) in plugin/skills/card-widget of op7418/ai-desk-card.

  • SKILL.md
  • schemas/ai-status.schema.json
  • schemas/ai-tasks.schema.json
  • schemas/break-reminder.schema.json
  • schemas/calendar.schema.json
  • schemas/deadlines.schema.json
  • schemas/focus.schema.json
  • schemas/git-status.schema.json
  • schemas/inbox.schema.json
  • schemas/messages.schema.json
  • schemas/next-meeting.schema.json
  • schemas/now-playing.schema.json
  • schemas/pr-queue.schema.json
  • schemas/scratch.schema.json
  • schemas/system.schema.json
  • schemas/todo.schema.json
  • schemas/weather.schema.json
  • scripts/fetch_notifications.py
  • scripts/fetch_todo_reminders.py
  • … and 4 more

Open the folder on GitHubat commit dc3b498

Compare with similar skills

M5Paper Card Widgets 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.

M5Paper Card Widgets compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
M5Paper Card Widgets this skillop7418/ai-desk-card151—~3kAutomated safety check: NotesCustom licence
Agent Browser CLIvercel-labs/agent-browser44k24 repos~864Automated safety check: PassApache-2.0
Agent Browserquran/quran.com-frontend-next1.9k40 repos~3.3kAutomated safety check: PassNone
Web Access via Browser CDPeze-is/web-access9.1k4 repos~2.2kAutomated safety check: PassMIT
Dev Browser AutomationMemTensor/MemOS12k3 repos~1.7kAutomated safety check: PassApache-2.0
Agent ReachPanniantong/Agent-Reach94k—~1.4kAutomated safety check: PassMIT

Similar skills

  • Agent Browser CLI

    vercel-labs/agent-browser

    Official

    Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking…

    44k GitHub starsUsed in 24 repos~864 tokens
    Productivity & AutomationAuto-check passed
  • Agent Browser

    quran/quran.com-frontend-next

    Automates browser interactions for web testing, form filling, screenshots, and data extraction.

    1.9k GitHub starsUsed in 40 repos~3.3k tokens
    Productivity & AutomationAuto-check passed
  • Routes every web task, from searching to logged-in browsing, through a tiered choice of search, fetch, curl or a real Chrome or Edge session driven over CDP.

    9.1k GitHub starsUsed in 4 repos~2.2k tokens
    Productivity & AutomationAuto-check passed
  • Dev Browser Automation

    MemTensor/MemOS

    Automates a real browser through short TypeScript scripts that keep page state between runs, for navigating, filling forms, taking screenshots and extracting data.

    12k GitHub starsUsed in 3 repos~1.7k tokens
    Productivity & AutomationAuto-check passed
  • Agent Reach

    Panniantong/Agent-Reach

    Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool.

    94k GitHub stars~1.4k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Perform Task

    telegramdesktop/tdesktop

    Resolve, start or resume, implement, review, test, and publish exactly one existing ai-tdesktop task by short slug or full dated id, including rare blocked retries and split-required results.

    33k GitHub starsUsed in 2 repos~3k tokens
    Productivity & AutomationAuto-check passed

More from op7418/ai-desk-card

  • AI Desk Card

    op7418/ai-desk-card

    Drives an M5Paper e-ink desk display from an agent: probes device state, guides first-time setup, and pushes widgets such as calendar, todos and weather.

    151 GitHub stars~2k tokensUpdated 4 mo ago
    Auto-check: notes
  • AI Desk Card Onboarding

    op7418/ai-desk-card

    Walks a user through first-time setup of an AI Desk Card e-ink device, probing daemon, USB, BLE, Wi-Fi and firmware state and fixing whatever is missing.

    151 GitHub stars~1.2k tokensUpdated 4 mo ago
    Auto-check: notes
  • AI Desk Card Wi-Fi Setup

    op7418/ai-desk-card

    Walks a user through putting an AI Desk Card e-ink device on home Wi-Fi so frames arrive in about 0.2 seconds instead of the 32 seconds USB takes.

    151 GitHub stars~680 tokensUpdated 4 mo ago
    Auto-check: notes

Questions about M5Paper Card Widgets

What does M5Paper Card Widgets do?

Pushes glanceable info such as todos, calendar, weather and AI status to an M5Paper e-ink desk card through a local daemon, picking slots and widget types. The card is a 540 × 960 e-ink panel placed beside the monitor.1:9877, which renders a single frame.

When should I use M5Paper Card Widgets?

M5Paper Card Widgets fits situations like: showing today's calendar, next meeting or todos on a desk e-ink display; putting AI task status, git status or a PR queue on a secondary screen; choosing which four widgets and slots the card should show.

How do I install M5Paper Card Widgets in Claude Code?

Run `npx skills add op7418/ai-desk-card --skill card-widget -a claude-code`. Or copy the skill folder (plugin/skills/card-widget in op7418/ai-desk-card) into .claude/skills/card-widget in your project. Claude Code loads it when a task matches its description.

How do I install M5Paper Card Widgets in Codex?

Run `npx skills add op7418/ai-desk-card --skill card-widget -a codex`. Or copy the skill folder (plugin/skills/card-widget in op7418/ai-desk-card) into .agents/skills/card-widget in your project. Codex loads it when a task matches its description.

Can I use M5Paper Card Widgets 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 op7418/ai-desk-card --skill card-widget -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/card-widget, .gemini/skills/card-widget, .github/skills/card-widget and .opencode/skills/card-widget in your project.

What does M5Paper Card Widgets need to run?

Going by SKILL.md and its folder, M5Paper Card Widgets needs Python for the scripts in its folder and the command-line tools its instructions call (curl and bash). Our summary lists: An M5Paper ai-desk-card with its local daemon running; Python for the bundled fetch scripts. Its frontmatter pre-approves these tools: Bash, Read, Write.

Does M5Paper Card Widgets access the network?

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

Is M5Paper Card Widgets safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. 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 M5Paper Card Widgets use?

M5Paper Card Widgets has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does M5Paper Card Widgets use?

About 3k tokens (SKILL.md is roughly 12k 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 M5Paper Card Widgets?

Skills that share tags, products or a category with M5Paper Card Widgets: Agent Browser CLI (vercel-labs/agent-browser, 44k stars), Agent Browser (quran/quran.com-frontend-next, 1.9k stars), Web Access via Browser CDP (eze-is/web-access, 9.1k stars) and Dev Browser Automation (MemTensor/MemOS, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains M5Paper Card Widgets?

op7418 (a GitHub user) maintains it in op7418/ai-desk-card, which has 151 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on May 22, 2026.

Source: op7418/ai-desk-card on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.