Agent skill

AI Desk Card Wi-Fi Setup

by op7418 in 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.

Custom licenceAuto-check: notesDevelopment

SKILL.md written in Chinese; this summary is our English description.

Install AI Desk Card Wi-Fi Setup

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

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

GitHub CLI
$ gh skill install op7418/ai-desk-card card-wifi-setup --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-wifi-setup .claude/skills/card-wifi-setup && 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-wifi-setup
GitHub stars
151
Token cost
~680 tokens
SKILL.md length
226 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
Custom licence

At a glance

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.

  • Works in 4 steps: 跟用户要 SSID + 密码 → 推送 → 等 15-20 秒看结果 → …
  • Moving an AI Desk Card from USB to wireless frame updates
  • SKILL.md covers 先决条件, 流程, 失败诊断 and 架构提示, plus 1 more section
  • Calls bash

What it does

The skill takes the user's Wi-Fi name and password, writes them once to the device's NVS storage through the local daemon, and lets the device join the network and advertise over mDNS. After the daemon restarts and finds it, frames are pushed over Wi-Fi in about 0.2 seconds rather than USB's 32. It assumes the device already talks to the daemon over USB serial or a paired BLE link and that the daemon is running; otherwise the card-onboard flow comes first. Before asking, the agent states that the password stays local and is not written to logs or git or uploaded.

The steps are: collect the SSID, correcting an answer that looks like a MAC address; run the plugin's wifi_setup.sh script with the SSID quoted; wait 15 to 20 seconds and confirm through a probe script or the daemon log that the device connected and reported an IP; then run card-stop and card-start so the daemon rescans mDNS and switches transport. A status table covers SSID not found, authentication failure and DHCP failure. The most common cause is a dual-band router, since the ESP32 cannot use 5GHz and needs a 2.4GHz network. Routers defaulting to WPA3 may need mixed WPA2/WPA3 mode if connections keep failing.

When your agent uses it

  • Moving an AI Desk Card from USB to wireless frame updates
  • A user asks how to connect the card to their home Wi-Fi
  • Diagnosing a device that stays at wifi_connected false
  • Switching the daemon to the Wi-Fi transport after provisioning

Example prompts

  • “Set up Wi-Fi on my AI Desk Card so it stops relying on USB.”
  • “The card still reports wifi_connected false after I gave it my home network password. What is wrong?”
  • “我想用无线,帮我给 card 配 wifi。”

Requirements

  • An AI Desk Card device the daemon can reach over USB serial or BLE
  • The AI Desk Card daemon running
  • A 2.4GHz Wi-Fi network
  • Pre-approved tools (allowed-tools): Bash, AskUserQuestion

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. 跟用户要 SSID + 密码
  2. 推送
  3. 等 15-20 秒看结果
  4. 重启 daemon 切到 Wi-Fi transport

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
    • AskUserQuestion

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • bash

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

  • Network

    No URLs in SKILL.md.

    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

AI Desk Card Wi-Fi Setup loads about 680 tokens when it runs. Until then it costs about 89 tokens; SKILL.md has 226 words of instructions outside code blocks.

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

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, AskUserQuestion

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); files beside SKILL.md 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 226 words (~680 tokens).

“把 SSID + 密码喂到设备 NVS,设备自动连,daemon 通过 mDNS 发现 → 后续推帧 0.2 秒到位。”

— opening of SKILL.md by op7418, Custom licence
name
card-wifi-setup
allowed-tools
Bash, AskUserQuestion
trigger_keywords
配 wifi, 配 wi-fi, card 上 wifi, 卡片连 wifi, 无线连接, wifi setup, card wifi

Read the full SKILL.md on GitHub

Files

Just SKILL.md in plugin/skills/card-wifi-setup of op7418/ai-desk-card.

Open the folder on GitHubat commit dc3b498

Compare with similar skills

AI Desk Card Wi-Fi Setup 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.

AI Desk Card Wi-Fi Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
AI Desk Card Wi-Fi Setup this skillop7418/ai-desk-card151—~680Automated safety check: NotesCustom licence
RuView Hardware Setupruvnet/RuView97k—~1.8kAutomated safety check: NotesMIT
Esp32 Firmware Engineeralxv2016/folloup-sticky1161 repos~3.8kAutomated safety check: PassGPL-3.0
RuView mmWave Radar Setupruvnet/RuView97k—~907Automated safety check: NotesMIT
Embedded DebugFastLED/FastLED7.5k—~1.4kAutomated safety check: PassMIT
Auto EmbeddedDunCanYounG-1/MICU-auto-embedded253—~1.6kAutomated safety check: PassCC-BY-NC-4.0

