osx-tuning SKILL.md skillA

osx-tuning from dimetron/pi-go is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add dimetron/pi-go/osx-tuning@git:20260830.d80820f

Pins git:20260830.d80820f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
dimetron/pi-go
Path
internal/extension/bundled_skills/osx-tuning/SKILL.md
Versions recorded
1
Latest version
git:20260830.d80820f, committed Aug 30, 2026
Size
6,546 bytes
Repository stars
214
License
MIT

Tune macOS resource limits and sysctls for best performance with Go development, Docker/OrbStack, and Linux VMs. Use this skill whenever the user asks to "tune macOS", "raise file descriptor limits", "fix ulimit", "optimize for Docker/Go/VM performance", "increase maxfiles/maxproc/somaxconn", or reports EMFILE/too-many-open-files, connection refused under load, or slow container/VM networking. Covers the full chain: launchd maxfiles, per-shell ulimit, and boot-time sysctl tuning via…

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

# macOS Performance Tuning (Go / Docker / Linux VMs)

Raise macOS resource limits and tune TCP sysctls for heavy local development:
Go servers, Docker/OrbStack containers, and Linux VMs. Everything here is
reversible and verified.

## Why the defaults are low

macOS ships conservative soft limits. The two that bite developers:

- **`maxfiles` soft limit = 256** — set by launchd for every process. Go's
  `net/http` servers, Docker, and build tools open far more than 256 file
  descriptors. Hitting it surfaces as `EMFILE: too many open files` or
  `socket: too many open files`.
- **`kern.ipc.somaxconn = 128`** — max pending TCP connections per listen
  socket. Go servers and the Docker API socket queue up behind this under load.

The hard limits are already `unlimited`/high, so nothing is truly capped — the
soft values just need raising.

## The three layers

Tuning must happen at three levels because each only affects a subset of
processes:

| Layer | Affects | Mechanism |
|---|---|---|
| launchd `maxfiles` | all new processes | LaunchDaemon plist |
| per-shell `ulimit` | interactive shells | `~/.zshrc` |
| sysctls | kernel-wide, all processes | LaunchDaemon plist |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add dimetron/pi-go/osx-tuning@sha256:cd3c42c77c64f88a

The line at the top of this page pins the label git:20260830.d80820f, 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_ijwfw5hjdmotosni.svg)](https://markdownregistry.com/a/art_ijwfw5hjdmotosni)

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

Versions

The registry has recorded 1 version of this file, committed on Aug 30, 2026.

versioncommittedcommitsizeaudit
git:20260830.d80820f latest2026-08-30 d80820f 6,546 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 (6546 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

dimetron/pi-go · 214 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ijwfw5hjdmotosni
GET https://markdownregistry.com/api/v1/resolve?ref=dimetron/pi-go/osx-tuning
GET https://markdownregistry.com/api/v1/blob/cd3c42c77c64f88a5dff8565ff2a892df1c644a6819f425d3a66672d35e6d2f9

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 dimetron/pi-go

AGENTS.md@.pi-go AGENTS.md file
dimetron/pi-go · .pi-go/AGENTS.md
git:20260828.5d00de5 · audit A · 214 stars
bubbletea-testing SKILL.md skill
dimetron/pi-go · .pi-go/skills/bubbletea-testing/SKILL.md · Use this skill whenever writing tests for Bubble Tea (charmbracelet/bubbletea) TUI applications in Go. Triggers include…
git:20260317.b03b37b · audit A · 214 stars
check-linters-before-commit SKILL.md skill
dimetron/pi-go · .pi-go/skills/check-linters-before-commit/SKILL.md · Before any commit, run linters, vet, tests, and build verification; do not commit until checks pass
git:20260827.17116f1 · audit A · 214 stars
code-guidelines-go SKILL.md skill
dimetron/pi-go · .pi-go/skills/code-guidelines-go/SKILL.md · Go 1.24–1.27 coding guidelines for the dimetron/pi-go AI agent runtime. Use this skill whenever writing, reviewing, or…
git:20260827.17116f1 · audit A · 214 stars
code-review-codex SKILL.md skill
dimetron/pi-go · .pi-go/skills/code-review-codex/SKILL.md
git:20260410.1cba699 · audit C · 214 stars
code-review-pi SKILL.md skill
dimetron/pi-go · .pi-go/skills/code-review-pi/SKILL.md · Review code for quality, run linters, check test coverage, fix issues, and enforce gates. Save the final report to…
git:20260410.d823448 · audit A · 214 stars
demo-subagents-tui SKILL.md skill
dimetron/pi-go · .pi-go/skills/demo-subagents-tui/SKILL.md
git:20260410.d823448 · audit C · 214 stars
design-review SKILL.md skill
dimetron/pi-go · .pi-go/skills/design-review/SKILL.md · Deep design review of Go codebase — naming, structure, consistency, interfaces, error handling. Scores each dimension…
v1.1 · audit A · 214 stars
go-127 SKILL.md skill
dimetron/pi-go · .pi-go/skills/go-127/SKILL.md · What changed in Go 1.27 (released August 2026) and how it changes the way Go is written in pi-go. Use this skill when…
git:20260919.7d49ee6 · audit A · 214 stars
memory-mine SKILL.md skill
dimetron/pi-go · .pi-go/skills/memory-mine/SKILL.md · Mine project files or conversations into the MemPalace memory system. Indexes source code and conversation history as…
v1.0 · audit A · 214 stars
memory-status SKILL.md skill
dimetron/pi-go · .pi-go/skills/memory-status/SKILL.md · Show MemPalace memory system status — drawer counts, wings, rooms, knowledge graph stats, and embedding model state.
v1.0 · audit A · 214 stars
nightly-session-watch SKILL.md skill
dimetron/pi-go · .pi-go/skills/nightly-session-watch/SKILL.md · Nightly sweep of the last 24h of pi-go sessions — anomalous runs, loop aborts, tool error rates, token waste, real…
git:20260814.704f449 · audit A · 214 stars

Every file in dimetron/pi-go

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