Skip to content
Back to search

pypict-claude-skill

MarketplaceWorks with Claude CodeGitHub

PICT Test Designer - Comprehensive test case design using Pairwise Independent Combinatorial Testing

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/omkamal--pypict-claude-skill/badge.svg)](/listings/omkamal--pypict-claude-skill)

HTML

<a href="/listings/omkamal--pypict-claude-skill"><img src="/api/listings/omkamal--pypict-claude-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

- Claude Code CLI or Claude Code Desktop - (Optional) Python 3.7+ with `pypict` for advanced usage

Installation Methods

Claude Code skills can be installed via the plugin marketplace or manually by placing them in the `.claude/skills/` directory.

Method 1: Install via Claude Code Plugin Marketplace (Easiest) 🌟

Install directly through Claude Code's plugin system:

# Add the marketplace
/plugin marketplace add omkamal/pypict-claude-skill

# Install the plugin
/plugin install pict-test-designer@pypict-claude-skill

This automatically installs the skill and keeps it updated. The skill will be available across all your projects.

Method 2: Install from GitHub (Manual)

**For Personal Use (All Projects):**

# Clone the repository to your personal skills directory
git clone https://github.com/omkamal/pypict-claude-skill.git ~/.claude/skills/pict-test-designer

# Restart Claude Code to load the skill
# The skill will now be available in all your projects

**For Project-Specific Use:**

# From your project directory
git clone https://github.com/omkamal/pypict-claude-skill.git .claude/skills/pict-test-designer

# Add to .gitignore if you don't want to commit it
echo ".claude/skills/" >> .gitignore

# Or commit it to share with your team
git add .claude/skills/pict-test-designer
git commit -m "Add PICT test designer skill"

Method 3: Install via Git Submodule (Team Sharing)

If you want to share this skill with your team via version control:

# From your project directory
git submodule add https://github.com/omkamal/pypict-claude-skill.git .claude/skills/pict-test-designer
git commit -m "Add PICT test designer skill as submodule"

# Team members clone with:
git clone --recurse-submodules <your-repo-url>

# Or if already cloned:
git submodule update --init --recursive

Method 4: Download Minimal Package from Releases

