macinventory

Generate comprehensive Mac environment inventory and restoration guide

Researches unknown macOS applications to discover their configuration file locations. This agent performs Tier 3 discovery for applications not found in the hints database or via standard conventions. It uses web search to find where apps store their settings and outputs YAML snippets suitable for app-hints.yaml. <example> User: Research where Obsidian stores its configuration files Agent: I'll search for Obsidian's config locations and create a hints entry... </example> <example> User: Find the settings paths for these apps: Raycast, Arc, Linear Agent: I'll research each application and provide hints entries for all three... </example> <example> User: Add Warp terminal to the hints database Agent: Researching Warp's configuration storage to create a proper hints entry... </example>

Validates backed-up configuration files for quality and security. This agent performs quality assurance on configuration backups, checking file integrity, format validity, and ensuring no secrets were leaked. <example> User: Validate the backed up configs at ~/mac-inventory/configs/ Agent: I'll check all configuration files for integrity and security issues... </example> <example> User: Check if any secrets leaked into the backup Agent: Scanning all backed up files for potential credential exposure... </example> <example> User: Verify the plist files are valid Agent: I'll validate all property list files for correct XML/binary format... </example>

Generates comprehensive Restoration-Guide.md using deterministic prompting techniques. This agent uses structured phases, mandatory checkpoints, and self-verification to ensure consistent, complete output every time. It reads state.yaml and backed-up configs to create professional restoration documentation. <example> User: Generate a comprehensive Restoration-Guide.md for the Mac inventory at ~/mac-inventory Agent: I'll create the restoration guide using my 3-phase process. Starting Phase 1: Data Collection... </example> <example> User: Create the restoration guide from the inventory output Agent: Beginning deterministic guide generation. Phase 1: Reading state.yaml to extract system details... </example> <example> User: Update the guide with more detailed Homebrew instructions Agent: I'll enhance the Homebrew section. First, let me verify the current guide structure... </example>

Validates system prerequisites for MacInventory without showing technical details. Returns a clean summary of tool availability. <example> Context: User starts the /inventory command user: "/inventory" assistant: "I'll check prerequisites first." <commentary> Before running inventory, verify required tools are available. </commentary> assistant: "I'll use the prerequisites-checker agent to validate the environment." </example> <example> Context: User asks about prerequisites user: "What do I need to run MacInventory?" assistant: "Let me check what's installed on your system." <commentary> User wants to know prerequisites status. </commentary> assistant: "I'll use the prerequisites-checker agent to check your system." </example> <example> Context: Inventory failed due to missing tool user: "The inventory failed, what's wrong?" assistant: "Let me verify your prerequisites." <commentary> Troubleshooting by checking prerequisites first. </commentary> assistant: "I'll use the prerequisites-checker agent to diagnose the issue." </example>

Performs final quality assurance on complete MacInventory output. This agent validates that all expected output files exist, are properly formatted, and contain complete information with no placeholder text. <example> User: Verify the inventory output at ~/mac-inventory for completeness Agent: I'll perform a comprehensive quality check on all output files... </example> <example> User: Check if the restoration guide is complete Agent: Validating the Restoration-Guide.md for all required sections... </example> <example> User: Run final QA on the Mac inventory Agent: Running comprehensive verification on state.yaml, Brewfile, and guide... </example>

This skill should be used when the user asks to "add app to hints database", "research app settings", "find application preferences", "discover config paths", "macOS config discovery", "where does [app] store settings", or needs to understand where macOS applications store their settings and configuration files.