Agent skill

Macmini Offload

by bam-bam-2 in bam-bam-2/solo-skills

무거운 작업(스크래핑, 미디어 인코딩, 빌드/설치, 대량 API 수집, 긴 문서 읽기, 대용량 파일 처리)을 맥미니로 넘길 때 사용.

MITAuto-check: warningsMedia & Creative

Install Macmini Offload

The automated check flagged lines worth reading first. See the safety section below.

skills CLI
$ npx skills add bam-bam-2/solo-skills --skill macmini-offload -a claude-code

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

GitHub CLI
$ gh skill install bam-bam-2/solo-skills macmini-offload --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/bam-bam-2/solo-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/remote-offload .claude/skills/macmini-offload && 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
macmini-offload
GitHub stars
367
Token cost
~1.1k tokens
SKILL.md length
454 words
Files
2 (incl. scripts)
Skills in repo
38
Repo updated
First seen
Licence
MIT

At a glance

무거운 작업(스크래핑, 미디어 인코딩, 빌드/설치, 대량 API 수집, 긴 문서 읽기, 대용량 파일 처리)을 맥미니로 넘길 때 사용.

  • Media & Creative work in your project
  • SKILL.md covers 왜, 접속, 작업공간 규약 and 판단 기준, plus 6 more sections
  • Runs Shell scripts from its folder; calls ssh, scp and claude

What it does