Download the pre-packaged minimal installation from [GitHub Releases](https://github.com/omkamal/pypict-claude-skill/releases):

# Download the latest minimal package from releases
wget https://github.com/omkamal/pypict-claude-skill/releases/latest/download/pict-test-designer-minimal.zip

# Extract and install for personal use
unzip pict-test-designer-minimal.zip
mv pict-test-designer-minimal ~/.claude/skills/pict-test-designer

# Or for project-specific use
unzip pict-test-designer-minimal.zip
mv pict-test-designer-minimal .claude/skills/pict-test-designer

**What's included:** SKILL.md, LICENSE, references/ (syntax and examples) **What's excluded:** Full examples, helper scripts, extended documentation **Size:** ~9 KB | **Latest Version:** [See Releases](https://github.com/omkamal/pypict-claude-skill/releases)

Method 5: Download Full Repository

1. **Download the repository** as a ZIP from GitHub 2. **Extract to the skills directory**:

# For personal use (all projects)
unzip pypict-claude-skill-main.zip
mv pypict-claude-skill-main ~/.claude/skills/pict-test-designer

# For project-specific use
unzip pypict-claude-skill-main.zip
mv pypict-claude-skill-main .claude/skills/pict-test-designer

Verify Installation

After installation, restart Claude Code. The skill will load automatically when relevant. You can verify by asking Claude:

Do you have access to the pict-test-designer skill?

Or simply start using it:

Design test cases for a login function with username, password, and remember me checkbox.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json Β· Manifest Β· 23 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "pypict-claude-skill",
  4. "version": "1.0.0",
  5. "description": "PICT Test Designer - Comprehensive test case design using Pairwise Independent Combinatorial Testing",
  6. "owner": {
  7. "name": "Omar Kamal Hosney",
  8. "email": "omar.wasat@gmail.com"
  9. },
  10. "plugins": [
  11. {
  12. "name": "pict-test-designer",
  13. "description": "Design comprehensive test cases using PICT (Pairwise Independent Combinatorial Testing). Analyzes inputs, generates PICT models with parameters, values, and constraints for valid scenarios using pairwise testing. Outputs the PICT model, markdown table of test cases, and expected results.",
  14. "version": "1.0.0",
  15. "author": {
  16. "name": "Omar Kamal Hosney",
  17. "email": "omar.wasat@gmail.com"
  18. },
  19. "source": "./",
  20. "category": "testing"
  21. }
  22. ]
  23. }
README.md Β· README Β· 373 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # PICT Test Designer - Claude Skill
  2. A Claude skill for designing comprehensive test cases using PICT (Pairwise Independent Combinatorial Testing). This skill enables systematic test case design with minimal test cases while maintaining high coverage through pairwise combinatorial testing.
  3. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  4. [![Claude](https://img.shields.io/badge/Claude-Skill-blue.svg)](https://claude.ai)
  5. ## 🎯 What is PICT?
  6. PICT (Pairwise Independent Combinatorial Testing) is a combinatorial testing tool developed by Microsoft. It generates test cases that efficiently cover all pairwise combinations of parameters while drastically reducing the total number of tests compared to exhaustive testing.
  7. **Example:** Testing a system with 8 parameters and 3-5 values each:
  8. - Exhaustive testing: **25,920 test cases**
  9. - PICT pairwise testing: **~30 test cases** (99.88% reduction!)
  10. ## πŸš€ Features
  11. - **Automated Test Case Generation**: Converts requirements into structured PICT models
  12. - **Constraint-Based Testing**: Applies business rules to eliminate invalid combinations
  13. - **Expected Output Generation**: Automatically determines expected results for each test case
  14. - **Comprehensive Coverage**: Ensures all pairwise parameter interactions are tested
  15. - **Multiple Domains**: Works for software functions, APIs, web forms, configurations, and more
  16. ## πŸ“‹ Table of Contents
  17. - [Installation](#installation)
  18. - [Prerequisites](#prerequisites)
  19. - [Installing in Claude Code CLI](#installing-in-claude-code-cli)
  20. - [Installing in Claude Code Desktop](#installing-in-claude-code-desktop)
  21. - [Quick Start](#quick-start)
  22. - [Example: ATM System Testing](#example-atm-system-testing)
  23. - [How It Works](#how-it-works)
  24. - [Use Cases](#use-cases)
  25. - [Credits](#credits)
  26. - [Contributing](#contributing)
  27. - [License](#license)
  28. ## πŸ”§ Installation
  29. ### Prerequisites
  30. - Claude Code CLI or Claude Code Desktop
  31. - (Optional) Python 3.7+ with `pypict` for advanced usage
  32. ### Installation Methods
  33. Claude Code skills can be installed via the plugin marketplace or manually by placing them in the `.claude/skills/` directory.
  34. ### Method 1: Install via Claude Code Plugin Marketplace (Easiest) 🌟
  35. Install directly through Claude Code's plugin system:
  36. ```bash
  37. # Add the marketplace
  38. /plugin marketplace add omkamal/pypict-claude-skill
  39. # Install the plugin
  40. /plugin install pict-test-designer@pypict-claude-skill
  41. ```
  42. This automatically installs the skill and keeps it updated. The skill will be available across all your projects.
  43. ### Method 2: Install from GitHub (Manual)
  44. **For Personal Use (All Projects):**
  45. ```bash
  46. # Clone the repository to your personal skills directory
  47. git clone https://github.com/omkamal/pypict-claude-skill.git ~/.claude/skills/pict-test-designer
  48. # Restart Claude Code to load the skill
  49. # The skill will now be available in all your projects
  50. ```
  51. **For Project-Specific Use:**
  52. ```bash
  53. # From your project directory
  54. git clone https://github.com/omkamal/pypict-claude-skill.git .claude/skills/pict-test-designer
  55. # Add to .gitignore if you don't want to commit it
  56. echo ".claude/skills/" >> .gitignore
  57. # Or commit it to share with your team
  58. git add .claude/skills/pict-test-designer
  59. git commit -m "Add PICT test designer skill"
  60. ```
  61. ### Method 3: Install via Git Submodule (Team Sharing)
  62. If you want to share this skill with your team via version control:
  63. ```bash
  64. # From your project directory
  65. git submodule add https://github.com/omkamal/pypict-claude-skill.git .claude/skills/pict-test-designer
  66. git commit -m "Add PICT test designer skill as submodule"
  67. # Team members clone with:
  68. git clone --recurse-submodules <your-repo-url>
  69. # Or if already cloned:
  70. git submodule update --init --recursive
  71. ```
  72. ### Method 4: Download Minimal Package from Releases
  73. Download the pre-packaged minimal installation from [GitHub Releases](https://github.com/omkamal/pypict-claude-skill/releases):
  74. ```bash
  75. # Download the latest minimal package from releases
  76. wget https://github.com/omkamal/pypict-claude-skill/releases/latest/download/pict-test-designer-minimal.zip
  77. # Extract and install for personal use
  78. unzip pict-test-designer-minimal.zip
  79. mv pict-test-designer-minimal ~/.claude/skills/pict-test-designer
  80. # Or for project-specific use
  81. unzip pict-test-designer-minimal.zip
  82. mv pict-test-designer-minimal .claude/skills/pict-test-designer
  83. ```
  84. **What's included:** SKILL.md, LICENSE, references/ (syntax and examples)
  85. **What's excluded:** Full examples, helper scripts, extended documentation
  86. **Size:** ~9 KB | **Latest Version:** [See Releases](https://github.com/omkamal/pypict-claude-skill/releases)
  87. ### Method 5: Download Full Repository
  88. 1. **Download the repository** as a ZIP from GitHub
  89. 2. **Extract to the skills directory**:
  90. ```bash
  91. # For personal use (all projects)
  92. unzip pypict-claude-skill-main.zip
  93. mv pypict-claude-skill-main ~/.claude/skills/pict-test-designer
  94. # For project-specific use
  95. unzip pypict-claude-skill-main.zip
  96. mv pypict-claude-skill-main .claude/skills/pict-test-designer
  97. ```
  98. ### Verify Installation
  99. After installation, restart Claude Code. The skill will load automatically when relevant. You can verify by asking Claude:
  100. ```
  101. Do you have access to the pict-test-designer skill?
  102. ```
  103. Or simply start using it:
  104. ```
  105. Design test cases for a login function with username, password, and remember me checkbox.
  106. ```
  107. ## πŸš€ Quick Start
  108. Once installed, you can use the skill in Claude by simply asking:
  109. ```
  110. Design test cases for a login function with username, password, and remember me checkbox.
  111. ```
  112. Claude will:
  113. 1. Analyze the requirements
  114. 2. Identify parameters and values
  115. 3. Generate a PICT model with constraints
  116. 4. Create test cases with expected outputs
  117. 5. Present results in a formatted table
  118. ## πŸ“Š Example: ATM System Testing
  119. This repository includes a complete real-world example of testing an ATM system. See the [examples](examples/) directory for:
  120. - **[ATM Specification](examples/atm-specification.md)**: Complete ATM system specification with 11 sections covering hardware, software, security, and functional requirements
  121. - **[ATM Test Plan](examples/atm-test-plan.md)**: Comprehensive test plan generated using PICT methodology with 31 test cases (reduced from 25,920 possible combinations)
  122. ### ATM Example Summary
  123. **System Parameters:**
  124. - Transaction Types (5): Withdrawal, Deposit, Balance Inquiry, Transfer, PIN Change
  125. - Card Types (3): EMV Chip, Magnetic Stripe, Invalid
  126. - PIN Status (4): Valid, Invalid attempts 1-3
  127. - Account Types (3): Checking, Savings, Both
  128. - Transaction Amounts (4): Within limits, at max, exceeds transaction, exceeds daily
  129. - Cash Availability (3): Sufficient, Insufficient, Empty
  130. - Network Status (3): Primary, Backup, Disconnected
  131. - Card Condition (3): Good, Damaged, Expired
  132. **Test Results:**
  133. - Total possible combinations: **25,920**
  134. - PICT test cases generated: **31**
  135. - **Reduction: 99.88%**
  136. - Coverage: All pairwise (2-way) interactions
  137. - Test execution time: Reduced from weeks to hours
  138. ### Running the ATM Example
  139. ```bash
  140. # In Claude Code
  141. Ask: "Use the pict-test-designer skill to analyze the ATM specification
  142. in examples/atm-specification.md and generate test cases"
  143. ```
  144. ## πŸ” How It Works
  145. ### 1. Requirements Analysis
  146. Claude analyzes your requirements to identify:
  147. - **Parameters**: Input variables, configuration options, environmental factors
  148. - **Values**: Possible values using equivalence partitioning
  149. - **Constraints**: Business rules and dependencies
  150. - **Expected Outcomes**: What should happen for different combinations
  151. ### 2. PICT Model Generation
  152. Creates a structured model:
  153. ```
  154. # Parameters
  155. Browser: Chrome, Firefox, Safari
  156. OS: Windows, MacOS, Linux
  157. Memory: 4GB, 8GB, 16GB
  158. # Constraints
  159. IF [OS] = "MacOS" THEN [Browser] <> "IE";
  160. IF [Memory] = "4GB" THEN [OS] <> "MacOS";
  161. ```
  162. ### 3. Test Case Generation
  163. Generates minimal test cases covering all pairwise combinations:
  164. | Test # | Browser | OS | Memory | Expected Output |
  165. |--------|---------|----|---------|-----------------------------|
  166. | 1 | Chrome | Windows | 4GB | Success |
  167. | 2 | Firefox | MacOS | 8GB | Success |
  168. | 3 | Safari | Linux | 16GB | Success |
  169. | ... | ... | ... | ... | ... |
  170. ### 4. Expected Output Determination
  171. For each test case, Claude determines the expected outcome based on:
  172. - Business requirements
  173. - Code logic
  174. - Valid/invalid combinations
  175. ## 🎯 Use Cases
  176. ### Software Testing
  177. - Function testing with multiple parameters
  178. - API endpoint testing
  179. - Database query testing
  180. - Algorithm validation
  181. ### Configuration Testing
  182. - System configuration combinations
  183. - Feature flag testing
  184. - Environment setup validation
  185. - Browser compatibility testing
  186. ### Web Application Testing
  187. - Form validation
  188. - User authentication flows
  189. - E-commerce checkout processes
  190. - Shopping cart functionality
  191. ### Mobile Testing
  192. - Device and OS combinations
  193. - Screen size and orientation
  194. - Network conditions
  195. - App permissions
  196. ### Hardware Testing
  197. - Device compatibility
  198. - Interface testing
  199. - Protocol validation
  200. - Performance under different conditions
  201. ## πŸ“š Documentation
  202. - **[SKILL.md](SKILL.md)**: Complete skill documentation with workflow and best practices
  203. - **[PICT Syntax Reference](references/pict_syntax.md)**: Complete syntax guide (to be created)
  204. - **[Examples](references/examples.md)**: Real-world examples across domains (to be created)
  205. - **[Helper Scripts](scripts/pict_helper.py)**: Python utilities for PICT (to be created)
  206. ## πŸ’‘ Tips for Best Results
  207. ### Good Parameter Names
  208. βœ… Use descriptive names: `AuthMethod`, `UserRole`, `PaymentType`
  209. βœ… Apply equivalence partitioning: `FileSize: Small, Medium, Large`
  210. βœ… Include boundary values: `Age: 0, 17, 18, 65, 66`
  211. βœ… Add negative values: `Amount: ~-1, 0, 100, ~999999`
  212. ### Writing Constraints
  213. βœ… Document rationale: `# Safari only available on MacOS`
  214. βœ… Start simple, add incrementally
  215. βœ… Test constraints work as expected
  216. ### Expected Outputs
  217. βœ… Be specific: "Login succeeds, user redirected to dashboard"
  218. ❌ Not vague: "Works" or "Success"
  219. ## πŸ™ Credits
  220. This skill is built upon the excellent work of:
  221. - **[Microsoft PICT](https://github.com/microsoft/pict)**: The original Pairwise Independent Combinatorial Testing tool developed by Microsoft Research
  222. - **[pypict](https://github.com/kmaehashi/pypict)**: Python binding for PICT by Kenichi Maehashi
  223. - **Community Contributors**: All contributors who have helped improve PICT tools
  224. ### About PICT
  225. PICT was developed by Jacek Czerwonka at Microsoft Research. It's a powerful combinatorial testing tool that has been used extensively within Microsoft for testing complex systems with multiple interacting parameters.
  226. **References:**
  227. - [PICT: Pairwise Independent Combinatorial Testing](https://github.com/microsoft/pict)
  228. - [Pairwise Testing Methodology](https://www.pairwisetesting.com/)
  229. - [Combinatorial Test Design](https://csrc.nist.gov/projects/automated-combinatorial-testing-for-software)
  230. ## 🀝 Contributing
  231. Contributions are welcome! Here's how you can help:
  232. 1. **Fork the repository**
  233. 2. **Create a feature branch**: `git checkout -b feature/amazing-feature`
  234. 3. **Make your changes**
  235. 4. **Add examples or documentation**
  236. 5. **Commit your changes**: `git commit -m 'Add amazing feature'`
  237. 6. **Push to the branch**: `git push origin feature/amazing-feature`
  238. 7. **Open a Pull Request**
  239. ### Areas for Contribution
  240. - Additional real-world examples
  241. - Enhanced constraint patterns
  242. - Support for more testing domains
  243. - Improved documentation
  244. - Bug fixes and improvements
  245. ## πŸ“ License
  246. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
  247. The underlying PICT tool by Microsoft is also licensed under the MIT License.
  248. ## πŸ”— Links
  249. - **Claude AI**: https://claude.ai
  250. - **Claude Documentation**: https://docs.claude.com
  251. - **Microsoft PICT**: https://github.com/microsoft/pict
  252. - **pypict**: https://github.com/kmaehashi/pypict
  253. - **Online PICT Tools**:
  254. - https://pairwise.yuuniworks.com/
  255. - https://pairwise.teremokgames.com/
  256. ## πŸ“§ Support
  257. If you encounter issues or have questions:
  258. 1. Check the [examples](examples/) directory for reference
  259. 2. Review the [SKILL.md](SKILL.md) documentation
  260. 3. Open an issue on GitHub
  261. 4. Join discussions in the Issues section
  262. ## 🌟 Star This Repository
  263. If you find this skill useful, please star the repository to help others discover it!
  264. ---
  265. **Made with ❀️ for the Claude and testing community**
  266. **Powered by Microsoft PICT and pypict**

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.