xcode-dx-skills

AI skills to improve developer experience on Xcode projects. These skills help answer common questions like:

• Why did the build fail? - Parse and explain build errors with actionable guidance
• Why is the build so slow? - Identify slow targets and optimization opportunities
• What do these test failures mean? - Analyze xcresult bundles for insights
• What are my dependencies doing? - Visualize SPM dependency graphs and conflicts

Installation

Claude Code / Open Code

Clone this repository and add it as a plugin:

git clone https://github.com/youruser/xcode-dx-skills.git ~/.claude/plugins/xcode-dx-skills

Or symlink to your plugins directory:

ln -s /path/to/xcode-dx-skills ~/.claude/plugins/xcode-dx-skills

Manual Installation

Copy individual skills to your personal skills directory:

cp -r skills/xcode-build-errors ~/.claude/skills/

Available Skills

Skill	Trigger	Description
xcode-build-errors	Auto	Parses build failures, explains errors, suggests fixes
xcode-build-performance	Auto	Analyzes build timing, identifies slow targets
xcode-test-analysis	Manual	Analyzes .xcresult bundles for test insights
xcode-deps	Manual	SPM dependency graph and version conflict detection
xcode-log-filter	Auto	Filters noisy console output to show actionable data
xcode-health	Manual	Audits project configuration for common issues

Trigger Types

• Auto: The AI will automatically invoke when it detects relevant context (e.g., build errors in console output)
• Manual: Invoke explicitly with /xcode-dx-skills:skill-name or /skill-name

Usage Examples

Analyzing Build Failures

Paste your build output or point to a log file:

/xcode-build-errors ~/Library/Developer/Xcode/DerivedData/MyApp-xxx/Logs/Build/

Or just paste build output and the skill will auto-trigger.

Build Performance Analysis

Run your build with timing summary enabled:

xcodebuild -scheme MyApp -showBuildTimingSummary 2>&1 | pbcopy

Then paste the output - the skill will identify slow targets.

Test Analysis

/xcode-test-analysis path/to/Test.xcresult

Analyzes test results to find:

• Failed tests with failure messages
• Slowest tests
• Potentially flaky tests (if historical data available)
• Coverage gaps

Dependency Analysis

/xcode-deps

Generates a dependency graph from your Package.swift or Package.resolved.

Requirements

• macOS (these skills use Xcode tooling)
• Xcode Command Line Tools (xcode-select --install)
• Swift 5.5+ (for script execution)

How It Handles Large Logs

Xcode builds can produce massive output (10MB+). These skills use a hybrid approach:

1. Pre-filtering: Swift scripts extract only relevant lines before AI processing
2. Grouping: Duplicate errors/warnings are grouped (e.g., "50 occurrences" instead of 50 identical lines)
3. Structured output: Parsed data is returned as JSON for efficient querying

Project Structure

xcode-dx-skills/
├── .claude-plugin/
│   └── plugin.json          # Plugin manifest
├── skills/
│   ├── xcode-build-errors/
│   │   ├── SKILL.md         # Skill instructions
│   │   └── scripts/         # Swift parsing scripts
│   ├── xcode-build-performance/
│   ├── xcode-test-analysis/
│   ├── xcode-deps/
│   ├── xcode-log-filter/
│   └── xcode-health/
├── fixtures/                 # Sample logs for testing
├── README.md
└── LICENSE

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

Adding a New Skill

1. Create a directory under skills/ with your skill name
2. Add a SKILL.md with frontmatter and instructions
3. Add any supporting scripts in a scripts/ subdirectory
4. Add test fixtures if applicable
5. Update this README

License

MIT License - see LICENSE for details.

Acknowledgments

Built on the Agent Skills open standard for cross-tool compatibility.