Skip to content

Add Apple Container agent skill#1690

Open
aryan5v wants to merge 3 commits into
apple:mainfrom
aryan5v:add-apple-container-skill
Open

Add Apple Container agent skill#1690
aryan5v wants to merge 3 commits into
apple:mainfrom
aryan5v:add-apple-container-skill

Conversation

@aryan5v

@aryan5v aryan5v commented Jun 11, 2026

Copy link
Copy Markdown

Summary

Add an apple-container agent skill for using the container CLI as a native Linux container runtime on Apple silicon Macs.

The skill covers:

  • validating host and service readiness
  • running disposable Linux shells and one-shot commands
  • building and running OCI images
  • managing images, registries, volumes, networks, and services
  • using container machine for persistent Linux environments
  • diagnosing common vmnet, VPN, DNS, builder, and machine boot issues

It also includes a small diagnostic script for collecting host, service, network, and container smoke-test output, and adds the skill install command to the README.

Notes

The skill is CLI-first, but it points agents toward apple/containerization when the user asks to build Swift software directly against the lower-level container, image, and process management APIs.

The skill structure was built using the skills.sh documentation and Anthropic’s skill-creator skill.

This contribution was AI-assisted; I reviewed the generated content and validation output.

Validation

  • python3 .../quick_validate.py skills/apple-container
  • npx skills add . --list
  • npx skills add 'aryan5v/container#add-apple-container-skill@apple-container' --list
  • python3 -m json.tool skills/apple-container/metadata.json
  • git diff --check

@aryan5v aryan5v marked this pull request as ready for review June 11, 2026 01:29
@katiewasnothere katiewasnothere requested a review from jglogan June 12, 2026 00:15
aryan5v and others added 2 commits June 12, 2026 10:12
The skill assumed `container` was already installed and had no concrete
setup path. Add install guidance across SKILL.md, the workflows and
troubleshooting references, and the diagnostic script:

- Homebrew (`brew install container`) as the simplest path.
- Apple's signed `.pkg` installer as the fallback when Homebrew is absent,
  including the official double-click flow and a headless `installer`
  equivalent for agents driving a terminal.
- Upgrade/downgrade/uninstall helper scripts under /usr/local.
- First-run `container system start` and verification steps.
- Note that `brew install container` can succeed on macOS 15 even though the
  runtime needs macOS 26, so a clean install is not proof the host is supported.

Link the user guide (apple.github.io/container/documentation), the Homebrew
formula page, and the releases page from SKILL.md and metadata.json.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant