mirror of
https://github.com/Dimillian/Skills.git
synced 2026-03-25 08:55:54 +00:00
Add creating-swift-skills meta-skill
This commit is contained in:
parent
6fe317b4d3
commit
05ab530992
1 changed files with 67 additions and 0 deletions
67
creating-swift-skills/SKILL.md
Normal file
67
creating-swift-skills/SKILL.md
Normal file
|
|
@ -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.
|
||||
Loading…
Reference in a new issue