Agent skill

Pironman5 Promax

by sunfounder in sunfounder/pironman5

Operate and customize the SunFounder Pironman 5 Pro Max enclosure (RGB, OLED, dashboard, service, expansion).

GPL-2.0Auto-check: notes

Install Pironman5 Promax

skills CLI
$ npx skills add sunfounder/pironman5 --skill pironman5-promax -a claude-code

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

GitHub CLI
$ gh skill install sunfounder/pironman5 pironman5-promax --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/sunfounder/pironman5.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skill/pironman5-promax-skill .claude/skills/pironman5-promax && 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
pironman5-promax
GitHub stars
137
Token cost
~1.2k tokens
SKILL.md length
541 words
Files
3 (incl. references)
Skills in repo
2
Repo updated
First seen
Licence
GPL-2.0

At a glance

Operate and customize the SunFounder Pironman 5 Pro Max enclosure (RGB, OLED, dashboard, service, expansion).

  • Works in 5 steps: Confirm service health → Inspect/adjust config (sudo pironman5 -c… → Apply changes: Always sudo systemctl… → …
  • Issuing pironman5 CLI commands
  • SKILL.md covers References, Quick Start Workflow, Common Operations and Hardware & Expansion Checklist, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Pironman5 Promax is an agent skill from sunfounder/pironman5. Operate and customize the SunFounder Pironman 5 Pro Max enclosure (RGB, OLED, dashboard, service, expansion). Use when issuing pironman5 CLI commands, editing /opt/pironman5/config.json, working with its displays, LEDs, IR receiver, or citing hardware capabilities/specs from the official docs.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/cli-cheatsheet.md` and `references/features.md`).

The repository describes itself as: Code for Raspberry Pi 5 case (Pironman5). The licence is GPL-2.0.

When your agent uses it

  • Issuing pironman5 CLI commands
  • Editing /opt/pironman5/config.json
  • Working with its displays
  • Citing hardware capabilities/specs from the official docs

Example prompts

  • “/pironman5-promax”

Requirements

  • Python 3

Workflow steps

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

  1. Confirm service health
  2. Inspect/adjust config (sudo pironman5 -c or edit /opt/pironman5/config.json).
  3. Apply changes: Always sudo systemctl restart pironman5.service after any CLI or config update.
  4. Validate hardware response (RGB glow, OLED page, fans, etc.).
  5. Document deviations (custom OLED pages, added LEDs) for future you.

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.sunfounder.com

    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

Pironman5 Promax loads about 1.2k tokens when it runs, and up to ~2.2k if it reads all its reference files. Until then it costs about 79 tokens; SKILL.md has 541 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~79
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.2k

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.

  • NoteRuns commands with sudoSKILL.md:19
    2. **Inspect/adjust config** (`sudo pironman5 -c` or edit `/opt/pironman5/config.json`).
  • NoteRuns commands with sudoSKILL.md:20
    3. **Apply changes**: Always `sudo systemctl restart pironman5.service` after any CLI or config update.

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 sunfounder/pironman5 at commit d5c5a9d, republished under its GPL-2.0 licence (© sunfounder). 541 words, ~1,201 tokens.

Download SKILL.mdSave it as .claude/skills/pironman5-promax/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
pironman5-promax
description
Operate and customize the SunFounder Pironman 5 Pro Max enclosure (RGB, OLED, dashboard, service, expansion). Use when issuing `pironman5` CLI commands, editing `/opt/pironman5/config.json`, working with its displays, LEDs, IR receiver, or citing hardware capabilities/specs from the official docs.

Pironman 5 Pro Max Skill

Use this skill whenever a task touches the SunFounder Pironman 5 Pro Max case, its bundled services, or hardware add-ons.

References

Quick Start Workflow

  1. Confirm service health
    • systemctl status pironman5.service
    • Tail logs for targeted addon (e.g., OLED) via journalctl -u pironman5.service -f or /var/log/pironman5/pm_auto.*.log.
  2. Inspect/adjust config (sudo pironman5 -c or edit /opt/pironman5/config.json).
  3. Apply changes: Always sudo systemctl restart pironman5.service after any CLI or config update.
  4. Validate hardware response (RGB glow, OLED page, fans, etc.).
  5. Document deviations (custom OLED pages, added LEDs) for future you.

Common Operations

  • RGB Lighting: Enable/disable, color, brightness, mode, speed, and LED count via the -re/-rc/-rb/-rs/-rp/-rl flags. Use breathing/flow/rainbow effects for animation; note rainbow-style modes override manual colors.
  • OLED Display: -oe toggles power, -or sets 0°/180° rotation, -op lists active pages (e.g., mix,performance,ips,disk), -os defines sleep timeout (0 = never). Troubleshoot wiring/I2C (i2cdetect -y 1, inspect pm_auto.oled.log).
  • Dashboard: Accessible at http://<device-ip>:34001. Required when running Home Assistant images (CLI control limited there). pironman5 launch-browser auto-opens the UI if the package is present; -rd removes dashboard components.
  • PiPower5 UPS (optional): Install with --pipower5 flag for battery backup support. After installation, use pironman5 pipower5 subcommand for UPS control (battery status, shutdown percentage, buzzer config, email alerts). OLED pages include battery, input, rpi_power when UPS is active. See pipower5 --help for full UPS CLI.
  • Power Button Actions: Single press cycles/wakes OLED page, double press goes backward, long press shows shutdown warning, release after long press triggers device shutdown. Map automation logic to these event_map entries.
  • Infrared Receiver: Install lirc, capture codes with mode2 -d /dev/lirc0, then map buttons in /etc/lirc/lircd.conf for media-center or custom control flows.
  • Data Logging: Manage retention (-drd), history enable (-eh), and log verbosity (-dl). Remember large histories require InfluxDB space; prune when needed.
  • Service Control: Use subcommands pironman5 start|stop|launch-browser. Always restart after config tweaks.
Show full SKILL.md (223 more words)Show less

Hardware & Expansion Checklist

Consult references/features.md for specs when planning upgrades. Key reminders:

  • Dual M.2 (2230–2280) PCIe Gen2 lanes share bandwidth—plan RAID/AI combos accordingly.
  • Provide a clean 27 W USB-C supply before loading both NVMe slots or AI cards.
  • RGB system combines 6 onboard WS2812B LEDs + 3 PWM fans; update LED count if chaining strips.
  • 4.3" touchscreen defaults to mouse emulation—switch to multitouch via Raspberry Pi Control Centre if using as primary display.

Troubleshooting Tips

  • OLED blank: Check FPC seating, confirm i2cdetect sees 0x3C, inspect pm_auto.oled.log. Reboot after reseating.
  • RGB unresponsive: Ensure service running, verify rgb_enable true, restart service, confirm no conflicting ws2812 drivers.
  • Dashboard unreachable: Confirm service open on :34001, firewall/stateful rules, or re-run pironman5 launch-browser locally. For headless access, SSH tunnel the port.
  • Thermals: Inspect tower cooler fan via pm_auto logs; confirm PWM cable seated. Use dashboard performance page for live temps.
  • Power instability: Re-check 27 W supply and NVMe current draw. Brownouts often present as random reboots during SSD writes.

Workflow Pointers

  • Script repeatable tasks (e.g., custom OLED page installers) separately; keep this skill focused on vendor-supported controls.
  • Whenever you modify bundled Python packages under /opt/pironman5/venv, note the change so future updates don’t overwrite silently.
  • When asked “what can Pironman 5 Pro Max do,” cite highlights from references/features.md and tie them to actionable controls (RGB, dual NVMe, displays, IR, GPIO, etc.).

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

Files

SKILL.md and 2 other files (references) in skill/pironman5-promax-skill of sunfounder/pironman5.

  • SKILL.md
  • references/cli-cheatsheet.md
  • references/features.md

Open the folder on GitHubat commit d5c5a9d

Compare with similar skills

Pironman5 Promax 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.

Pironman5 Promax compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pironman5 Promax this skillsunfounder/pironman5137—~1.2kAutomated safety check: NotesGPL-2.0
UI UX Pro Maxnexu-io/open-design100k—~484Automated safety check: PassApache-2.0
Protanweai/pua20k—~528Automated safety check: PassMIT
Maxsickn33/agentic-awesome-skills47k1 repos~1.4kAutomated safety check: PassMIT
Customer Billing Opsaffaan-m/ECC277k2 repos~1.1kAutomated safety check: PassMIT
UI UX Pro Max Pointermohitagw15856/pm-claude-skills1.4k—~1kAutomated safety check: PassMIT

Similar skills

  • UI UX Pro Max

    nexu-io/open-design

    Catalog-only UI/UX Pro Max entry. An agent skill from nexu-io/open-design.

    100k GitHub stars~484 tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Pro

    tanweai/pua

    PUA Pro extensions: self-evolution notes, compaction state continuity, KPI-style summaries, flavor switching, and feedback tools.

    20k GitHub stars~528 tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Max

    sickn33/agentic-awesome-skills

    Cleans up and improves existing code without changing behavior.

    47k GitHub starsUsed in 1 repo~1.4k tokens
    DevelopmentAuto-check passed
  • Operate customer billing workflows such as subscriptions, refunds, churn triage, billing-portal recovery, and plan analysis using connected billing tools like Stripe.

    277k GitHub starsUsed in 2 repos~1.1k tokens
    Backend & APIsAuto-check passed
  • UI UX Pro Max Pointer

    mohitagw15856/pm-claude-skills

    Point to the ui-ux-pro-max skill by nextlevelbuilder and explain when to use it.

    1.4k GitHub stars~1k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • It Operations

    davila7/claude-code-templates

    Manages IT infrastructure, monitoring, incident response, and service reliability.

    33k GitHub starsUsed in 1 repo~3.7k tokens
    DevOps & CloudAuto-check passed

More from sunfounder/pironman5

  • Pironman5 Mini

    sunfounder/pironman5

    Guide Raspberry Pi 5 builds that live inside the SunFounder Pironman 5 Mini enclosure.

    137 GitHub stars~689 tokensUpdated 2 days ago
    Auto-check passed

Questions about Pironman5 Promax

What does Pironman5 Promax do?

Operate and customize the SunFounder Pironman 5 Pro Max enclosure (RGB, OLED, dashboard, service, expansion). Pironman5 Promax is an agent skill from sunfounder/pironman5. Operate and customize the SunFounder Pironman 5 Pro Max enclosure (RGB, OLED, dashboard, service, expansion).

When should I use Pironman5 Promax?

Pironman5 Promax fits situations like: issuing pironman5 CLI commands; editing /opt/pironman5/config.json; working with its displays; citing hardware capabilities/specs from the official docs.

How do I install Pironman5 Promax in Claude Code?

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

How do I install Pironman5 Promax in Codex?

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

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

What does Pironman5 Promax need to run?

SKILL.md names no scripts, command-line tools or credentials: Pironman5 Promax is instructions for the agent only. Our summary lists: Python 3.

Does Pironman5 Promax access the network?

SKILL.md names 1 domain. As links in the text: docs.sunfounder.com. This is read from the text; nothing was executed.

Is Pironman5 Promax safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Pironman5 Promax use?

Pironman5 Promax is published under the GPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pironman5 Promax use?

About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1k tokens, read only when the agent opens those files.

What are the alternatives to Pironman5 Promax?

Skills that share tags, products or a category with Pironman5 Promax: UI UX Pro Max (nexu-io/open-design, 100k stars), Pro (tanweai/pua, 20k stars), Max (sickn33/agentic-awesome-skills, 47k stars) and Customer Billing Ops (affaan-m/ECC, 277k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pironman5 Promax?

sunfounder (a GitHub organization) maintains it in sunfounder/pironman5, which has 137 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 9, 2026.

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