pi-power-budget
Skill2 starsChanged 26 days agoMITView on GitHub
Use when a Raspberry Pi 5 build (screen, LEDs, fans, USB devices, encoders) needs a per-rail power budget with datasheet-sourced currents and a PSU choice. Runs the systems-engineer in a fresh context and writes systems\power-budget.md in the project folder you name.
In this repository30 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- agent-reviewSkill
- ai-mesh-cleanSkill
- cad-buildSkill
- couponSkill
- curriculumSkill
- dfm-reviewSkill
- fileSkill
- gddSkill
- ip-checkSkill
- led-budgetSkill
- lesson-learnedSkill
- makerworld-publishSkill
- material-pickSkill
- mcp-new-toolSkill
- ortho-sheetSkill
- preprint-checkSkill
- promo-planSkill
- qa-gateSkill
- render-criticSkill
- research-oneSkill
- research-topicSkill
- retopoSkill
- safety-sheetSkill
- sculptSkill
- slicer-questionSkill
- style-bibleSkill
- tech-packSkill
- unit-costSkill
- verifySkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 15
Read lessons\ and the notes in knowledge\08-electronics-lighting\ and knowledge\44-safety\.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Overview
Budget: $ARGUMENTS (project folder and the load list). Output: <project folder>\systems\power-budget.md (see templates\project\ for the folder layout) with one row per load, a sum per rail, the chosen margin (labelled design decision), the PSU, and a check step for the real Pi.
When to use
Before buying or wiring a supply for any Pi 5 build (a display piece with a screen, a bartop, a lit sign). Not for LED data wiring, injection points or level shifting (electronics-engineer), not for ESP32 pin maps (ask systems-engineer for pin-map.md), not for mains work (safety-officer gate, NEEDS MAKER).
Steps
- Read
lessons\and the notes inknowledge\08-electronics-lighting\andknowledge\44-safety\. If a load's exact part is not named, ask: NEEDS MAKER (never assume a part). - Pi 5 rules: fetch https://www.raspberrypi.com/documentation/computers/raspberry-pi.html and quote the recommended supply (voltage, current) and the USB current limit that applies when a smaller supply is used, each with its condition.
- Per load: fetch the datasheet or product page; record voltage, current (typical and peak), the condition (brightness, resolution, full white, idle), the URL and the page date. LED strips: per-LED current from the LED datasheet at the stated colour and brightness; count of LEDs and count of segments stated as separate numbers; hand injection and gauge to electronics-engineer by naming it in the file.
- Sum per rail (5 V, 12 V, USB-powered). State the margin as "design decision:
<value>, because<reason>", not as a sourced fact. Pick the PSU and quote its rated output with URL. - Check step for you: after wiring, run
vcgencmd get_throttledon the Pi under load and paste the result; the meaning of the value is read from the Raspberry Pi documentation page fetched this run. Steps are written as device menu paths or a line to paste, never "open a terminal" without saying which one and how. - Facts fetched go to
research\inbox\raspberry-pi\<question-slug>.mdfor/verify. Return the budget path, inbox paths, NEEDS MAKER list, one next step.
Common rationalizations
| Rationalization | Reality |
| "The Pi 5 needs 5 V 5 A, done." | The USB limit changes with the supply; quote both rules with their conditions from the page fetched this run. |
| "WS2812B is 60 mA per LED." | Only at a stated colour and brightness for a stated part. Datasheet URL and condition. |
| "Add 20 % headroom, standard practice." | Fine as a choice; label it design decision, not fact. |
| "Two 1 m strips, so about 288 LEDs." | LED count, segment count and injection points are separate numbers; count each. |
Red flags
- A current without voltage, condition and URL.
- Margin presented as a sourced figure.
- A PSU chosen before the per-rail sum exists.
- Mains wiring described as a step instead of NEEDS MAKER.
Verification
<project folder>\systems\power-budget.mdexists.- Every load row: V, A (typ and peak), condition, datasheet URL fetched this run, page date.
- Pi 5 supply and USB-limit quotes present with conditions.
- Margin labelled "design decision"; PSU rating quoted with URL.
vcgencmd get_throttledcheck step written; inbox paths returned.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

