card-refresh

Refresh existing widgets by re-fetching data and pushing updates via the card-widget API.

136|10|Updated May 21, 2026
One-click install
npx skills add https://github.com/op7418/ai-desk-card --skill card-refresh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: card-refresh
Source: https://github.com/op7418/ai-desk-card/tree/main/plugin/skills/card-refresh
Command: npx skills add https://github.com/op7418/ai-desk-card --skill card-refresh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yaml, psutil, and includes scripts (resource) components.

What problem does it solve?

Keeps the ai-desk-card's widgets current by re-fetching data and pushing updates only when needed, eliminating manual refresh work and stale information on the e-ink display.

Core Features & Use Cases

  • Selective refresh: updates only the widgets currently displayed on the card, avoiding unnecessary data fetches.
  • Cron or on-demand: supports scheduled refreshes (e.g., every 2 hours) or user-initiated requests to update widgets like weather, system, and more.
  • Fast, safe pushes: reads the current widget cache, fetches fresh data from configured sources, and pushes updates via the card-widget API without overwriting untouched content.

Quick Start

Schedule a cron job to run the card-refresh skill so widgets on the ai-desk-card are refreshed with fresh data.

Frequently Asked Questions about card-refresh

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically refresh e-ink widget data on a scheduled cron interval?

You can automatically refresh e-ink widget data by scheduling a cron job to run this skill, which re-fetches current widget data and pushes updates to the card display without manual intervention.

What is selective widget refresh and how does it work for AI desk cards?

Selective widget refresh reads the current widget cache and updates only the widgets currently displayed on the AI desk card, avoiding unnecessary data fetches while respecting data availability.

Does card-refresh work with weather and system widgets on e-ink displays?

Yes, this skill supports refreshing weather, system, and other widgets on e-ink displays by re-fetching data from configured sources and pushing updates via the card-widget API.

Can I trigger widget updates on demand or do I need a scheduled cron job?

You can trigger widget updates both ways: through scheduled cron-driven refresh workflows or via interactive on-demand prompts to update weather, system, and other widgets when needed.

What's the best way to keep ai-desk-card widgets current without overwriting untouched content?

The best way is using a skill that reads the existing widget cache, fetches fresh data only for displayed widgets, and pushes safe updates via the card-widget API without overwriting untouched content.

Why does my widget refresh skip certain widgets during the update push?

The refresh skill only updates widgets currently displayed on the card and respects data availability, so widgets not in the current cache or lacking fresh data sources will be skipped.