Similar skills

  • Brings a RuView CSI sensing node online by building ESP32-S3 or ESP32-C6 firmware, flashing the board, provisioning WiFi and checking the serial output.

    97k GitHub stars~1.8k tokensUpdated today
    DevelopmentAuto-check: notes
  • Esp32 Firmware Engineer

    alxv2016/folloup-sticky

    ESP32 firmware engineering for ESP-IDF projects. An agent skill from alxv2016/folloup-sticky.

    116 GitHub starsUsed in 1 repo~3.8k tokens
    DevelopmentAuto-check passed
  • Sets up and runs 60 GHz and 24 GHz mmWave radar sensing on ESP32 boards in RuView, alone or fused with WiFi CSI.

    97k GitHub stars~907 tokensUpdated today
    DevelopmentAuto-check: notes
  • Embedded Debug

    FastLED/FastLED

    Firmware crash analysis, stack trace decoder, and register dump interpreter for ESP32/ARM/AVR platforms.

    7.5k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Auto Embedded

    DunCanYounG-1/MICU-auto-embedded

    全平台嵌入式 AI 开发框架(对标 Trellis):把 RIPER-5 五阶段协议 + 四文件记忆 + 分层架构门禁 + Scout/Builder/Verifier 多 Agent + 24 个工具调用技能(build/flash/debug/serial/can/modbus/visa/static/memory/rtos/scons),做成『装进工程、项目级 hook…

    253 GitHub stars~1.6k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Embedded Cpp14 Misra

    BlueAndi/Pixelix

    A skill your agent uses when writing, reviewing, or refactoring C/C++ firmware code in this repository (src/, lib/, test/) — creating or editing .h/.hpp/.cpp files, applying MISRA-oriented and…

    443 GitHub stars~2k tokensUpdated today
    DevelopmentAuto-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
  • M5Paper Card Widgets

    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.

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

Works with

Categories

Questions about AI Desk Card Wi-Fi Setup

What does AI Desk Card Wi-Fi Setup do?

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. The skill takes the user's Wi-Fi name and password, writes them once to the device's NVS storage through the local daemon, and lets the device join the network and advertise over mDNS.2 seconds rather than USB's 32.

When should I use AI Desk Card Wi-Fi Setup?

AI Desk Card Wi-Fi Setup fits situations like: moving an AI Desk Card from USB to wireless frame updates; A user asks how to connect the card to their home Wi-Fi; diagnosing a device that stays at wifi_connected false; switching the daemon to the Wi-Fi transport after provisioning.

How do I install AI Desk Card Wi-Fi Setup in Claude Code?

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

How do I install AI Desk Card Wi-Fi Setup in Codex?

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

Can I use AI Desk Card Wi-Fi Setup 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-wifi-setup -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-wifi-setup, .gemini/skills/card-wifi-setup, .github/skills/card-wifi-setup and .opencode/skills/card-wifi-setup in your project.

What does AI Desk Card Wi-Fi Setup need to run?

Going by SKILL.md and its folder, AI Desk Card Wi-Fi Setup needs the command-line tools its instructions call (bash). Our summary lists: An AI Desk Card device the daemon can reach over USB serial or BLE; The AI Desk Card daemon running; A 2.4GHz Wi-Fi network. Its frontmatter pre-approves these tools: Bash, AskUserQuestion.

Does AI Desk Card Wi-Fi Setup access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is AI Desk Card Wi-Fi Setup 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. Review the folder before installing.

What licence does AI Desk Card Wi-Fi Setup use?

AI Desk Card Wi-Fi Setup 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 AI Desk Card Wi-Fi Setup use?

About 680 tokens (SKILL.md is roughly 2.7k 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 AI Desk Card Wi-Fi Setup?

Skills that share tags, products or a category with AI Desk Card Wi-Fi Setup: RuView Hardware Setup (ruvnet/RuView, 97k stars), Esp32 Firmware Engineer (alxv2016/folloup-sticky, 116 stars), RuView mmWave Radar Setup (ruvnet/RuView, 97k stars) and Embedded Debug (FastLED/FastLED, 7.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains AI Desk Card Wi-Fi Setup?

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.