swift-development

Other Community

Repo stars 0
Author repo skills-registry

Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

Core job: > Use when this capability is needed. swift package init --type library --name MyLibrary xcodebuild -workspace App.xcworkspace -…
Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

Structure: The skill is organized around “Prerequisites”, “Quick Start”, “New Swift Package”, “Build and Test”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
Invocation: Name swift-development directly; if the source includes slash commands, start with the command and then add task context.
Validation: Start small and check whether the result follows “Prerequisites / Quick Start / New Swift Package” before expanding.

Boundaries And Review

Dependencies: It usually needs no extra API key, so start with a small validation task.
Permissions: Declared permissions include read / write; ask the agent to state file, command, and rollback boundaries before acting.
Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.

Swift Development

Prerequisites

macOS with Xcode 15+ installed (Xcode 16+ for Swift 6)
Xcode Command Line Tools: xcode-select --install
Verify: xcodebuild -version and swift --version

Quick Start

New Swift Package

# Use the included script for full setup
./scripts/new_package.sh MyLibrary --type library --ios --macos

# Or manually
swift package init --type library --name MyLibrary

Build and Test

# SPM packages
swift build
swift test

# Xcode projects
xcodebuild -workspace App.xcworkspace -scheme App \
    -destination 'platform=iOS Simulator,name=iPhone 15' build

# Use included script for common options
./scripts/run_tests.sh --parallel --coverage

Format and Lint

# Use included script
./scripts/format_and_lint.sh Sources/

# Check mode (CI)
./scripts/format_and_lint.sh --check

Simulator Management

# Use included script
./scripts/simulator.sh list
./scripts/simulator.sh boot "iPhone 15"
./scripts/simulator.sh screenshot
./scripts/simulator.sh dark

Core Workflows

Building iOS Apps

# Debug build for simulator
xcodebuild -workspace App.xcworkspace -scheme App \
    -destination 'platform=iOS Simulator,name=iPhone 15' \
    build

# Release archive
xcodebuild archive \
    -workspace App.xcworkspace -scheme App \
    -archivePath ./build/App.xcarchive \
    -configuration Release

# Export IPA (use templates from assets/ExportOptions/)
xcodebuild -exportArchive \
    -archivePath ./build/App.xcarchive \
    -exportPath ./build/export \
    -exportOptionsPlist assets/ExportOptions/app-store.plist

Testing

# All tests
xcodebuild test -workspace App.xcworkspace -scheme App \
    -destination 'platform=iOS Simulator,name=iPhone 15'

# Specific test
xcodebuild test -only-testing:AppTests/MyTestClass/testMethod

# With coverage
xcodebuild test -enableCodeCoverage YES \
    -resultBundlePath ./TestResults.xcresult

App Installation

# Install on booted simulator
xcrun simctl install booted ./Build/Products/Debug-iphonesimulator/App.app

# Launch
xcrun simctl launch booted com.company.app

Official Documentation

Reference Links (for humans)

These are Apple's official documentation links for manual browsing:

Resource	URL
Swift Documentation	https://developer.apple.com/documentation/swift
SwiftUI	https://developer.apple.com/documentation/swiftui
Swift Concurrency	https://developer.apple.com/documentation/swift/concurrency
Swift Testing	https://developer.apple.com/documentation/testing

Note: Apple's documentation sites are JavaScript SPAs and cannot be fetched programmatically with WebFetch.

WebFetch-Compatible Sources

Use these GitHub-based sources for live documentation fetching:

Resource	URL
Swift Testing	https://github.com/apple/swift-testing
Swift Evolution Proposals	https://github.com/apple/swift-evolution/tree/main/proposals
Swift Compiler Docs	https://github.com/apple/swift/tree/main/docs
Swift Standard Library	https://github.com/apple/swift/tree/main/stdlib
Swift Async Algorithms	https://github.com/apple/swift-async-algorithms
Swift Collections	https://github.com/apple/swift-collections

When to Fetch Documentation

Use WebFetch to retrieve documentation from GitHub in these situations:

Swift Testing: When you need details on @Test, #expect, #require, traits, or parameterized tests
Swift Evolution: When checking accepted proposals for new language features
Framework Details: When implementing features from Apple's open-source Swift packages
Uncertainty: When you're unsure about current API patterns or best practices

How to fetch: Use WebFetch with GitHub URLs:

README: https://github.com/apple/swift-testing
Raw markdown: https://raw.githubusercontent.com/apple/swift-testing/main/README.md
Specific docs: https://github.com/apple/swift-evolution/blob/main/proposals/0409-access-level-on-imports.md

Example prompt for WebFetch: "Extract the main features, macros, and usage examples from this documentation"

Reference Files

Detailed documentation for specific topics:

