Agent skill

Fix Board

by FastLED in FastLED/FastLED

Automatically diagnose and fix board upload/monitor issues. An agent skill from FastLED/FastLED.

MITAuto-check passedDevelopment

Install Fix Board

skills CLI
$ npx skills add FastLED/FastLED --skill fix-board -a claude-code

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

GitHub CLI
$ gh skill install FastLED/FastLED fix-board --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/FastLED/FastLED.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/fix-board .claude/skills/fix-board && 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
fix-board
GitHub stars
7.5k
Token cost
~392 tokens
SKILL.md length
147 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

Automatically diagnose and fix board upload/monitor issues. An agent skill from FastLED/FastLED.

  • Works in 6 steps: Compile: Run compilation using uv run… → Upload: Execute upload with automatic… → Monitor: Attach to serial monitor,… → …
  • Development work in your project
  • SKILL.md covers Using debug_attached.py, What Gets Fixed Automatically and What Requires Manual…
  • Calls uv

What it does

Fix Board is an agent skill from FastLED/FastLED. Automatically diagnose and fix board upload/monitor issues. Runs three-phase device workflow (Compile, Upload, Monitor) and applies fixes.

Its SKILL.md is about 390 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. The repository describes itself as: The FastLED library for colored LED animation on Arduino. Please direct questions/requests for help to the FastLED Reddit community: http://fastled.io/r We'd like to use github… The licence is MIT.

When your agent uses it

  • Development work in your project

Example prompts

  • “/fix-board”

Workflow steps

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

  1. Compile: Run compilation using uv run ci/debug_attached.py (compile phase only)
  2. Upload: Execute upload with automatic port conflict resolution
  3. Monitor: Attach to serial monitor, capture output for 10 seconds, detect failure keywords
  4. Diagnose: Identify upload failures, compilation errors, runtime crashes, ESP-IDF errors
  5. Fix: Automatically fix code, configuration, or suggest manual hardware fixes
  6. Verify: Re-test after applying fixes (up to 3 attempts)

What it can do on your machine

Read from SKILL.md and the folder at commit ce225ed. 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

    Shell commands in SKILL.md call:

    • uv

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

  • Network

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

Fix Board loads about 392 tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 147 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from FastLED/FastLED at commit ce225ed, republished under its MIT licence (© FastLED). 147 words, ~392 tokens.

