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.