b3os-mac-app-shell SKILL.md skillA

b3os-mac-app-shell from b3rys/b3rys-team-os is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add b3rys/b3rys-team-os/b3os-mac-app-shell@git:20261030.636761b

Pins git:20261030.636761b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
b3rys/b3rys-team-os
Path
skills/b3os-mac-app-shell/SKILL.md
Versions recorded
6
Latest version
git:20261030.636761b, committed Oct 30, 2026
First version recorded
Jul 23, 2026
Size
7,811 bytes
Repository stars
18
License
Apache-2.0

웹 대시보드/웹앱을 Apple 네이티브 셸(.app)로 빠르게 래핑하는 팀 스킬. mac-iphone-shell 골격(SwiftUI multi-platform + WKWebView 라이브러리 + HostApp 패턴)을 참조해 URL 구성형 Mac/iPhone 앱을 만들고 .app으로 패키징한다. "이 웹대시보드를 맥앱으로 만들어줘", "b3os.app 같은 셸 앱", "사내 웹툴 네이티브 래핑"일 때, 그리고 아이폰 앱 개발·시뮬레이터 시험·TestFlight 배포를 할 때 사용(아이폰 개발·시험 정본 references/iphone-dev-test.md). 검증된 함정(특히 WebView 창 채움/viewport)을 피하는 레시피 포함. 주 사용자·업데이트 책임자: agent A·developer.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# b3os-mac-app-shell

웹앱을 Apple 네이티브 셸(.app)로 래핑하는 팀 표준 레시피. **별도 골격 저장소를 참조**하며 코드를 복제하지 않는다 — 이 스킬은 "언제·어떻게·무엇을 조심"의 운영 지식이고, 실제 구현·빌드 스크립트는 골격에 있다.

> 선행 조건 — 골격 저장소는 이 저장소에 들어있지 않다.
> 정본 골격은 **b3rys 내부 비공개 저장소 `mac-iphone-shell`**(SwiftUI multi-platform 라이브러리 + HostApp 패턴)이다. 접근 권한이 있는 팀원이 따로 clone해야 하고, 아래 절차와 references의 경로는 **본인이 clone한 위치**를 가리킨다(이 문서에서는 `$SHELL_SKELETON`으로 쓴다).
> 접근 권한이 없으면 이 스킬의 빌드 절차는 실행할 수 없다 — "검증된 함정"·"검증 절차" 절의 운영 지식만 참고 자료로 쓴다.
>
> owner / 업데이트 책임자: **agent A, developer** (둘이 함께 유지·리뷰)

## 언제 쓰는가

- 이미 있는 웹 대시보드/웹툴을 **설치 가능한 Mac 앱(.app)** 으로 내보내고 싶을 때 (예: b3os 대시보드 → `b3os.app`)
- "맥앱으로 래핑한 티 안 나게, 라이트/다크 seamless, 창이 네이티브처럼" 요구
- iPhone 동반 앱(같은 골격, read-only/동일 셸)도 필요할 때
- **아이폰 앱을 개발·시험·TestFlight 배포할 때(골격을 쓰지 않는 네이티브 앱 포함)** → [`references/iphone-dev-test.md`](references/iphone-dev-test.md) 를 먼저 읽는다. 공용 맥 시뮬레이터·기기/OS 기준·빌드·속도·접근성·다국어·검증 습관·디스크·TestFlight·iCloud 의 증상 → 원인 → 해결.
- ❌ 쓰지 않는 경우: 네이티브 UI가 본질인 앱(웹뷰가 아니라 SwiftUI 화면이 주). 그건 골격 없이 일반 SwiftUI로.

## 전제 · 요구사항 (이게 없으면 이 스킬은 못 쓴다)

- **macOS Sonoma 14+** (골격 deployment target). **Xcode 16.2+** (`xcodebuild -version`). Swift toolchain 포함.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add b3rys/b3rys-team-os/b3os-mac-app-shell@sha256:1f54828c509acc6f

