Contributing to Swift Patterns

January 27, 2026 · View on GitHub

We'd love your help making this skill better! Whether you're fixing outdated patterns, adding modern Swift APIs, or clarifying confusing guidance—every improvement helps developers write better code.

About Agent Skills

This repository follows the Agent Skills format. See the documentation for details on structure and format.

Ways to Contribute

Using skill-creator (recommended)

  • Propose changes in plain language
  • Let the skill generate or refine content
  • Review for Swift accuracy and consistency

Direct editing

  • Edit SKILL.md or files in references/ directly
  • Keep content focused and actionable
  • Maintain consistent structure across files

What to Contribute

✅ Fix incorrect Swift or SwiftUI guidance
✅ Add modern API patterns or flag deprecations
✅ Improve clarity in decision trees and checklists
✅ Expand reference files with practical patterns
✅ Update documentation in README or this guide

Quality Guidelines

Content focus

  • Swift and SwiftUI best practices only
  • Avoid mandating specific architectures or project structures
  • Use modern APIs and note deprecated alternatives
  • Show tradeoffs, not just prescriptive rules

Writing style

  • Clear and direct language
  • Practical code examples that work
  • Explain "when" and "why", not just "what"
  • Keep anti-patterns section focused on common mistakes

Pull Request Process

  1. Fork the repository and create a branch
  2. Make focused changes to one area
  3. Ensure SKILL.md and references stay consistent
  4. Open a PR with a clear description of changes

References

Questions?

Open an issue to discuss major changes before starting work.

Code of Conduct

Be respectful and constructive. Focus on making Swift guidance better for everyone.