Rename to hkt.sh

2026-03-21 01:10:53 +08:00
parent 76a263d0f9
commit 8f1171fe99
6676 changed files with 1724268 additions and 0 deletions
--- a/skills/macbook-optimizer/SKILL.md
+++ b/skills/macbook-optimizer/SKILL.md
@@ -0,0 +1,233 @@
+---
+name: macbook-optimizer
+description: Complete MacBook optimization suite: monitoring, troubleshooting, cleanup, and performance tuning. Works on all Macs (Intel & Apple Silicon). No extra tools required.
+homepage: https://github.com/T4btc/macbook-optimizer
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "💻",
+        "os": ["darwin"],
+        "requires": { "bins": ["system_profiler", "top", "ps", "df", "du"] },
+      },
+  }
+---
+
+# 💻 MacBook Optimizer
+
+_Complete MacBook health & performance suite - No installation required_
+
+A comprehensive, user-friendly skill for monitoring, optimizing, and troubleshooting MacBook performance. Works on **all Macs** (Intel & Apple Silicon) using built-in macOS tools. Unlike specialized tools, this provides actionable recommendations and automated fixes.
+
+## Why This Skill is Better
+
+✅ **No installation required** - Uses built-in macOS tools  
+✅ **Works on all Macs** - Intel & Apple Silicon  
+✅ **Actionable recommendations** - Not just metrics, but solutions  
+✅ **Automated fixes** - Can clean up and optimize automatically  
+✅ **User-friendly** - Plain language, not technical jargon  
+✅ **Complete suite** - Monitoring + troubleshooting + optimization  
+✅ **GUI-first** - Opens visual tools automatically for non-technical users  
+✅ **Visual reports** - Charts, graphs, and emoji indicators for easy understanding  
+
+## Capabilities
+
+### 🔍 System Monitoring
+- **CPU Analysis**: Real-time CPU usage, temperature (via `powermetrics`), load averages, per-process breakdown
+- **Memory Health**: RAM usage, memory pressure, swap usage, identify memory leaks
+- **Disk Intelligence**: Space analysis, find large files/folders, duplicate detection, cache locations
+- **Battery Diagnostics**: Health percentage, cycle count, capacity, charging status, power consumption
+- **Thermal Monitoring**: System temperature, thermal state, identify overheating causes
+- **Network Activity**: Bandwidth usage, active connections, identify bandwidth hogs
+
+### ⚡ Optimization Tools
+- **Smart Cleanup**: Automatically find and remove caches, logs, temp files, downloads, duplicates
+- **Process Management**: Identify resource hogs, suggest optimizations, safe process termination
+- **Startup Optimization**: Manage login items, background apps, reduce boot time
+- **Storage Optimization**: Find large files, suggest deletions, empty trash, clear caches
+- **Performance Tuning**: System settings recommendations, disable unnecessary services
+
+### 🛠 Troubleshooting
+- **Slowdown Diagnosis**: Identify bottlenecks (CPU/memory/disk/network), root cause analysis
+- **Overheating Solutions**: Find hot processes, suggest cooling strategies, thermal management
+- **Memory Issues**: Detect leaks, suggest app restarts, memory optimization
+- **Disk Problems**: Full disk analysis, permission issues, disk health checks
+- **Battery Issues**: Health degradation, charging problems, power management
+
+## Usage Examples
+
+**Complete system check (with GUI):**
+```
+Run a full system health check, show me the results visually, and fix any issues
+```
+
+**Performance optimization (GUI mode):**
+```
+My MacBook is slow. Open Activity Monitor and show me what's using resources
+```
+
+**Overheating issue:**
+```
+My MacBook is overheating. Show me the hot processes in Activity Monitor
+```
+
+**Disk cleanup (visual):**
+```
+Show me my disk usage visually and clean up automatically
+```
+
+**Memory problems (GUI):**
+```
+My Mac is using too much memory. Open Activity Monitor and highlight the memory hogs
+```
+
+**Battery health (visual):**
+```
+Show me my battery health in System Settings and optimize power settings
+```
+
+**Startup optimization:**
+```
+What's slowing down my Mac startup? Show me login items in System Settings
+```
+
+**Find large files (visual):**
+```
+Find all files larger than 1GB, show them in Finder, and suggest what I can delete
+```
+
+**GUI-first requests:**
+```
+Show me everything in Activity Monitor
+Open System Settings to battery settings
+Show me disk usage in a visual way
+```
+
+## Advanced Commands Available
+
+The agent intelligently uses these macOS tools:
+
+**System Info:**
+- `system_profiler` - Complete hardware/software information
+- `sysctl` - System parameters and kernel settings
+- `sw_vers` - macOS version information
+
+**Process Monitoring:**
+- `top` / `htop` - Real-time process monitoring
+- `ps` - Process status and details
+- `lsof` - List open files and network connections
+- `launchctl list` - Background services and daemons
+
+**Resource Monitoring:**
+- `vm_stat` - Virtual memory statistics
+- `iostat` - Disk I/O statistics
+- `netstat` / `lsof -i` - Network connections
+- `powermetrics` - CPU/GPU power and temperature (Apple Silicon)
+- `pmset -g therm` - Thermal state (Intel Macs)
+
+**Disk Management:**
+- `df` - Disk space usage
+- `du` - Directory size analysis
+- `find` - Locate large files
+- `mdutil` - Spotlight index management
+
+**Power & Battery:**
+- `pmset` - Power management settings
+- `ioreg` - I/O registry (battery info)
+- `system_profiler SPPowerDataType` - Battery details
+
+**Cleanup:**
+- `rm` - Safe file removal (with confirmation)
+- `purge` - Memory purge
+- Cache locations: `~/Library/Caches`, `/Library/Caches`, `/var/folders`
+
+**GUI Tools (Visual Interface):**
+- `open -a "Activity Monitor"` - Launch Activity Monitor (CPU, Memory, Energy, Disk, Network)
+- `open -a "System Settings"` - Open System Settings (all system preferences)
+- `open -a "System Settings" && open "x-apple.systempreferences:com.apple.preference.battery"` - Battery settings
+- `open -a "System Settings" && open "x-apple.systempreferences:com.apple.preference.storage"` - Storage management
+- `open -a "System Settings" && open "x-apple.systempreferences:com.apple.LoginItems-Settings.extension"` - Login items
+- `open -a "Finder"` - Open Finder for file browsing
+- `open ~/Library/Caches` - Open Caches folder in Finder
+- `open ~/Downloads` - Open Downloads folder
+- `open "x-apple.systempreferences:com.apple.preference.security?Privacy_AllFiles"` - Privacy settings
+- `open "x-apple.systempreferences:com.apple.preference.security?Privacy_Accessibility"` - Accessibility permissions
+
+**Visual Reports:**
+- Generate HTML reports with charts (CPU, Memory, Disk usage over time)
+- Create visual summaries with emoji indicators (🟢 Good, 🟡 Warning, 🔴 Critical)
+- Open relevant System Settings panels automatically based on findings
+
+## 🎨 GUI-First Experience
+
+**For users who prefer visual interfaces**, the agent can:
+
+- 📊 **Open Activity Monitor** automatically when showing system stats
+- ⚙️ **Navigate System Settings** to relevant panels (Battery, Storage, Privacy)
+- 📁 **Open Finder** to specific folders (Caches, Downloads, Large files)
+- 📈 **Generate visual reports** with charts and graphs (HTML format)
+- 🎯 **Highlight issues** in GUI apps with clear indicators
+- 🔍 **Show step-by-step** with screenshots or GUI navigation
+
+**Example GUI Workflow:**
+1. User: "My Mac is slow"
+2. Agent opens Activity Monitor → highlights CPU/Memory hogs
+3. Agent opens System Settings → shows relevant optimization settings
+4. Agent provides visual summary with emoji status indicators
+
+## Intelligent Automation
+
+The agent can:
+- ✅ **Automatically clean** safe caches and temp files (with user confirmation)
+- ✅ **Suggest optimizations** based on system analysis
+- ✅ **Provide step-by-step fixes** for common issues (with GUI navigation)
+- ✅ **Monitor continuously** if requested (via cron jobs)
+- ✅ **Generate visual reports** with charts, graphs, and actionable recommendations
+- ✅ **Open GUI tools** automatically when showing system information
+
+## Safety & Privacy
+
+- 🔒 **Always asks before** deleting files or killing processes
+- 🔒 **Protects system files** and critical processes
+- 🔒 **Reviews before action** - shows what will be deleted
+- 🔒 **No data collection** - everything runs locally
+- 🔒 **Respects privacy** - never sends data externally
+
+## Requirements
+
+- ✅ **macOS only** (Intel & Apple Silicon)
+- ✅ **No installation needed** - uses built-in tools
+- ✅ **Optional**: `htop` for prettier process view (`brew install htop`)
+- ✅ **Optional**: `mactop` for Apple Silicon detailed metrics (`brew install mactop`)
+
+## How to Use GUI Tools
+
+When the user asks for visual information or mentions they're not technical:
+
+1. **Always open Activity Monitor** when showing CPU/Memory/Process info
+2. **Navigate to relevant System Settings** panels automatically
+3. **Open Finder** to specific folders when discussing files
+4. **Generate visual summaries** with emoji indicators (🟢🟡🔴)
+5. **Provide step-by-step GUI navigation** instructions
+
+**GUI Navigation Commands:**
+- CPU issues → Open Activity Monitor, sort by CPU
+- Memory issues → Open Activity Monitor, sort by Memory
+- Battery → Open System Settings → Battery
+- Storage → Open System Settings → General → Storage
+- Login items → Open System Settings → General → Login Items
+- Large files → Open Finder, navigate to location, sort by size
+
+## Comparison with Other Tools
+
+| Feature | macbook-optimizer | mactop |
+|---------|------------------|--------|
+| Installation required | ❌ No | ✅ Yes (brew) |
+| Works on Intel Macs | ✅ Yes | ❌ No (Apple Silicon only) |
+| Actionable recommendations | ✅ Yes | ❌ No (metrics only) |
+| Automated cleanup | ✅ Yes | ❌ No |
+| Troubleshooting | ✅ Yes | ❌ No |
+| User-friendly | ✅ Yes | ⚠️ Technical |
+| Complete suite | ✅ Yes | ⚠️ Monitoring only |
+| GUI-first experience | ✅ Yes | ❌ CLI only |
+| Visual reports | ✅ Yes | ❌ Text only |