swiftzilla/swift_deep_insight
skills/swift_deep_insight/SKILL.md
Identify unused code in Swift projects using the Swift compiler's index store. Detects unused classes, structs, functions, properties, protocols, and more. Use when cleaning up dead code, auditing codebase health, preparing for refactoring, or reviewing PR scope — even if they don't mention "index store" or "dead code" but describe removing unused or unreachable code.
$ install --global
skillsauthnpx skillsauth add swiftzilla/skills swift_deep_insightInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 2:19 AM32.5s2 files scanned
SKILL.md
- name:
- swift_deep_insight
- description:
- >-
- license:
- Proprietary
- compatibility:
- Requires macOS 14+. Universal macOS executable (arm64 + x86_64).
- author:
- SwiftZilla
- version:
- 1.0.0
Swift Deep Insight: Unused Code Detection
Detect unused (dead) code in Swift projects using the Swift compiler's index store.
Prerequisites
Xcode Projects
Build the project in Xcode first — the index store is created automatically at ~/Library/Developer/Xcode/DerivedData/<Project>/Index/DataStore.
SPM Projects
Build with xcodebuild -scheme <scheme> build or swift build.
Commands
Run from the project root or specify a path:
# Scan current directory
swift run swift-deep-insight --project-path .
# Verbose output
swift run swift-deep-insight --project-path . --verbose
# Xcode-clickable output (file:line:column:)
swift run swift-deep-insight --project-path . --xcode-format
# Include public declarations (normally excluded)
swift run swift-deep-insight --project-path . --include-public
Options
| Option | Description |
|--------|-------------|
| --project-path | Path to Swift project (default: current directory) |
| --verbose | Enable detailed logging |
| --xcode-format | Output in Xcode-compatible format (file:line:column:) |
| --include-public | Include public declarations in unused analysis |
| --exclude-tests | Exclude test targets from analysis |
| --build | Build the project before scanning (default: false) |
Gotchas
- No index store = limited results: Without the index store, analysis falls back to source-only parsing and misses cross-file references. Always build first.
- Runtime reflection is invisible: Code used via
responds(to:),perform(), or other runtime mechanisms will appear unused even though it's called. - External packages are not analyzed: Only your project's code is scanned, not dependencies.
- Public declarations are excluded by default: Public/API symbols are assumed to be used by consumers. Use
--include-publicto override. - Entry points are auto-detected:
main,@main,@NSApplicationMain, andAppDelegateare treated as roots — everything reachable from them is "used".
Workflow
- Build: Ensure the project is built so the index store is fresh
- Scan: Run the analyzer with appropriate flags
- Review: Examine unused declarations — verify each is truly dead code before removing
- Validate: After removal, rebuild and run tests to confirm nothing was incorrectly classified
Related Skills
swiftzilla/swiftzilla
tools
VerifiedTrustedCommunity
Use this skill when you need expert Swift/iOS architectural guidance, semantic codebase analysis, or PR impact reviews. It provides a senior mentor layer for Swift (SwiftUI, UIKit, Combine, Concurrency) and a semantic engine to query local code context. Trigger this skill to: 1. Validate architectural patterns before implementation using 'ask'. 2. Find and map local code dependencies using 'context'. 3. Analyze the risk and blast radius of a PR using 'review'. 4. Generate system overviews for onboarding using 'onboard'. 5. Troubleshoot runtime crashes with semantic LLDB tools using 'debug'. Activate even if specific keywords are missing but the intent is improving Swift code quality or understanding project structure.
4SKILL.mdUpdated Apr 15, 2026
swiftzilla/swift_testing
development
VerifiedTrustedCommunity
Swift Testing framework for unit tests, integration tests, and async testing with modern syntax.
4SKILL.mdUpdated Apr 15, 2026
swiftzilla/swift_swiftui
development
VerifiedTrustedCommunity
SwiftUI framework concepts including property wrappers, state management, and reactive UI patterns.
4SKILL.mdUpdated Apr 15, 2026
swiftzilla/swift_style
development
VerifiedTrustedCommunity
Swift style guidelines covering naming conventions, code organization, and best practices for writing idiomatic Swift code.
4SKILL.mdUpdated Apr 15, 2026