Mac Clamshell Mode

Mac laptop clamshell mode assistant. Supports running with lid closed WITHOUT external display/keyboard/mouse. Auto-detects Mac model and macOS version, prov...

Security Scan

The skill's code and runtime instructions are consistent with a Mac clamshell-mode configurator: it detects model/version and runs local pmset/caffeinate commands (requires sudo) with explicit prompts and rollback guidance.

Purpose & Capability

The name/description match the scripts: check-compatibility.sh inspects model/version, configure-clamshell.sh modifies macOS power settings (pmset) or recommends caffeinate/Amphetamine. All required actions (changing pmset, using caffeinate) are appropriate for the stated purpose.

Instruction Scope

SKILL.md describes interactive modes and safe rollback, and the scripts require explicit user confirmation before applying changes. Minor inconsistency: test-skill.sh calls './configure-clamshell.sh --dry-run' but configure-clamshell.sh does not implement a --dry-run option — this may cause the test script to fail. Otherwise instructions remain local and do not attempt to read unrelated system secrets or call external endpoints.

Install Mechanism

No install spec or remote downloads are present; the skill is delivered as local scripts packaged with the skill. No network fetches or archive extraction are performed during install.

Credentials

The skill requests no environment variables or external credentials. It does require elevated privileges at runtime (uses sudo), which is expected for modifying system pmset settings.

Persistence & Privilege

The skill does not request permanent presence (always:false) nor modify other skills. It does perform privileged system configuration (sudo pmset) and will change system power behavior while active; these privileges are proportional to the task but require user attention because they affect device power/battery behavior.

Assessment

This skill appears to do what it claims: it runs local macOS commands (pmset, caffeinate), detects model/version, and prompts you before making changes. Before installing/running: 1) Review the configure-clamshell.sh script and understand the pmset changes it will make (disablesleep, autopoweroff, sleep/display settings). 2) Expect to be prompted for sudo; only run if you trust the source and you have administrator access. 3) Use check-compatibility.sh first to confirm your device is a MacBook and macOS version is supported. 4) Back up or note current pmset settings (pmset -g) before applying changes so you can restore them manually if needed. 5) Note the small inconsistency: test-skill.sh invokes --dry-run but configure-clamshell.sh does not implement that option — the test may fail. If you rely on battery-powered use, be aware forced headless mode increases battery drain; connect power when recommended.

Mac Clamshell Mode Assistant

Overview

Helps Mac users configure their laptops to run tasks with the lid closed. No external display, keyboard, or mouse required! This skill detects the current Mac model and macOS version, then provides appropriate configuration steps.

Key Features

• ✅ No external display required - Works with laptop alone
• ✅ No external keyboard/mouse required - Pure headless operation
• ✅ Auto-detection - Identifies Mac model and macOS version
• ✅ Multiple modes - Standard clamshell, forced headless, or temporary
• ✅ Safe configuration - Requires explicit approval, includes rollback
• ✅ Battery warnings - Alerts about power consumption

When to use

• User wants to run background tasks with MacBook lid closed
• User needs headless operation without external peripherals
• User wants to verify current power management settings
• User needs help with Amphetamine or caffeinate commands
• User wants to restore default power settings

System Requirements

• macOS 10.15 Catalina or later
• MacBook (Pro/Air) - Intel or Apple Silicon
• Power adapter connected (strongly recommended for headless mode)

Configuration Modes

Mode 1: Standard Clamshell (Requires External Display)

• Traditional macOS clamshell mode
• Most stable, most power-efficient
• Requires: Power + External Display + Keyboard/Mouse

Mode 2: Forced Headless Operation ⭐ RECOMMENDED

• No external display required
• No external keyboard/mouse required
• Modifies system power settings
• Perfect for background tasks, servers, rendering
• Warning: Increased battery consumption

Mode 3: Temporary Operation

• Uses caffeinate command
• No system setting changes
• Good for short-term tasks
• Stops when terminal closes

Mode 4: Status Check

• View current power settings
• See what's preventing sleep
• No modifications

Mode 5: Restore Defaults

• Rollback all changes
• Return to factory power settings

Workflow

1) System Detection

• Mac model (MacBook Pro/Air identification)
• macOS version (10.15+ compatibility check)
• Current power management settings
• Amphetamine running status

2) User Selection

• Present 5 configuration modes
• Clear explanations for each option
• Explicit confirmation required

3) Apply Configuration

• Mode-specific setup
• Safety warnings displayed
• Success/failure feedback

4) Verification & Rollback

• Test current sleep prevention status
• Provide rollback instructions
• Include recovery commands

Safety Rules

• ⚠️ Always recommend power adapter for headless mode
• ⚠️ Warn about battery drain when running without external display
• ✅ Require explicit approval before making system changes
• ✅ Provide rollback instructions for all configurations
• ✅ Check Amphetamine status and recommend if not running