Download SKILL.mdSave it as .claude/skills/fix-board/SKILL.md (or your agent's skills folder).
name
fix-board
description
Automatically diagnose and fix board upload/monitor issues. Runs three-phase device workflow (Compile, Upload, Monitor) and applies fixes.
disable-model-invocation
true
context
fork
agent
fix-board-agent

Automatically run the three-phase device workflow (Compile, Upload, Monitor), diagnose any failures, and apply fixes.

  1. Compile: Run compilation using uv run ci/debug_attached.py (compile phase only)
  2. Upload: Execute upload with automatic port conflict resolution
  3. Monitor: Attach to serial monitor, capture output for 10 seconds, detect failure keywords
  4. Diagnose: Identify upload failures, compilation errors, runtime crashes, ESP-IDF errors
  5. Fix: Automatically fix code, configuration, or suggest manual hardware fixes
  6. Verify: Re-test after applying fixes (up to 3 attempts)

Using debug_attached.py

bash
uv run ci/debug_attached.py esp32dev --timeout 10 --fail-on PANIC --fail-on "guru meditation"

What Gets Fixed Automatically

  • Upload failures: Port detection, permission issues, bootloader problems
  • Compilation errors: Missing includes, type errors, dependency issues
  • Configuration issues: Wrong board settings, incorrect platformio.ini parameters
  • Runtime crashes: Watchdog resets, brownout detection, stack overflows

What Requires Manual Intervention

  • Hardware issues: Physical wiring problems, power supply issues
  • Driver issues: Missing USB drivers, permission setup
  • Severe code issues: Major architecture problems requiring human decisions

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

Files

Just SKILL.md in .claude/skills/fix-board of FastLED/FastLED.

Open the folder on GitHubat commit ce225ed

Compare with similar skills

Fix Board 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.

Fix Board compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fix Board this skillFastLED/FastLED7.5k—~392Automated safety check: PassMIT
Vercel Composition Patternssupabase/supabase111k59 repos~726Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Typescript Advanced Typesrolling-scopes/rsschool-app10k25 repos~4.2kAutomated safety check: PassMPL-2.0
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Official

    React composition patterns that scale. An agent skill from supabase/supabase.

    111k GitHub starsUsed in 59 repos~726 tokens
    DevelopmentAuto-check passed
  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Typescript Advanced Types

    rolling-scopes/rsschool-app

    Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.

    10k GitHub starsUsed in 25 repos~4.2k tokens
    DevelopmentAuto-check passed
  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed

More from FastLED/FastLED

All 23 skills in this repo
  • CI Fix

    FastLED/FastLED

    Scan all CI builds and tests, find failures, fetch error logs, and fix the code.

    7.5k GitHub stars~897 tokensUpdated yesterday
    Auto-check passed
  • Driver Review

    FastLED/FastLED

    Review and implement hardware driver code — DMA safety, interrupt correctness, timing constraints, peripheral register usage, channel drivers, and peripheral mock implementations.

    7.5k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • 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 yesterday
    Auto-check passed
  • Esp32 Log Triage

    FastLED/FastLED

    Parse and classify ESP32 serial log output to identify FastLED-related errors, RMT/I2S/SPI driver faults, timing violations, RTOS issues, and crash signatures.

    7.5k GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed
  • Memory Audit

    FastLED/FastLED

    Audit embedded code for stack overflow risks, heap fragmentation, static allocation patterns, and memory leaks.

    7.5k GitHub stars~488 tokensUpdated yesterday
    Auto-check passed
  • Platform Port

    FastLED/FastLED

    Guide porting FastLED to new MCU platforms, including int.h types, clockless drivers, SPI implementations, and platform detection.

    7.5k GitHub stars~580 tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Fix Board

What does Fix Board do?

Automatically diagnose and fix board upload/monitor issues. An agent skill from FastLED/FastLED. Fix Board is an agent skill from FastLED/FastLED. Automatically diagnose and fix board upload/monitor issues.

When should I use Fix Board?

Fix Board fits situations like: development work in your project.

How do I install Fix Board in Claude Code?

Run `npx skills add FastLED/FastLED --skill fix-board -a claude-code`. Or copy the skill folder (.claude/skills/fix-board in FastLED/FastLED) into .claude/skills/fix-board in your project. Claude Code loads it when a task matches its description.

How do I install Fix Board in Codex?

Run `npx skills add FastLED/FastLED --skill fix-board -a codex`. Or copy the skill folder (.claude/skills/fix-board in FastLED/FastLED) into .agents/skills/fix-board in your project. Codex loads it when a task matches its description.

Can I use Fix Board 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 FastLED/FastLED --skill fix-board -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fix-board, .gemini/skills/fix-board, .github/skills/fix-board and .opencode/skills/fix-board in your project.

What does Fix Board need to run?

Going by SKILL.md and its folder, Fix Board needs the command-line tools its instructions call (uv).

Does Fix Board access the network?

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

Is Fix Board 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. Review the folder before installing.

What licence does Fix Board use?

Fix Board is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Fix Board use?

About 392 tokens (SKILL.md is roughly 1.6k 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 Fix Board?

Skills that share tags, products or a category with Fix Board: Vercel Composition Patterns (supabase/supabase, 111k stars), Finishing a Development Branch (obra/superpowers, 296k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and PR Babysitter (openinterpreter/openinterpreter, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fix Board?

FastLED (a GitHub organization) maintains it in FastLED/FastLED, which has 7,505 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 8, 2026.

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