The line at the top of this page pins the label git:20261030.636761b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_abqnomlih2lpt77u.svg)](https://markdownregistry.com/a/art_abqnomlih2lpt77u)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Jul 23, 2026 and Oct 30, 2026, about one every 20 days.

versioncommittedcommitsizeaudit
git:20261030.636761b latest2026-10-30 636761b 7,811 BA view · diff
git:20261023.65b79142026-10-23 65b7914 7,856 BA view · diff
git:20261016.7ee2e852026-10-16 7ee2e85 7,783 BA view · diff
git:20260924.839a49b2026-09-24 839a49b 7,031 BA view · diff
git:20260726.20a4aa22026-07-26 20a4aa2 7,038 BA view · diff
git:20260723.55ddc122026-07-23 55ddc12 6,269 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7811 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

b3rys/b3rys-team-os · 18 stars · license Apache-2.0 · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_abqnomlih2lpt77u
GET https://markdownregistry.com/api/v1/resolve?ref=b3rys/b3rys-team-os/b3os-mac-app-shell
GET https://markdownregistry.com/api/v1/blob/1f54828c509acc6f33cd66b1f47fb52943eb9b3fd1f398e7f25623e0f7d48a1b

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from b3rys/b3rys-team-os

CLAUDE.md CLAUDE.md file
b3rys/b3rys-team-os · CLAUDE.md
git:20260723.55ddc12 · audit A · 18 stars
b3os-ai-code-safety SKILL.md skill
b3rys/b3rys-team-os · skills/b3os-ai-code-safety/SKILL.md · AI 가 만들거나 고친 코드의 구조·리팩토링 가이드. 프로그램 구조 설계, 새 코드 작성, 코드 리뷰, 코드 냄새(한 곳을 고치면 여러 곳이 바뀌거나 엉뚱한 곳이 깨짐) 리팩토링 때 쓴다. SOLID 경계…
git:20261030.37413e2 · audit A · 18 stars
b3os-bwf SKILL.md skill
b3rys/b3rys-team-os · skills/b3os-bwf/SKILL.md · b3rys 팀 기본 과제 수행 워크플로우(b3os workflow). 과제를 받으면 PM계획→팀배정→실행+품질방법→검증→보고+카드→학습hook 순으로 끝까지 끌고 가는 단일 진입점(stage router)…
git:20261030.636761b · audit A · 18 stars
b3os-github-workflow SKILL.md skill
b3rys/b3rys-team-os · skills/b3os-github-workflow/SKILL.md · 팀원이 코드 변경을 GitHub PR로 올려 승인·머지까지 가는 절차 — 브랜치·worktree 격리, 커밋 신원, PR 작성 계정, 검증 근거, 승인 기록(Approved-by), 머지 후 확인. 저장소에 남는…
git:20261030.1a0a097 · audit B · 18 stars
b3os-harness-playbook SKILL.md skill
b3rys/b3rys-team-os · skills/b3os-harness-playbook/SKILL.md · b3rys 팀 harness(sub agent 병렬 실행) 플레이북 — 트리거 우선. "중요 프로젝트 구현은 역할 분리(구현+독립 리뷰)가 기본. 병렬 실소스 커버 모양이면 limited harness를 더하고…
git:20261030.636761b · audit A · 18 stars
b3os-how-to-explain SKILL.md skill
b3rys/b3rys-team-os · skills/b3os-how-to-explain/SKILL.md · 한국어로 설명·보고할 때 독자가 되묻지 않게 쓰는 규칙. 기술 원리·논문 해설, 장애 원인·변경 이유 보고, PR 본문·보고서, 그리고 "무슨 말이야"·"쉽게 설명해"·"예를 들어"·"복잡하게 가지 마" 라는…
git:20261030.636761b · audit A · 18 stars
b3os-infra-safety SKILL.md skill
b3rys/b3rys-team-os · skills/b3os-infra-safety/SKILL.md · b3os 플랫폼 자체(설정·소스·registry·배포)를 수정할 때 지킬 안전 규칙. 팀원이 b3os 코드/config/agents.json/team.db/릴리스를 건드리는 작업을 할 때 필독…
git:20261030.636761b · audit A · 18 stars
b3os-model-rollout SKILL.md skill
b3rys/b3rys-team-os · skills/b3os-model-rollout/SKILL.md · 팀원 런타임(hermes · codex · openclaw)의 모델을 새 모델로 바꿀 때 쓰는 절차와 도구. 팀원별 지금 모델 확인(inventory), 새 모델이 그 런타임·계정에서 실제로 응답하는지…
git:20261001.a31750e · audit A · 18 stars
b3os-release-ops SKILL.md skill
b3rys/b3rys-team-os · skills/b3os-release-ops/SKILL.md · b3os 공개 정본 배포·PR 머지·핫픽스·force-push 안전 게이트. 팀원이 공개 main, live deploy, clean merge, GD noreply 재작성, 인수테스트, 봇 자율머지 범위를 판단할…
git:20260924.839a49b · audit A · 18 stars
b3os-report SKILL.md skill
b3rys/b3rys-team-os · skills/b3os-report/SKILL.md · b3rys 팀 표준 보고서 스킬. 보고서는 MD 소스를 먼저 쓰고 아이폰에서 읽기 좋은 자체완결 반응형 HTML+SVG로 렌더해 /reports 에 게시한다. 사용 시점 — "보고서 써줘", "report", "팀…
git:20261030.1a0a097 · audit A · 18 stars
b3os-scheduler SKILL.md skill
b3rys/b3rys-team-os · skills/b3os-scheduler/SKILL.md · b3os durable 스케줄러로 반복(cron)·간격(interval)·1회성(reminder) 잡을 등록하는 팀 스킬. 시·분·요일·월 cron + 잡별 휴일정책(run/skip/shift, KST)을 잡 등록…
git:20261030.636761b · audit A · 18 stars
b3os-sf SKILL.md skill
b3rys/b3rys-team-os · skills/b3os-sf/SKILL.md · b3os SF(Software Factory) — 프로젝트 방법론. b3rys 팀원이 프로젝트(단순 리서치·프로토가 아닌, 팀장 요구가 여러 번 쌓이는 일)를 맡았을 때 항상 하는 관리·보고 스킬. 팀장 지시를…
git:20261030.636761b · audit A · 18 stars

Every file in b3rys/b3rys-team-os

Browse by kind, by grade A, or by owner.