Macmini Offload is an agent skill from bam-bam-2/solo-skills. 무거운 작업(스크래핑, 미디어 인코딩, 빌드/설치, 대량 API 수집, 긴 문서 읽기, 대용량 파일 처리)을 맥미니로 넘길 때 사용. Aside가 도는 맥북에어는 8GB라 상시 메모리 부족이므로, CPU/RAM/시간을 많이 쓰는 일은 기본적으로 맥미니에서 돌린다.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/offload.sh`).

It sits in Media & Creative. It works with Playwright, FFmpeg and Bash. The repository describes itself as: 1인 사업가 생산성 키트 — 직원 없이 58개를 자동화했고, 그중 바로 쓸 수 있는 AI 에이전트 스킬 38개(+실행 스크립트 19개)를 공개합니다. The licence is MIT.

When your agent uses it

  • Media & Creative work in your project

Example prompts

  • “/macmini-offload”

Requirements

  • Node.js
  • A Bash shell

What it can do on your machine

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

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • ssh
    • scp
    • claude
    • node
    • npm

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

  • Network

    No URLs in SKILL.md. Its commands use ssh, scp and npm, 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

Macmini Offload loads about 1.1k tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 454 words of instructions outside code blocks.

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

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: warnings

The automated check found patterns that need a careful read before installing.

  • WarningMentions a credentials file (SSH keys, cloud or package-manager tokens)SKILL.md:8
    > - `~/.ssh/config`에 등록된 원격 호스트로 **SSH 접속해 명령을 실행**합니다.
  • NoteMentions a .env fileSKILL.md:150
    - 자격증명은 맥미니에 있는 기존 `.env`에서 런타임에만 읽고, 값을 출력하지 않는다.

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); the scripts in this folder are not scanned.

SKILL.md

The full file from bam-bam-2/solo-skills at commit 0712439, republished under its MIT licence (© bam-bam-2). 454 words, ~1,072 tokens.

Download SKILL.mdSave it as .claude/skills/macmini-offload/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
macmini-offload
description
무거운 작업(스크래핑, 미디어 인코딩, 빌드/설치, 대량 API 수집, 긴 문서 읽기, 대용량 파일 처리)을 맥미니로 넘길 때 사용. Aside가 도는 맥북에어는 8GB라 상시 메모리 부족이므로, CPU/RAM/시간을 많이 쓰는 일은 기본적으로 맥미니에서 돌린다.

이 스킬이 시스템에 하는 일 (설치 전 확인)

  • ~/.ssh/config에 등록된 원격 호스트로 SSH 접속해 명령을 실행합니다.
  • 원격이 응답하지 않으면 로컬로 대체 실행하지 않고 중단합니다. 의도된 동작입니다.
  • 새 파일이나 상주 프로세스를 만들지 않습니다. --bg 사용 시 원격에 로그 파일(/tmp/offload-*.log) 하나가 남습니다.

맥미니 오프로딩

왜

Aside 돌아가는 기기오프로딩 대상
기기MacBook Air, Apple M1Mac mini, Apple M4
램8 GB (상시 부족, 압축 2.6GB / 여유 70MB 수준)16 GB
절전사용자가 덮으면 멈춤pmset sleep 0 — 안 잠듦
디스크 여유200 GB54 GB

맥북에어는 램이 모자라 크로미움이 백그라운드 탭을 강제 종료한다. 로컬에서 무거운 걸 돌리면 사용자의 탭이 죽는다. 무거운 건 맥미니로 넘기는 게 기본값이다.

접속

bash
ssh mac-mini          # Tailscale (100.75.197.6) — 기본으로 이걸 쓴다
ssh mac-mini-lan      # 같은 LAN일 때 (mac-mini.local)

비대화형에서는 -o BatchMode=yes -o ConnectTimeout=10을 붙인다. PATH가 필요한 명령(brew 설치물 등)은 ssh mac-mini 'bash -lc "..."'로 로그인 셸을 태운다.

작업공간 규약

~/Projects/ops/offload/
├── run.sh          러너 (아래 참조)
├── jobs/           실행할 스크립트를 여기로 scp
├── out/            산출물 (이미지, csv, json 등)
├── logs/           <JOB_ID>.log / .pid / .cmd.sh
└── node_modules/   playwright 설치됨

기존 프로젝트 작업은 ~/Projects/<repo>에서 그대로 하고, 일회성 오프로딩만 여기를 쓴다.

판단 기준

넘긴다

  • 헤드리스 스크래핑, 특히 여러 페이지 순회 (로그인 불필요한 공개 페이지)
  • ffmpeg 인코딩, GIF 생성, 이미지 대량 변환
  • npm install, next build, 대형 저장소 clone
  • 대량 API 수집 (수백~수천 건 페이지네이션)
  • 수십 MB 이상 파일 파싱/집계
  • 30초 넘게 걸릴 것 같은 CPU 작업 전부
  • 긴 문서/영상 스크립트 읽고 요약 (아래 claude -p 레시피)

안 넘긴다

  • 사용자의 로그인 세션·쿠키가 필요한 브라우징 → Aside 브라우저에서 해야 함
  • 사용자가 화면으로 확인해야 하는 UI 조작
  • 몇 초 안에 끝나는 단순 조회 (ssh 왕복이 더 느림)
  • 사용자 개인 파일이 맥북에어에만 있는 경우 (전송 비용 판단 후 결정)

표준 패턴: 스크립트를 보내서 실행

ssh + bash -lc + heredoc을 중첩하면 따옴표가 반드시 깨진다. 로컬에 파일로 쓰고 scp로 보낸 뒤 실행한다.

bash
TMP=<세션 tmp 디렉토리>
cat > "$TMP/job.js" <<'EOF'
... 스크립트 ...
EOF
scp -q "$TMP/job.js" mac-mini:~/Projects/ops/offload/jobs/job.js
ssh mac-mini 'cd ~/Projects/ops/offload && node jobs/job.js'

긴 작업: run.sh

ssh 세션이 끊겨도 살아남아야 하는 작업은 러너로 띄운다.

bash
R=~/Projects/ops/offload/run.sh
ssh mac-mini "$R start 'node jobs/scrape.js' scrape"   # -> JOB_ID=scrape-20260811-124757
ssh mac-mini "$R status scrape-20260811-124757"        # running (pid=...) 또는 ### EXIT=0
ssh mac-mini "$R tail   scrape-20260811-124757"        # 마지막 40줄
ssh mac-mini "$R log    scrape-20260811-124757"        # 전체 로그
ssh mac-mini "$R list"                                 # 최근 20개 작업

작업이 오래 걸리면 붙잡고 기다리지 말고, 그동안 로컬에서 다른 일을 하다가 status로 확인한다.

Show full SKILL.md (180 more words)Show less

산출물 회수

bash
scp mac-mini:~/Projects/ops/offload/out/result.csv <세션 artifacts 디렉토리>/
scp -r mac-mini:~/Projects/ops/offload/out/frames  <세션 tmp 디렉토리>/

사용자에게 보여줄 결과물은 artifacts 디렉토리로, 중간 확인용은 tmp로 가져온다.

레시피

헤드리스 브라우징 (playwright)
js
const { chromium } = require('playwright');   // ~/Projects/ops/offload 에서 실행
(async () => {
  const b = await chromium.launch({ headless: true });
  const p = await b.newPage();
  await p.goto(url, { waitUntil: 'domcontentloaded' });
  // ...
  await p.screenshot({ path: 'out/shot.png' });
  await b.close();
})();

워밍업 후 페이지 로드 0.3초 수준. 전역에 puppeteer도 있지만 playwright를 기본으로 쓴다.

미디어

ffmpeg는 /opt/homebrew/bin/ffmpeg. 인코딩·GIF 변환은 전부 맥미니에서 한다. web-demo-video 스킬의 프레임 합성 단계도 여기로 넘길 수 있다.

긴 문서 읽기를 CLI로 위임

메인 컨텍스트에 원문을 쌓지 않으면서 긴 자료를 요약할 때:

bash
ssh mac-mini 'bash -lc "cat ~/Projects/ops/offload/jobs/doc.txt | claude -p --model claude-sonnet-4-5"'

사용량 한도가 걸리면 claude-codex-fallback 스킬의 판별 규칙을 따른다. Codex CLI(codex)도 설치되어 있다.

설치된 도구

node v26 / npm 11 / python3.9 / uv / brew 6 / ffmpeg / rg / jq / git / gh 2.92 / vercel / claude CLI 2.1 / codex CLI 0.147 / playwright(offload 로컬) / puppeteer(전역) / Google Chrome

없는 게 필요하면 ssh mac-mini 'bash -lc "brew install <pkg>"'로 설치하고 이 목록을 갱신한다.

주의

  • 맥미니는 이미 launchd 상주 작업이 여러 개 돈다 (atlas-server, atlas-kakao-poll, threads-fetch, voicememoimporter, 디스코드 채널 봇, 각종 리마인더). 코어를 다 쓰는 작업을 걸기 전에 run.sh list와 launchctl list | grep bambam을 확인한다.
  • 예약 실행(리마인더/크론)은 이 스킬이 아니라 macmini-discord-reminder 스킬을 따른다.
  • 자격증명은 맥미니에 있는 기존 .env에서 런타임에만 읽고, 값을 출력하지 않는다.
  • 디스크 여유가 54GB뿐이다. 대용량 임시 파일은 작업 후 out/에서 정리한다.
  • 파괴적 작업(대량 삭제 등)은 AGENTS.md의 안전 규칙을 그대로 적용한다.

© bam-bam-2, MIT. 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 1 other file (scripts) in skills/remote-offload of bam-bam-2/solo-skills.

  • SKILL.md
  • scripts/offload.sh

Open the folder on GitHubat commit 0712439

Compare with similar skills

Macmini Offload 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.

Macmini Offload compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Macmini Offload this skillbam-bam-2/solo-skills367—~1.1kAutomated safety check: WarnMIT
Terminal Demo Video Recorderliaohch3/claude-tap3.3k—~545Automated safety check: PassMIT
Cs Code VideoChenShuo2004/cs-skills193—~2.1kAutomated safety check: PassMIT
Render Chatgpt Chatgooseworks-ai/goose-skills1.2k—~2.2kAutomated safety check: PassMIT
Character Animation QAcalesthio/OpenMontage65k—~389Automated safety check: PassMIT
Browser Video Recordingnirholas/three.ws2271 repos~1.5kAutomated safety check: PassApache-2.0

Similar skills

  • Terminal Demo Video Recorder

    liaohch3/claude-tap

    Records a real tmux end-to-end run with asciinema, converts it to a GIF and MP4, and captures trace viewer screenshots with Playwright.

    3.3k GitHub stars~545 tokensUpdated 16 days ago
    Media & CreativeAuto-check passed
  • Cs Code Video

    ChenShuo2004/cs-skills

    用代码做动画视频:页面暴露 render(t),Playwright 逐帧截图 + FFmpeg 合成 mp4,可接合成配乐、出图和配音。通用模式先明确主题、规格、风格和声音,出风格卡、分镜与关键帧后逐镜制作;Vibe知识大赏模式额外查证来源、记录真实素材许可、先渲 10 秒样片。触发词包括…

    193 GitHub stars~2.1k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Render Chatgpt Chat

    gooseworks-ai/goose-skills

    Assemble a ChatGPT chat-reveal video ad from a thread + timeline JSON — one continuous Playwright recording of a ChatGPT mobile chat (user types with the iOS keyboard up → taps send → keyboard…

    1.2k GitHub stars~2.2k tokensUpdated today
    Media & CreativeAuto-check passed
  • Character Animation QA

    calesthio/OpenMontage

    Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

    65k GitHub stars~389 tokensUpdated 5 days ago
    Media & CreativeAuto-check passed
  • Browser Video Recording

    nirholas/three.ws

    Create polished 60 fps 4:3 4K browser screen-recording style videos from Codex in-app browser captures, with browser-only crop, natural macOS cursor styling, deliberate click choreography…

    227 GitHub starsUsed in 1 repo~1.5k tokens
    Media & CreativeAuto-check passed
  • Render Apple Notes Chat

    gooseworks-ai/goose-skills

    Assemble an Apple Notes list video ad from a note + end-card JSON — a frame-accurate fake iPhone screen recording of a short list being typed into Apple Notes (character by character, key pops…

    1.2k GitHub stars~1.5k tokensUpdated today
    Media & CreativeAuto-check passed

More from bam-bam-2/solo-skills

All 38 skills in this repo
  • Computer Use

    bam-bam-2/solo-skills

    Use Orca's computer-use CLI to inspect and operate local desktop app windows through accessibility trees, screenshots, and safe UI actions.

    367 GitHub starsUsed in 1 repo~915 tokens
    Auto-check passed
  • Orchestration

    bam-bam-2/solo-skills

    Use Orca orchestration for structured multi-agent coordination: threaded messages, blocking ask/reply flows, task dispatch, workerdone/escalation waits, task DAGs, decision gates, coordinator loops…

    367 GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Book PDF Pagedjs

    bam-bam-2/solo-skills

    마크다운 원고를 실제 책처럼 보이는 PDF/EPUB 전자책으로 만들 때 사용. An agent skill from bam-bam-2/solo-skills.

    367 GitHub stars~2.5k tokensUpdated 24 days ago
    Auto-check passed
  • Lecture Recording Captions

    bam-bam-2/solo-skills

    밤밤의 강연·라이브·기수 세션 녹화본(줌 클라우드·디스코드·맥 화면기록)을 자막판 영상으로 만들고 배포할 때 읽을 것.

    367 GitHub stars~1.4k tokensUpdated 24 days ago
    Auto-check passed
  • Naver Mail Imap

    bam-bam-2/solo-skills

    밤밤의 네이버 메일(you@example.com)을 브라우저 없이 읽어야 할 때 사용. An agent skill from bam-bam-2/solo-skills.

    367 GitHub stars~964 tokensUpdated 24 days ago
    Auto-check: notes
  • Style Skill Creator

    bam-bam-2/solo-skills

    Creative writing skill for creating style skills that teach Claude to write in specific styles.

    367 GitHub stars~935 tokensUpdated 24 days ago
    Auto-check passed

Questions about Macmini Offload

What does Macmini Offload do?

무거운 작업(스크래핑, 미디어 인코딩, 빌드/설치, 대량 API 수집, 긴 문서 읽기, 대용량 파일 처리)을 맥미니로 넘길 때 사용. Macmini Offload is an agent skill from bam-bam-2/solo-skills. 무거운 작업(스크래핑, 미디어 인코딩, 빌드/설치, 대량 API 수집, 긴 문서 읽기, 대용량 파일 처리)을 맥미니로 넘길 때 사용.

When should I use Macmini Offload?

Macmini Offload fits situations like: media & Creative work in your project.

How do I install Macmini Offload in Claude Code?

Run `npx skills add bam-bam-2/solo-skills --skill macmini-offload -a claude-code`. Or copy the skill folder (skills/remote-offload in bam-bam-2/solo-skills) into .claude/skills/macmini-offload in your project. Claude Code loads it when a task matches its description.

How do I install Macmini Offload in Codex?

Run `npx skills add bam-bam-2/solo-skills --skill macmini-offload -a codex`. Or copy the skill folder (skills/remote-offload in bam-bam-2/solo-skills) into .agents/skills/macmini-offload in your project. Codex loads it when a task matches its description.

Can I use Macmini Offload 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 bam-bam-2/solo-skills --skill macmini-offload -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/macmini-offload, .gemini/skills/macmini-offload, .github/skills/macmini-offload and .opencode/skills/macmini-offload in your project.

What does Macmini Offload need to run?

Going by SKILL.md and its folder, Macmini Offload needs a shell for the scripts in its folder and the command-line tools its instructions call (ssh, scp, claude, node and npm). Our summary lists: Node.js; A Bash shell.

Does Macmini Offload access the network?

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

Is Macmini Offload safe to install?

Our automated static check of SKILL.md flagged 1 warning(s): mentions a credentials file (ssh keys, cloud or package-manager tokens). Read the flagged lines before installing; the check is not a guarantee either way. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Macmini Offload use?

Macmini Offload 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 Macmini Offload use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 Macmini Offload?

Skills that share tags, products or a category with Macmini Offload: Terminal Demo Video Recorder (liaohch3/claude-tap, 3.3k stars), Cs Code Video (ChenShuo2004/cs-skills, 193 stars), Render Chatgpt Chat (gooseworks-ai/goose-skills, 1.2k stars) and Character Animation QA (calesthio/OpenMontage, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Macmini Offload?

bam-bam-2 (a GitHub user) maintains it in bam-bam-2/solo-skills, which has 367 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on September 14, 2026.

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