Topic	File
SwiftUI patterns	references/swiftui-patterns.md
Testing patterns	references/testing-patterns.md
Swift 6 concurrency	references/concurrency.md
Architecture patterns	references/architecture.md
Best practices	references/best-practices.md
Swift Package Manager	references/spm.md
xcodebuild commands	references/xcodebuild.md
Simulator control	references/simctl.md
Code signing	references/code-signing.md
CI/CD setup	references/cicd.md
Troubleshooting	references/troubleshooting.md

Included Scripts

Script	Purpose
`scripts/new_package.sh`	Create new Swift package with config files
`scripts/run_tests.sh`	Run tests with common options
`scripts/format_and_lint.sh`	Format and lint Swift code
`scripts/simulator.sh`	Quick simulator management

Asset Templates

Asset	Purpose
`assets/Package.swift.template`	Swift package template
`assets/.swiftformat`	SwiftFormat configuration
`assets/.swiftlint.yml`	SwiftLint configuration
`assets/ExportOptions/`	Archive export plist templates

Quick Reference

Essential Commands

Task	Command
Build package	`swift build`
Build release	`swift build -c release`
Run tests	`swift test`
Update deps	`swift package update`
List simulators	`xcrun simctl list devices`
Boot simulator	`xcrun simctl boot "iPhone 15"`
Install app	`xcrun simctl install booted ./App.app`
Format code	`swiftformat .`
Lint code	`swiftlint`

Common Destinations

# iOS Simulator
-destination 'platform=iOS Simulator,name=iPhone 15'

# macOS
-destination 'platform=macOS'

# Generic iOS (for archives)
-destination 'generic/platform=iOS'

Source: ComeOnOliver/skillshub — distributed by TomeVault.

Fluxly profile Author and license come from source; runtime, permissions, and network are Fluxly detections or estimates

Fluxly category: Other
Author-declared agents: No explicit declaration found; this is not inferred or tested compatibility
Static check: 88 / 100 · heuristic scan, not runtime safety proof
Author / version / license: @tomevault-io · no license declared
Fluxly token estimate: Lean
Fluxly setup estimate: Plug-and-play
External API key: No requirement detected
Detected OS requirements: macOS
Runtime requirements: Unspecified
Detected file/system behavior: Read-only
Write / modify
Detected network behavior: External requests
Install commands: None (reference only)

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Heads up: 未限定 allowed-tools，默认拥有全部工具权限。

Output preview swift-development.preview

The current SKILL.md does not define a fixed output example.

SKILL.md SKILL.md

# Swift Development

## Prerequisites

- macOS with Xcode 15+ installed (Xcode 16+ for Swift 6)
- Xcode Command Line Tools: `xcode-select --install`
- Verify: `xcodebuild -version` and `swift --version`

## Quick Start

### New Swift Package

```bash
# Use the included script for full setup
./scripts/new_package.sh MyLibrary --type library --ios --macos

# Or manually
swift package init --type library --name MyLibrary
```

### Build and Test

```bash
# SPM packages
swift build
swift test

# Xcode projects
xcodebuild -workspace App.xcworkspace -scheme App \
    -destination 'platform=iOS Simulator,name=iPhone 15' build

# Use included script for common options
./scripts/run_tests.sh --parallel --coverage
```

### Format and Lint

```bash
# Use included script
./scripts/format_and_lint.sh Sources/

# Check mode (CI)
./scripts/format_and_lint.sh --check
```

### Simulator Management

```bash
# Use included script
./scripts/simulator.sh list
./scripts/simulator.sh boot "iPhone 15"
./scripts/simulator.sh screenshot
./scripts/simulator.sh dark
```

---

## Core Workflows

### Building iOS Apps

```bash
# Debug build for simulator
xcodebuild -workspace App.xcworkspace -scheme App \
    -destination 'platform=iOS Simulator,name=iPhone 15' \
    build

# Release archive
xcodebuild archive \
    -workspace App.xcworkspace -scheme App \
    -archivePath ./build/App.xcarchive \
    -configuration Release

# Export IPA (use templates from assets/ExportOptions/)
xcodebuild -exportArchive \
    -archivePath ./build/App.xcarchive \
    -exportPath ./build/export \
    -exportOptionsPlist assets/ExportOptions/app-store.plist
```

### Testing

```bash
# All tests
xcodebuild test -workspace App.xcworkspace -scheme App \
    -destination 'platform=iOS Simulator,name=iPhone 15'

…

Evidence boundary and execution chain

Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.

sections -> Prerequisites → Quick Start → New Swift Package → Build and Test → Format and Lint → Simulator Management
terms    -> Note · Swift Testing · Swift Evolution · Framework Details · Uncertainty · How to fetch · Example prompt for WebFetch
files/cmd -> xcode-select --install · xcodebuild -version · swift --version · WebFetch · @Test · #expect · #require · https://github.com/apple/swift-testing
body sha256 -> 10ede21e7aba