Contributing to Claude Code iOS Skills

Contributing to Claude Code iOS Skills

First off, thank you for considering contributing to this project! It's people like you that make these skills better for the entire iOS development community.

Table of Contents

• Code of Conduct
• How Can I Contribute?
• Contribution Guidelines
• Skill Development Guidelines
• Testing Your Changes
• Submitting Changes

Code of Conduct

This project adheres to a code of conduct that all contributors are expected to follow:

• Be respectful and inclusive
• Welcome newcomers and learners
• Focus on what is best for the community
• Show empathy towards others

How Can I Contribute?

Reporting Bugs

Before creating bug reports, please check existing issues to avoid duplicates.

When creating a bug report, include:

• Clear title: Describe the issue concisely
• Description: Detailed explanation of the problem
• Steps to reproduce: How to trigger the issue
• Expected behavior: What should happen
• Actual behavior: What actually happens
• Environment: Claude Code version, OS, etc.

**Example:**

**Title**: coding-best-practices skill not detecting force unwrapping

**Description**: The skill misses force unwrapping when used in guard statements

**Steps to Reproduce**:
1. Create a Swift file with `guard let x = y! else { return }`
2. Run coding-best-practices skill
3. Observe that force unwrap is not flagged

**Expected**: Should flag the force unwrapping with High priority
**Actual**: No warning given
**Environment**: Claude Code 1.0, macOS 14

Suggesting Enhancements

Enhancement suggestions are tracked as GitHub issues. When creating an enhancement suggestion, include:

• Clear title: Short, descriptive name
• Use case: Why is this enhancement needed?
• Proposed solution: How should it work?
• Alternatives: Other approaches considered
• Examples: Code examples if applicable

Contributing New Skills

We welcome new skills! Before creating a new skill:

1. Check roadmap: See if it's already planned
2. Open an issue: Discuss the skill idea first
3. Get feedback: Ensure it fits the project
4. Follow guidelines: Use skill-creator skill for structure

Improving Existing Skills

Ways to improve existing skills:

• Add missing patterns or anti-patterns
• Improve examples and explanations
• Fix incorrect recommendations
• Update for new Swift/iOS versions
• Improve documentation
• Better modularization

Documentation

Help improve documentation:

• Fix typos or unclear instructions
• Add usage examples
• Improve installation guide
• Create tutorials or blog posts
• Add screenshots or GIFs

Contribution Guidelines

Getting Started

1. Fork the repository on GitHub
2. Clone your fork locally:

   git clone https://github.com/YOUR_USERNAME/