From 05ab53099231a41982a5abffdbd8a8d8da55e1ba Mon Sep 17 00:00:00 2001
From: Michael <m.anderson23@icloud.com>
Date: Wed, 7 Jan 2026 20:13:02 -0600
Subject: [PATCH] Add creating-swift-skills meta-skill

---
 creating-swift-skills/SKILL.md | 67 ++++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 creating-swift-skills/SKILL.md

diff --git a/creating-swift-skills/SKILL.md b/creating-swift-skills/SKILL.md
new file mode 100644
index 0000000..41fed93
--- /dev/null
+++ b/creating-swift-skills/SKILL.md
@@ -0,0 +1,67 @@
+---
+name: creating-swift-skills
+description: Guide for creating Swift/iOS skills. Use when contributing new skills to ensure consistent format and quality.
+---
+
+# Creating Swift Skills
+
+## Overview
+
+Create focused, actionable skills for Swift and iOS development following repository conventions.
+
+## Structure
+
+```
+skill-name/
+├── SKILL.md              # Main entry point
+├── references/           # Optional deep-dives
+│   └── topic.md
+└── assets/templates/     # Optional starter files
+    └── bootstrap/
+```
+
+## Workflow
+
+### 1. Define scope
+
+Choose a specific topic:
+- Framework or API (Swift Testing, SwiftUI patterns, Concurrency)
+- Workflow (debugging, performance audit, refactoring)
+- Migration path (XCTest to Swift Testing)
+
+Avoid duplicating Apple docs without adding value.
+
+### 2. Copy the template
+
+```bash
+cp -r assets/templates/skill-template my-skill-name
+```
+
+### 3. Write frontmatter
+
+```yaml
+---
+name: skill-name
+description: What it does + when to invoke it.
+---
+```
+
+### 4. Add Overview and Workflow
+
+- Overview: One to two sentences
+- Workflow: Numbered steps with code examples
+
+### 5. Add references (optional)
+
+Create `references/*.md` for detailed content. One topic per file.
+
+### 6. Run quality checklist
+
+See `references/quality-checklist.md` before submitting.
+
+## Reference material
+
+- See `references/skill-structure.md` for file anatomy.
+- See `references/writing-guidelines.md` for tone and style.
+- See `references/quality-checklist.md` for pre-submission review.
+- See `assets/templates/skill-template/` for starter template.