Back to Skills

macos-discovery

verified

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.

View on GitHub

Marketplace

macinventory-marketplace

ksk-incom/MacInventory

Plugin

macinventory

Repository

ksk-incom/MacInventory
3stars

macinventory/skills/macos-discovery/SKILL.md

Last Verified

January 21, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/ksk-incom/MacInventory/blob/main/macinventory/skills/macos-discovery/SKILL.md -a claude-code --skill macos-discovery

Installation paths:

Claude
.claude/skills/macos-discovery/
Powered by add-skill CLI

Instructions

# macOS Application Configuration Discovery

This skill provides knowledge and methodology for discovering where macOS applications store their configuration files, preferences, and settings. It enables effective contribution to MacInventory's hints database.

## Overview

macOS applications store their configuration in predictable locations based on app type, development era, and sandboxing status. Understanding these patterns enables systematic discovery of config paths for any application.

### The Three-Tier Discovery System

MacInventory uses a three-tier approach to find application configurations:

1. **Tier 1 - Hints Database**: Curated YAML entries with verified config paths (highest trust)
2. **Tier 2 - Conventions**: Automatic scanning of standard macOS locations
3. **Tier 3 - LLM Research**: Web search and intelligent discovery for unknown apps

This skill supports all three tiers by providing the knowledge needed to research and document application configurations.

## Standard macOS Configuration Locations

### Primary Locations (Check First)

| Location                         | Purpose           | Typical Contents           |
|----------------------------------|-------------------|----------------------------|
| `~/Library/Application Support/` | Modern app data   | Databases, caches, configs |
| `~/Library/Preferences/`         | Preference plists | `.plist` settings files    |
| `~/.config/`                     | XDG standard      | CLI tool configs           |
| `~/Library/Containers/`          | Sandboxed apps    | App-specific storage       |

### Secondary Locations (App-Specific)

| Location                             | Purpose         | Example Apps               |
|--------------------------------------|-----------------|----------------------------|
| `~/.appname/`                        | Dotfile configs | CLI tools, dev tools       |
| `~/Library/Group Containers/`        | Shared app data | iCloud-enabled apps        |
| `~/Library/Cach

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
7666 chars