CtrlK
BlogDocsLog inGet started
Tessl Logo

simpy

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

1.73x
Quality

70%

Does it follow best practices?

Impact

92%

1.73x

Average score across 6 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./scientific-skills/simpy/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

10

/

11

Passed

Repository
K-Dense-AI/claude-scientific-skills
Reviewed

Table of Contents

Is this your skill?

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.