{
  "markdown": "<p align=\"center\">\n    <img src=\"assets/logo.svg\" alt=\"Swift Testing Pro - Agent Skill for Claude Code, Codex, and Gemini\" height=\"100\" />\n</p>\n\n<h1 align=\"center\">Swift Testing Agent Skill for AI Coding Assistants</h1>\n\n<p align=\"center\">\n    <img src=\"https://img.shields.io/badge/swift-6.2+-8e44ad.svg\" alt=\"Designed for Swift 6.2 and later.\" />\n    <a href=\"https://twitter.com/twostraws\">\n        <img src=\"https://img.shields.io/badge/Contact-@twostraws-95a5a6.svg?style=flat\" alt=\"Twitter: @twostraws\" />\n    </a>\n</p>\n\nAn agent skill that helps AI coding assistants like Claude Code, Codex, Cursor, and Gemini write better tests using Swift Testing. Covers `@Test`, `#expect`, `#require`, parameterized testing, traits, exit tests, confirmations, and more, targeting the mistakes LLMs actually make.\n\nAlso available:\n\n- [SwiftUI Pro](https://github.com/twostraws/SwiftUI-Agent-Skill)\n- [SwiftData Pro](https://github.com/twostraws/SwiftData-Agent-Skill)\n- [Swift Concurrency Pro](https://github.com/twostraws/Swift-Concurrency-Agent-Skill)\n\nFind more agent skills for Swift and Apple platform development at [Swift Agent Skills](https://github.com/twostraws/Swift-Agent-Skills).\n\n\n## Installing Swift Testing Pro\n\n### Claude Code\n\nAdd the Swift Testing Agent Skill marketplace, then install the plugin:\n\n```\n/plugin marketplace add twostraws/Swift-Testing-Agent-Skill\n/plugin install swift-testing-pro@swift-testing-agent-skill\n```\n\n### Codex, Gemini, Cursor, and others\n\n```bash\nnpx skills add https://github.com/twostraws/swift-testing-agent-skill --skill swift-testing-pro\n```\n\nIf you get the error `npx: command not found`, it means you don’t currently have Node installed. You need to run this command to install Node through Homebrew:\n\n```bash\nbrew install node\n```\n\nAnd if *that* fails it usually means you need to [install Homebrew](https://brew.sh) first.\n\nWhen using `npx`, you can select exactly which agents you want to use during the installation. You can also select whether the skill should be installed just for one project, or whether it should be made available for all your projects.\n\nAlternatively, you can clone this whole repository and install it however you want.\n\nIf you're using Xcode, watch the YouTube video on [How to Install and Use Agent Skills in Xcode](https://www.youtube.com/watch?v=nKVZBKoB6P4) for a walkthrough.\n\n\n## Using Swift Testing Pro\n\nThe skill is called Swift Testing Pro, and can be triggered in various ways. For example, in Claude Code you would use this:\n\n> /swift-testing-pro\n\nAnd in Codex you would use this:\n\n> $swift-testing-pro\n\nIn both cases you can provide specific instructions if you want only a partial review. For example, `/swift-testing-pro Make sure my tests are fully parameterized` on Claude, or `$swift-testing-pro Add exit tests to my test suites` in Codex.\n\nYou can also trigger the skill using natural language:\n\n> Use the Swift Testing Pro skill to look for ways to improve the tests in this project.\n\n\n## Why Use an Agent Skill for Swift Testing?\n\nI wrote a [book on Swift Testing](https://www.hackingwithswift.com/store/testing-swift), and update it regularly as new features are added. I’ve also written a comprehensive set of articles introducing what’s new in Swift (see [here](https://www.hackingwithswift.com/articles/277/whats-new-in-swift-6-2), [here](https://www.hackingwithswift.com/articles/276/whats-new-in-swift-6-1), and [here](https://www.hackingwithswift.com/articles/269/whats-new-in-swift-6) for examples), and so I’ve made it my business to understand the ins and outs of Swift Testing.\n\nThis skill is the result of all that work. The rules contained here directly target common Swift Testing mistakes made by LLMs, covering new features they aren’t trained on, older features they frequently make mistakes with, and patterns that help make tests stay smaller and run faster.\n\nWhat this is *not* is just a dumping ground for all Swift Testing advice ever. Agents already have a solid grounding of the fundamentals of Swift Testing, so skills that do little more than reteach them what they already know are just burning tokens.\n\n*This skill focuses on what actually has an impact.*\n\n\n## Contributing\n\nI welcome all contributions, whether that's adding new checks, improving existing checks, or editing this README – everyone is welcome!\n\n- Keep your Markdown concise. There is a token cost to using skills, particularly with SKILL.md, so please respect the token budgets of users.\n- Do not repeat things that LLMs already know, because it burns tokens for no benefit. Focus on edge cases, surprises, soft deprecations, and similar.\n- All work must be licensed under the MIT license so it can benefit the most people.\n\nPlease ensure you abide by the [Code of Conduct](CODE_OF_CONDUCT.md).\n\n\n## License\n\nSwift Testing Pro was originally created by [Paul Hudson](https://twitter.com/twostraws), who writes [free Swift tutorials over at Hacking with Swift](https://www.hackingwithswift.com). It’s available under the [MIT License](LICENSE), which permits commercial use, modification, distribution, and private use.\n\n\n<p align=\"center\">\n    <a href=\"https://www.hackingwithswift.com/plus\">\n    <img src=\"https://www.hackingwithswift.com/img/hws-plus-banner@2x.jpg\" alt=\"Hacking with Swift+ logo\" style=\"max-width: 100%;\" /></a>\n</p>\n\n<p align=\"center\">&nbsp;</p>\n\n<p align=\"center\">\n    <a href=\"https://www.hackingwithswift.com\"><img src=\"https://www.hackingwithswift.com/img/hws-button@2x.png\" alt=\"Hacking with Swift logo\" width=\"66\" height=\"75\" /></a><br />\n    A Hacking with Swift Project\n</p>\n",
  "bytes": 5595,
  "sha": "08313493bfcda5f6a0db2f9eb488a08fc4c4a4a0f46fc10accdd425f23932ab0",
  "repo_slug": "twostraws/swift-testing-agent-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_twostraws_swift_testing_agent_skill_swif_e457a2b4/readme"
}