Process-based discrete-event simulation framework in Python. Use this skill when building simulations of systems with processes, queues, resources, and time-based events such as manufacturing systems, service operations, network traffic, logistics, or any system where entities interact with shared resources over time.
83
70%
Does it follow best practices?
Impact
92%
1.73xAverage score across 6 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/simpy/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong description with excellent trigger terms, clear completeness with an explicit 'Use this skill when' clause, and a highly distinctive niche. Its main weakness is that it describes the framework conceptually rather than listing specific concrete actions the skill enables (e.g., 'model resource contention', 'track queue statistics', 'visualize simulation results').
Suggestions
Add specific concrete actions the skill performs, e.g., 'Model resource contention, track queue statistics, define entity arrival patterns, and run simulation experiments' to improve specificity.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (discrete-event simulation) and mentions key concepts (processes, queues, resources, time-based events), but doesn't list specific concrete actions like 'create simulation models', 'define resource pools', 'collect statistics', or 'run replications'. It describes what the framework is rather than what concrete actions it performs. | 2 / 3 |
Completeness | Clearly answers both 'what' (process-based discrete-event simulation framework in Python) and 'when' with an explicit 'Use this skill when...' clause that lists specific trigger scenarios like manufacturing systems, service operations, network traffic, and logistics. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'simulation', 'queues', 'resources', 'manufacturing systems', 'service operations', 'network traffic', 'logistics', 'discrete-event', 'processes', 'shared resources'. These are terms users would naturally use when requesting simulation help. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive niche — discrete-event simulation is a very specific domain unlikely to overlap with other skills. The combination of simulation-specific terminology (queues, resources, time-based events, discrete-event) and domain examples (manufacturing, logistics) creates a clear, unique identity. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill provides excellent executable code examples and covers SimPy comprehensively, but is far too verbose for a skill file—it explains many concepts Claude already knows (what DES is, what generators are, use case categories) and includes content that should either be in referenced files or omitted entirely. The workflow section lacks explicit validation checkpoints, and all referenced bundle files are missing, undermining the progressive disclosure structure.
Suggestions
Cut the 'When to Use This Skill', 'Example Use Cases', 'Common Pitfalls', and 'Best Practices' sections significantly—Claude knows what DES is and basic Python generator pitfalls. Reduce to only non-obvious, SimPy-specific guidance.
Move the detailed patterns (customer-server, producer-consumer, parallel tasks) into a referenced patterns file to keep SKILL.md as a concise overview with one quick-start example.
Add explicit validation steps to the workflow, such as 'Run a short simulation (until=10) and verify output before scaling up' or 'Assert expected queue lengths against analytical M/M/c results for simple test cases'.
Either provide the referenced bundle files (references/resources.md, references/monitoring.md, scripts/*.py) or remove the references to avoid broken links.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~300+ lines. It explains concepts Claude already knows (what discrete-event simulation is, what generators are, what PDFs are equivalent concepts like 'entities are what moves through the system'). The 'When to Use This Skill' section, 'Common Pitfalls' list of basic Python/SimPy facts, 'Example Use Cases' bullet list, and 'Best Practices' are largely things Claude already knows. The overview repeats information found later. Much could be cut by 50%+ without losing actionable content. | 1 / 3 |
Actionability | The skill provides multiple fully executable, copy-paste ready code examples covering the basic simulation structure, resource usage, customer-server queues, producer-consumer, parallel tasks, and more. Code is complete with imports and runnable as-is. | 3 / 3 |
Workflow Clarity | The 4-step workflow (Define System → Implement → Monitor → Analyze) provides a reasonable sequence, but validation checkpoints are weak. Step 5 in best practices mentions 'compare simple cases with analytical solutions' but there's no explicit validate-fix-retry loop. For simulations that could produce incorrect results silently, the lack of concrete verification steps is a gap. | 2 / 3 |
Progressive Disclosure | The skill references multiple external files (references/resources.md, references/monitoring.md, scripts/basic_simulation_template.py, etc.) with clear signaling, which is good structure. However, no bundle files are actually provided, meaning all those references are broken. Additionally, the main file contains substantial inline content that could be in reference files (e.g., the full resource types table, all the pattern examples), making the SKILL.md itself too long while simultaneously pointing to nonexistent files. | 2 / 3 |
Total | 8 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
Total | 10 / 11 Passed | |
cbcae7b
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.