swift-security
Use when working with iOS/macOS Keychain Services (SecItem queries, kSecClass, OSStatus errors), biometric authentication (LAContext, Face ID, Touch ID), CryptoKit (AES-GCM, ChaChaPoly, ECDSA, ECDH, HPKE, ML-KEM), Secure Enclave, secure credential storage (OAuth tokens, API keys), certificate pinnin…
Install / Use
npx skills add dpearson2699/swift-ios-skills --skill swift-securityInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
SecuritySupported Platforms
Our assessment of swift-security
swift-security scores 85/100 on our quality scale, 820th of 1,111 Security skills we index.
Its SKILL.md is 13 KB long, well organised into 11 sections with 1 code example: a thorough specification that gives an agent plenty to work with.
With 1,143 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-11-05 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 86/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
swift-security compared with similar skills
All 4 of these similar skills score higher than swift-security; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| swift-security (this skill)by dpearson2699 | 85 | 1.1k | 4mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 9d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
| crawl4aiby unclecode | 100 | 87.4k | 3d ago | MCP Server |
Frequently asked questions
- How do I install swift-security?
- Run
npx skills add dpearson2699/swift-ios-skills --skill swift-security. The install tabs above show the steps for each supported agent. - Which AI agents does swift-security work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is swift-security safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 86/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is swift-security still maintained?
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubname: swift-security description: Use when working with iOS/macOS Keychain Services (SecItem queries, kSecClass, OSStatus errors), biometric authentication (LAContext, Face ID, Touch ID), CryptoKit (AES-GCM, ChaChaPoly, ECDSA, ECDH, HPKE, ML-KEM), Secure Enclave, secure credential storage (OAuth tokens, API keys), certificate pinning (SecTrust, SPKI), keychain sharing across apps/extensions, migrating secrets from UserDefaults or plists, or OWASP MASVS/MASTG mobile compliance on Apple platforms. license: MIT
Swift Security
Use this skill for client-side Apple platform security work: Keychain Services, access control, biometric-gated secrets, CryptoKit, Secure Enclave keys, credential storage, certificate trust, keychain sharing, legacy secret migration, security testing, and OWASP mobile compliance mapping.
Default to iOS 17+ and Swift concurrency examples when the deployment target is unknown. Keep iOS 13+ compatibility notes when the user asks for older targets. Treat iOS 26 CryptoKit post-quantum APIs as availability-gated.
Contents
- Workflow
- Reference Loading
- Security Invariants
- Sibling Boundaries
- Review Checklist
- Common Mistakes
- Output Rules
- References
Workflow
Classify the request before loading references.
- Review existing code: run the Review Checklist, then load common-anti-patterns.md plus the domain reference for each failing area. Report severity, evidence, and the corrected pattern.
- Improve or migrate code: identify the migration type, load the migration and target-domain references, preserve existing data, verify the new item, then remove legacy storage only after success.
- Implement new security code: load the minimum domain references, use the provided correct patterns, include OSStatus handling and tests, then run the relevant checklist.
Do not load every reference file by default. This skill is intentionally split for progressive disclosure; load only the files needed by the user's task.
Minimum Safe Keychain Write
Use separate add, identity, and update dictionaries; handle every OSStatus:
func saveSecret(_ data: Data, account: String) throws {
let identity: [CFString: Any] = [
kSecClass: kSecClassGenericPassword,
kSecAttrService: "com.example.app",
kSecAttrAccount: account,
]
var add = identity
add[kSecValueData] = data
add[kSecAttrAccessible] = kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly
switch SecItemAdd(add as CFDictionary, nil) {
case errSecSuccess:
return
case errSecDuplicateItem:
let status = SecItemUpdate(
identity as CFDictionary,
[kSecValueData: data] as CFDictionary
)
guard status == errSecSuccess else { throw KeychainError(status: status) }
case let status:
throw KeychainError(status: status)
}
}
Load keychain-fundamentals.md for read, delete, access-control, locked-device, and test patterns.
Reference Loading
| If the task involves | Load |
| --- | --- |
| General keychain CRUD or OSStatus handling | keychain-fundamentals.md |
| Choosing kSecClass or item identity | keychain-item-classes.md |
| Accessibility classes or SecAccessControl | keychain-access-control.md |
| Face ID, Touch ID, or biometric-gated secrets | biometric-authentication.md |
| Secure Enclave keys | secure-enclave.md |
| Hashing, HMAC, AES-GCM, ChaChaPoly, HKDF, PBKDF2 | cryptokit-symmetric.md |
| Signing, ECDH, HPKE, ML-KEM, ML-DSA | cryptokit-public-key.md |
| OAuth tokens, API keys, logout, refresh rotation | credential-storage-patterns.md |
| App/extension keychain sharing | keychain-sharing.md |
| Certificate trust, SPKI pinning, mTLS | certificate-trust.md |
| UserDefaults/plist/NSCoding migration | migration-legacy-stores.md |
| Unit, integration, simulator, device, or CI tests | testing-security-code.md |
| OWASP MASVS/MASTG or enterprise audit mapping | compliance-owasp-mapping.md |
| Full security review | common-anti-patterns.md, then each touched domain reference |
Security Invariants
Use directive language only for these security invariants and the matching anti-patterns in common-anti-patterns.md. For architecture choices outside this list, use advisory language.
- Never store tokens, passwords, API keys, signing keys, or refresh tokens in
UserDefaults,Info.plist,.xcconfig, source code, logs, files, orNSCodingarchives. Use Keychain or fetch secrets at runtime. - Never ignore
OSStatus. EverySecItemAdd,SecItemCopyMatching,SecItemUpdate, andSecItemDeletepath must handle success and expected failures such aserrSecDuplicateItem,errSecItemNotFound, anderrSecInteractionNotAllowed. - Never use
LAContext.evaluatePolicy()as the only gate for a secret. Bind protected secrets to keychain items withSecAccessControl, then let keychain access trigger LocalAuthentication. - Always set
kSecAttrAccessibleorkSecAttrAccessControlexplicitly when adding keychain items. - Always use add-or-update for persistent keychain writes. Do not delete-then-add as a normal update path.
- Keep
SecItem*work off the main actor. Use an actor or serial queue for keychain access. - On macOS AppKit targets, target the data protection keychain with
kSecUseDataProtectionKeychain: trueunless deliberately working with legacy file-based keychain items. - Never reuse an AES-GCM nonce with the same key.
- Never use raw ECDH
SharedSecretbytes as a symmetric key. Derive with HKDF or X9.63 derivation. - Never use
Insecure.MD5orInsecure.SHA1for security purposes.
Sibling Boundaries
This skill owns client-side storage, cryptographic primitives, hardware-backed keys, and trust evaluation. Route adjacent work deliberately:
- Use
authenticationfor Sign in with Apple, passkeys, OAuth UI flows,ASAuthorizationController, credential state, and account sign-in UX. - Use
cryptokitfor primitive CryptoKit API syntax and examples when storage, key lifecycle, protocol/trust design, Secure Enclave policy, certificate trust, misuse review, or compliance is not part of the task. - Keep application-level E2E encryption security reviews here when the work involves key ownership, derivation, storage, rotation/recovery, Secure Enclave, HPKE/PQC migration, protocol trust boundaries, or misuse analysis.
- Use
device-integrityfor DeviceCheck and App Attest attestation/assertion flows. - Use
ios-networkingfor URLSession, request pipelines, ATS configuration, retries, caching, reachability, and transport architecture. - Use
app-store-reviewfor privacy manifests, ATT, App Review guideline compliance, and submission readiness.
This skill may mention those areas only to identify a security handoff.
Review Checklist
Use this checklist for code reviews and migration plans. Mark each item pass, fail, or not applicable; for each failure, cite the reference file and severity.
- Secrets are not stored in
UserDefaults, plists, source, logs, files, or archives. - Every
SecItem*call checksOSStatusand handles common recoverable errors. - Biometric access to secrets is keychain-bound with
SecAccessControl, not a standaloneBoolfromLAContext.evaluatePolicy(). - Keychain add dictionaries set an explicit accessibility policy.
- Keychain writes use add-or-update rather than delete-then-add.
- Keychain work is isolated from UI/main-actor code.
- The selected
kSecClassmatches the item type and primary-key attributes. - CryptoKit code avoids nonce reuse, raw shared-secret use, weak hashes, and hardcoded keys.
- Custom encryption designs identify key ownership, derivation, storage, rotation/recovery, availability gates, and protocol/trust boundaries.
- Secure Enclave code checks availability, handles simulator/device differences,
persists only
dataRepresentation, and designs for device-bound keys. - App/extension sharing uses full Team ID access groups and matching entitlements on every target.
- Certificate trust uses current
SecTrustAPIs, validates hostname/policy, and uses SPKI or CA pinning when pinning is required. - macOS keychain code intentionally chooses data protection or file-based keychain behavior.
- Tests cover success, duplicate, missing item, locked-device, simulator/device, and migration paths where applicable.
- OWASP MASVS/MASTG mappings are included when compliance is requested.
Common Mistakes
- Generating partial keychain examples without duplicate handling or
errSecItemNotFoundhandling. - Adding biometric UI but leaving the secret readable without keychain access control.
- Choosing
kSecAttrAccessibleWhenUnlockedimplicitly by omitting the attribute. - Using
kSecAttrAccessibleAlwaysorkSecAttrAccessibleAlwaysThisDeviceOnly, both deprecated. - Mixing
kSecAttrAccessibleandkSecAttrAccessControlon the same add query. - Treating Secure Enclave keys as importable, exportable, syncable, or suitable for symmetric encryption.
- Claiming SHA-3, ML-KEM, ML-DSA, or X-Wing CryptoKit APIs are available before iOS 26.
- Treating HPKE as available before iOS 17.
- Implementing certificate pinning by hashing only raw key bytes instead of the correct SPKI representation.
- Expanding this skill into account-login, networking, App Attest, or App Store review guidance instead of handing off to sibling skills.
Output Rules
- For security findings, state severity: CRITICAL for exploitable secret or cryptography failures, HIGH for silent security boundary/data-loss issues, and MEDIUM for brittle or incomplete hardening.
- Include wrong and corrected code examples for implementation reviews when a concrete anti-pattern is present.
- Include minimum iOS/macOS availability when recommending versioned APIs.
- Cite the reference file that supports each substantive security pattern.
- For keychain code, include
OSStatushandling and explicit accessibility in examples. - For implementation or migration answers, end with
## Reference Filesand list the loaded references with a one-line purpose. - Do not invent WWDC session numbers or source citations. If a claim is not present in the loaded references or official Apple documentation, say it needs verification.
References
- keychain-fundamentals.md - SecItem CRUD, OSStatus handling, add-or-update, macOS data protection keychain.
- keychain-item-classes.md -
kSecClassselection, primary keys, certificates, identities. - keychain-access-control.md - Accessibility constants,
SecAccessControl, background access, data protection. - biometric-authentication.md - Keychain-bound biometrics,
LAContext, enrollment-change handling. - secure-enclave.md - Secure Enclave constraints, persistence, biometric keys, iOS 26 PQ APIs.
- cryptokit-symmetric.md - SHA, HMAC, AES-GCM, ChaChaPoly, HKDF, PBKDF2.
- [cr
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.4kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
