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.

60

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./backend/cli/skills/coding/simpy/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Well-structured, highly actionable content with excellent progressive disclosure — executable examples throughout, a clear workflow guide, and a clean one-level-deep reference bundle that all exists as described. The main weakness is redundancy: the overview, use-case lists, and resource quick-reference duplicate material that could be trimmed for token efficiency.

Suggestions

Merge the 'Example Use Cases' section into 'When to Use This Skill' (or delete it) — the two sections list nearly identical domains.

Drop the 'Quick Reference' code block in the Resources section, since the resource-type table plus the linked references/resources.md already cover instantiation syntax.

Add an explicit validation checkpoint inside the Workflow Guide (e.g. 'Step 5: verify against an analytical solution such as M/M/1 queueing results') rather than leaving it only in Best Practices.

DimensionReasoningScore

Conciseness

Mostly efficient with concrete, non-padded code examples, but there is avoidable duplication: the Overview restates the frontmatter description, 'When to Use This Skill' (7 numbered domains) and 'Example Use Cases' (6 domains) cover the same ground, and the resource section pairs a summary table with a redundant 'Quick Reference' snippet. It does not sink to level 2 because no section is generic filler — everything is SimPy-specific, just not fully tightened.

3 / 5

Actionability

The Quick Start, resource patterns, and all three simulation patterns are complete, copy-paste-ready code, and the Scripts section's documented imports and calls (`from scripts.resource_monitor import ResourceMonitor`, `monitor.report()`, `monitor.export_csv(...)`) match the actual bundle files. Minor gaps keep it below 5: Step 3/4 fragments reference `stats`/`resource` without showing their setup, and Step 2 uses generic placeholders (`calculate_service_time`, `collect_statistics`).

4 / 5

Workflow Clarity

The Workflow Guide gives a clear 4-step sequence (Define the System → Implement Process Functions → Set Up Monitoring → Run and Analyze) with concrete guidance at each step. Validation exists only as a Best Practice ('Compare simple cases with analytical solutions') rather than as an explicit checkpoint inside the workflow, which is a minor gap; since simulation is non-destructive, the destructive-operation cap does not apply.

4 / 5

Progressive Disclosure

The body is a genuine overview pointing to five one-level-deep reference files, each clearly signaled inline ('See `references/resources.md` for comprehensive details') and consolidated in a 'Reference Documentation' section; the two scripts are documented with usage snippets, and every referenced path exists on disk. Content is appropriately split — bulk detail (375-475 lines per topic) lives in the references, not the SKILL.md.

5 / 5

Total

16

/

20

Passed

Description

70%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A solid description with an explicit 'Use this skill when...' clause, concrete domain keywords, and clear niche positioning. Its main weakness is that the 'what' half is a one-line framework categorization rather than a list of concrete capabilities, which keeps specificity and completeness below the top anchors.

Suggestions

Replace the opening category statement with 2-3 concrete actions, e.g. 'Model processes, shared resources, and queues for discrete-event simulations in Python with SimPy', to lift specificity and completeness.

Include the library name 'SimPy' and a few more natural trigger phrases such as 'capacity planning', 'wait times', or 'throughput analysis' in the description text.

Tighten the tail clause 'or any system where entities interact with shared resources over time' to specific trigger domains to reduce overlap risk with other modeling skills.

DimensionReasoningScore

Specificity

The description names the domain precisely ('Process-based discrete-event simulation framework in Python') and one composite action ('building simulations of systems with processes, queues, resources, and time-based events'), but it does not enumerate several distinct concrete actions the way the level-4/5 anchors require ('extracts text, fills forms, converts pages'). It sits above level 2 because the domain is named with concrete modeling concepts (queues, resources, time-based events), not generic language.

3 / 5

Completeness

Both 'what' and 'when' are present, and the 'when' is explicit with concrete trigger examples ('Use this skill when building simulations of ... manufacturing systems, service operations, network traffic, logistics ...'). It falls just short of level 5 because the 'what' is a single category statement about the framework rather than an explicit list of what it does (process modeling, resource management, real-time simulation, monitoring) — the trigger clause carries most of the concrete content.

4 / 5

Trigger Term Quality

Good natural-keyword coverage: 'simulations', 'queues', 'resources', 'manufacturing systems', 'service operations', 'network traffic', 'logistics' — terms users would plausibly say. It misses a few common variations users might use ('discrete event simulation' phrasing, 'SimPy' itself absent from the description text, 'capacity planning', 'throughput', 'wait times'), so it falls short of the level-5 'comprehensive including synonyms' anchor.

4 / 5

Distinctiveness Conflict Risk

Discrete-event simulation in Python is a clear niche with distinct triggers (manufacturing, queues, network traffic), mostly distinguishable from adjacent skills. Minor overlap risk remains from the broadening clause 'or any system where entities interact with shared resources over time' and the generic word 'simulations', which could collide with other simulation or modeling skills, so it does not reach level 5's 'minimal conflict risk'.

4 / 5

Total

15

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository
synthetic-sciences/openscience
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.