Sim Code Explainer

Turn any Python simulation or engineering program into a colourful, zero-to-hero PDF guide that explains every block and line, the theory and system model behind it, every variable and what changing it does, and the actual results of running it (plus a Google Colab notebook). Use this whenever the user uploads or points to Python code and wants it explained, documented, taught, turned into a report/tutorial/lecture notes, or "explained from zero for someone who doesn't know Python" - for any domain (communications/OFDM/5G, control/PID, power systems, signal processing, queueing, Monte-Carlo, p

84 stars 19 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add mkaremm80/My-Skills-on-Claude --skill sim-code-explainer
Manual install
git clone --depth 1 https://github.com/mkaremm80/My-Skills-on-Claude.git /tmp/My-Skills-on-Claude
mkdir -p ~/.claude/skills
cp -r /tmp/My-Skills-on-Claude/skills/sim-code-explainer ~/.claude/skills/sim-code-explainer

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Simulation Code Explainer

Produce a guide that lets a reader with **zero Python knowledge** understand a program completely: what
problem it solves, the theory, how every group of lines works, why it is written that way, what each
variable does to the results, and what the actual results mean.

Examples (look at them before writing your first guide):
- `examples/pid_motor/` - a complete worked case: original code, block-marked code, the full
  `make_guide.py` and the resulting 31-page PDF. **Use its `make_guide.py` as the model for yours.**
- `examples/mm1_queue/` - a shorter guide (24 pages) for an event-driven simulation.
- `examples/ofdm_reference_guide.pdf` - a 65-page guide for a 5G MIMO-OFDM simulator: the depth to aim
  for when the code is large and the domain is rich.

Deliverables: `<Name>_Guide.pdf`, `<name>.ipynb` (Colab), the block-marked `.py`, and the figures.

## Workflow

### 0. Agree on scope (one short message, then proceed)
Confirm in one message, with sensible defaults so the user can just say "go":
- **audience** (default: zero Python, basic engineering maths),
- **language** of the PDF (default English; the PDF engine is Latin/Greek only, so warn that Arabic or
  other right-to-left output is not supported),
- **scope**: what the report covers and what it deliberately leaves out. Users care about this - they
  will present the report, so the scope must be stated explicitly in the PDF (a scope page is built in).
Read the full skill on GitHub

Details

Skill name
sim-code-explainer
Path
skills/sim-code-explainer/SKILL.md
License
MIT
Repo updated
17 November 2026

FAQ

What does the Sim Code Explainer skill do?

Turn any Python simulation or engineering program into a colourful, zero-to-hero PDF guide that explains every block and line, the theory and system model behind it, every variable and what changing it does, and the actual results of running it (plus a Google Colab notebook). Use this whenever the user uploads or points to Python code and wants it explained, documented, taught, turned into a report/tutorial/lecture notes, or "explained from zero for someone who doesn't know Python" - for any domain (communications/OFDM/5G, control/PID, power systems, signal processing, queueing, Monte-Carlo, p

How do I install the Sim Code Explainer skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add mkaremm80/My-Skills-on-Claude --skill sim-code-explainer. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Sim Code Explainer popular?

It lives in mkaremm80/My-Skills-on-Claude, which has 84 GitHub stars and 19 forks.

Related skills

Lecture Survey Gap Finder

84

mkaremm80/My-Skills-on-Claude

Turn any research topic, in any field, into a colorful PDF lecture survey of recent papers with figures, research gaps and a table of Q1 paper ideas.

Research & Science19

Paper Comic

84

mkaremm80/My-Skills-on-Claude

Turn any research paper into a comic-magazine style PDF story (A4, ~8 pages) that explains the paper smoothly with characters, panels and speech bubbles.

Research & Science19

Paper Equation Guide

84

mkaremm80/My-Skills-on-Claude

Explain every equation of a research paper in a colored PDF guide: labeled equation terms, plain meaning, worked numeric examples, helper drawings and simulation checks. Use when asked to explain a paper's math.

Research & Science19

Strategy and Competitive Analysis

200

lyndonkl/claude

Develops business strategies grounded in rigorous competitive and market analysis using proven frameworks (Good Strategy kernel, Porter's 5 Forces, SWOT, Blue Ocean, Playing to Win, Value Chain Analysis, BCG Matrix). Use when developing strategy (market entry, product launch, expansion, M&A, turnaround), conducting competitive analysis, making strategic decisions (build vs buy, pricing, positioning), planning strategic initiatives, or when user mentions strategy, competitive analysis, Porter's 5 Forces, SWOT, market positioning, or strategic frameworks.

Software Development25

Principle Fix Root Causes

100

adriannoes/awesome-agentic-ai

Apply when debugging. Trace each symptom to its root cause and fix it there; reproduce first, ask why until you reach it, resist nil-check guards that silence crashes.

Software DevelopmentIn 2 lists27

Symmetry Group Identifier

200

lyndonkl/claude

Maps identified symmetries to mathematical groups (cyclic, dihedral, symmetric, SO(3), SE(3), E(3)) for equivariant neural network architecture design, using taxonomy and foundations from Visual Group Theory. Use when candidate symmetries have been identified and need formalization into group theory language, or when user mentions cyclic groups, dihedral groups, Lie groups, SO(3), SE(3), or permutation groups.

Software Development25

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.