skill-scanner_skill

Overview

This skill scans and lists Claude agent skills registered on a Mac, providing a safe read-only inventory. It helps you discover installed skills, export results as JSON, and optionally scan specified project directories with user confirmation.

How this skill works

The scanner inspects system and user-level locations where Claude agent skills are registered and aggregates metadata into a readable list. It can optionally traverse one or more project directories to detect skills in development, but always prompts for user confirmation before scanning external project folders. Output can be printed or emitted as JSON for integration with other tools.

When to use it

• Check which Claude agent skills are currently installed on your Mac.
• Audit skills before upgrades or system changes to ensure compatibility.
• Build an inventory for documentation or development handoffs.
• Quickly detect skills present in one or more project directories.
• Export skill lists to JSON for tooling or automation.

Best practices

• Run the basic scan first (user-level only) to get a quick, safe inventory.
• Always confirm prompts before scanning project directories to avoid unexpected traversal.
• Use JSON output when integrating results with other scripts or dashboards.
• Limit scanning to trusted project paths to reduce noise and speed up results.
• Review discovered metadata to verify versions and source locations.

Example use cases

• Perform a user-level scan to list installed skills before installing new ones.
• Scan ~/git and ~/work directories to find skills under development (confirm before running).
• Generate JSON output to feed into a CI job that verifies required skills are present.
• Create a consolidated inventory for a teammate when onboarding to a project.