@thiennc/ios-skills 1.2.0 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +49 -94
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,160 +1,115 @@
|
|
|
1
1
|
# Swift iOS Skills Community
|
|
2
2
|
|
|
3
|
-
[](skills/)
|
|
4
4
|
[](https://swift.org)
|
|
5
|
-
[](https://developer.apple.com)
|
|
6
5
|
[](https://github.com/thiennc-tesoglobal/ios-skills/actions/workflows/validate-repository.yml)
|
|
7
6
|
[](LICENSE)
|
|
8
7
|
|
|
9
|
-
|
|
8
|
+
**94 focused Agent Skills for modern Swift and Apple-platform development.**
|
|
10
9
|
|
|
11
|
-
The collection
|
|
10
|
+
The collection gives coding agents practical guidance for architecture,
|
|
11
|
+
implementation, testing, performance, accessibility, security, Apple frameworks,
|
|
12
|
+
and App Store delivery. It is a knowledge layer, not an app template or runtime
|
|
13
|
+
dependency.
|
|
12
14
|
|
|
13
|
-
|
|
15
|
+
## Core principles
|
|
14
16
|
|
|
15
|
-
|
|
17
|
+
- Use one workflow skill and only the specialists required by the task.
|
|
18
|
+
- Prefer current Swift, SwiftUI, concurrency, and Apple framework APIs.
|
|
19
|
+
- Verify work with builds, tests, Simulator runs, and physical devices when hardware matters.
|
|
20
|
+
- Keep each skill focused, self-contained, and progressively disclosed through references.
|
|
16
21
|
|
|
17
|
-
|
|
18
|
-
-
|
|
19
|
-
|
|
20
|
-
- **Evidence-based results:** prefer real build, test, runtime, and Simulator verification over assumptions.
|
|
21
|
-
|
|
22
|
-
For an entire app or substantial multi-file feature, start with [`ios-app-workflow`](skills/ios-app-workflow/). For a narrow task, select the matching specialist directly.
|
|
22
|
+
For a complete app or substantial feature, start with
|
|
23
|
+
[`ios-app-workflow`](skills/ios-app-workflow/). For a narrow task, load the matching
|
|
24
|
+
specialist directly.
|
|
23
25
|
|
|
24
26
|
```text
|
|
25
|
-
|
|
27
|
+
Request → ios-app-workflow → focused skills → implementation → verification
|
|
26
28
|
```
|
|
27
29
|
|
|
28
30
|
## Install
|
|
29
31
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
Choose skills interactively:
|
|
32
|
+
Interactive installer:
|
|
33
33
|
|
|
34
34
|
```sh
|
|
35
35
|
npx @thiennc/ios-skills
|
|
36
36
|
```
|
|
37
37
|
|
|
38
|
-
Install the
|
|
38
|
+
Install one skill or the complete collection:
|
|
39
39
|
|
|
40
40
|
```sh
|
|
41
41
|
npx @thiennc/ios-skills --skill ios-app-workflow
|
|
42
|
-
```
|
|
43
|
-
|
|
44
|
-
Install the complete collection only when broad framework coverage is required:
|
|
45
|
-
|
|
46
|
-
```sh
|
|
47
42
|
npx @thiennc/ios-skills --all
|
|
48
43
|
```
|
|
49
44
|
|
|
50
|
-
|
|
45
|
+
Direct GitHub installation:
|
|
51
46
|
|
|
52
47
|
```sh
|
|
53
48
|
npx skills add thiennc-tesoglobal/ios-skills
|
|
54
49
|
```
|
|
55
50
|
|
|
56
|
-
Smaller installations provide agents with a cheaper and more precise discovery surface. The repository follows the open [Agent Skills specification](https://agentskills.io).
|
|
57
|
-
|
|
58
51
|
### Claude Code
|
|
59
52
|
|
|
60
|
-
Add the marketplace and install a bundle:
|
|
61
|
-
|
|
62
53
|
```sh
|
|
63
54
|
/plugin marketplace add thiennc-tesoglobal/ios-skills
|
|
64
55
|
/plugin install all-ios-skills@ios-skills
|
|
65
56
|
```
|
|
66
57
|
|
|
67
|
-
Focused bundles
|
|
68
|
-
|
|
69
|
-
```sh
|
|
70
|
-
/plugin install swiftui-skills@ios-skills
|
|
71
|
-
/plugin install swift-core-skills@ios-skills
|
|
72
|
-
/plugin install ios-engineering-skills@ios-skills
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
### Manual installation
|
|
76
|
-
|
|
77
|
-
Clone the repository and copy the required folders from [`skills/`](skills/) into the skills directory supported by your agent. Keep each folder intact so its instructions, references, scripts, and evaluations remain together.
|
|
58
|
+
Focused bundles include `swiftui-skills`, `swift-core-skills`,
|
|
59
|
+
`ios-engineering-skills`, and framework-specific collections.
|
|
78
60
|
|
|
79
61
|
## Use
|
|
80
62
|
|
|
81
|
-
|
|
63
|
+
Name the skill explicitly when routing needs to be deterministic:
|
|
82
64
|
|
|
83
65
|
```text
|
|
84
|
-
Use $ios-app-workflow to build a
|
|
85
|
-
|
|
66
|
+
Use $ios-app-workflow to build a SwiftUI feature with SwiftData,
|
|
67
|
+
accessibility, tests, and verified Simulator behavior.
|
|
86
68
|
```
|
|
87
69
|
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
- `swift-concurrency` — actor isolation, `Sendable`, and async code
|
|
91
|
-
- `swiftdata` — models, queries, relationships, and migrations
|
|
92
|
-
- `swiftui-animation` — transitions, springs, and Reduce Motion behavior
|
|
93
|
-
- `swiftui-responsive-layout` — clipping, overlap, safe areas, keyboard, and cross-size adaptation
|
|
94
|
-
- `swift-code-review` — evidence-backed Swift/SwiftUI diff review with concurrency, ownership, errors, and state checks
|
|
95
|
-
- `ios-accessibility` — VoiceOver, Dynamic Type, and accessible interactions
|
|
96
|
-
- `storekit` — purchases and subscriptions
|
|
97
|
-
- `ios-simulator` — build, install, launch, and runtime verification
|
|
70
|
+
Common specialists:
|
|
98
71
|
|
|
99
|
-
|
|
72
|
+
- [`swift-concurrency`](skills/swift-concurrency/) — isolation, `Sendable`, tasks, and async code
|
|
73
|
+
- [`swiftdata`](skills/swiftdata/) — models, queries, relationships, and migrations
|
|
74
|
+
- [`swiftui-patterns`](skills/swiftui-patterns/) — state, composition, and project structure
|
|
75
|
+
- [`swiftui-responsive-layout`](skills/swiftui-responsive-layout/) — adaptive layout failures
|
|
76
|
+
- [`swift-code-review`](skills/swift-code-review/) — evidence-backed Swift review
|
|
77
|
+
- [`ios-simulator`](skills/ios-simulator/) — build, launch, and runtime verification
|
|
78
|
+
- [`core-haptics`](skills/core-haptics/) — custom tactile patterns and AHAP playback
|
|
100
79
|
|
|
101
|
-
|
|
80
|
+
Browse the complete catalog in [`skills/`](skills/). Installing all skills does not
|
|
81
|
+
mean every skill should be loaded for every task.
|
|
102
82
|
|
|
103
|
-
|
|
104
|
-
|---|---:|---|
|
|
105
|
-
| `all-ios-skills` | 89 | Complete collection |
|
|
106
|
-
| `swiftui-skills` | 11 | SwiftUI UI, responsive layout, navigation, animation, performance, and interop |
|
|
107
|
-
| `swift-core-skills` | 10 | Swift language, architecture, concurrency, data, and testing |
|
|
108
|
-
| `ios-app-framework-skills` | 15 | Widgets, StoreKit, App Intents, maps, media, PDFs, and CarPlay |
|
|
109
|
-
| `ios-data-framework-skills` | 8 | CloudKit, HealthKit, EventKit, Contacts, Wallet, and weather |
|
|
110
|
-
| `ios-ai-ml-skills` | 5 | Foundation Models, Core ML, Vision, language, and speech |
|
|
111
|
-
| `ios-engineering-skills` | 18 | Delivery, code review, networking, accessibility, security, diagnostics, and App Store readiness |
|
|
112
|
-
| `ios-hardware-skills` | 8 | Bluetooth, NFC, motion, PencilKit, RealityKit, and accessories |
|
|
113
|
-
| `ios-platform-skills` | 10 | HomeKit, SharePlay, CallKit, and specialized integrations |
|
|
114
|
-
| `ios-gaming-skills` | 4 | GameKit, SpriteKit, SceneKit, and TabletopKit |
|
|
115
|
-
| `apple-kit-skills` | 39 | Framework-focused Apple Kit subset |
|
|
83
|
+
## Coverage
|
|
116
84
|
|
|
117
|
-
|
|
85
|
+
The collection covers:
|
|
118
86
|
|
|
119
|
-
|
|
87
|
+
- Swift language, concurrency, architecture, testing, SwiftData, and Core Data
|
|
88
|
+
- SwiftUI layout, navigation, animation, performance, accessibility, and UIKit interop
|
|
89
|
+
- Apple app, data, hardware, media, AI/ML, gaming, and platform frameworks
|
|
90
|
+
- Networking, security, diagnostics, localization, App Review, and delivery workflows
|
|
120
91
|
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
├── skills/ # Skill instructions, references, scripts, and local evals
|
|
124
|
-
├── evals/ # Published behavior scenarios and assertions
|
|
125
|
-
├── tests/ # Repository and diagnostic-helper tests
|
|
126
|
-
├── .claude-plugin/ # Claude Code marketplace bundles
|
|
127
|
-
├── .tessl-plugin/ # Tessl package metadata
|
|
128
|
-
└── tessl.json
|
|
129
|
-
```
|
|
92
|
+
Current inventory: **95 skills**, **307 local evaluation cases**, and
|
|
93
|
+
**274 published evaluation scenarios**.
|
|
130
94
|
|
|
131
95
|
## Quality
|
|
132
96
|
|
|
133
|
-
Pull requests validate
|
|
97
|
+
Pull requests validate metadata, references, evaluations, bundle membership, public
|
|
98
|
+
discovery, tests, and SDK-sensitive compile fixtures.
|
|
134
99
|
|
|
135
100
|
```sh
|
|
136
101
|
python3 .github/scripts/validate_repository.py
|
|
137
102
|
python3 -m unittest discover -s tests -v
|
|
138
|
-
npm ci
|
|
139
103
|
npm test
|
|
140
104
|
npm run pack:check
|
|
141
|
-
npx --yes skills@1.5.23 add . --list
|
|
142
105
|
```
|
|
143
106
|
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
## Contributing
|
|
147
|
-
|
|
148
|
-
Issues and pull requests are welcome. Read [`CONTRIBUTING.md`](CONTRIBUTING.md) for skill structure, evaluation requirements, local checks, and the pull-request checklist.
|
|
149
|
-
|
|
150
|
-
Use [Issues](https://github.com/thiennc-tesoglobal/ios-skills/issues) for bugs and focused proposals, or [Discussions](https://github.com/thiennc-tesoglobal/ios-skills/discussions) for broader ideas.
|
|
107
|
+
See [`CONTRIBUTING.md`](CONTRIBUTING.md) for authoring rules and
|
|
108
|
+
[`CHANGELOG.md`](CHANGELOG.md) for notable changes.
|
|
151
109
|
|
|
152
110
|
## License
|
|
153
111
|
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
license applies to the remaining collection.
|
|
159
|
-
|
|
160
|
-
Apple frameworks, APIs, documentation, session content, and trademarks belong to Apple Inc. This independent project is not affiliated with, endorsed by, or sponsored by Apple.
|
|
112
|
+
The project uses the [PolyForm Perimeter License 1.0.0](LICENSE). The adapted
|
|
113
|
+
[`swift-code-review`](skills/swift-code-review/) skill keeps its upstream Apache-2.0
|
|
114
|
+
attribution. Apple frameworks, documentation, and trademarks belong to Apple Inc.
|
|
115
|
+
This project is independent and not endorsed by Apple.
|