surajinacademia/computational-modeling-skills
Fourteen skills for research project setup, scientific modeling, paper reproduction, model documentation, Jupyter notebooks, linear stability analysis, quantitative plots, scientific schematics, microscopy image analysis, scientific claim review, staged scientific writing, request clarification, HPC Slurm jobs and sweeps, and end-of-session research lessons.
Changelog
[2.2.0] - 2026-11-16
- Expands the public package from ten to fourteen skills by adding image-analysis (calibrated experimental microscopy segmentation, fluorescence, tracking, and traction-force measurements with paired Panel A/B figures and supplementary methods), ruminations (explicit
/ruminationssession reviews that recap the problem and solution, record rules for the agent inagent_lessons.md, and record learning topics and lessons for the user inmy_lessons.md), writing-process (staged scientific writing from notes, outlines, or figure titles using 19 writing lessons linked to Michael Levin's essay and slides without redistributing external slide figures), and claim-review (critiquing and scoping scientific claims against actual results, figures, and controls along theL0–L7claim-support ladder, with optional secondarystory_arc.mdandoutline.mdtemplates). - Renames
scientific-notebookto jupyter-notebook (writingjupyter_notebooknotebook-state metadata while reading legacyscientific_notebookmetadata for backward compatibility),slurmto hpc-slurm, andResearch_project_setupto research-project-setup, retaining minor version2.2.0as an explicit maintainer exception to the normal major-version rule for renamed invocations; update saved paths and qualified names tocomputational-modeling-skills:jupyter-notebook,computational-modeling-skills:hpc-slurm, andcomputational-modeling-skills:research-project-setup. - Standardizes scientific modeling, theoretical biophysics, and mathematical biology terminology across all fourteen skills and onboarding guides, distinguishing numerical verification from independent physical validation, imaging and numerical artifacts from output files, and independent biological replicates from table row definitions, and linking lets-be-clear across
jupyter-notebook,model-documentation,paper-reproduce,claim-review, andschematic-designer. - Improves scanability with bullet-based workflow steps in the revised
SKILL.mdentrypoints and single-line Markdown paragraphs while preserving YAML triggers, negative exclusions, confirmation pauses, CLI subcommands and flags,validate_target_card.pyschema-v1checks,check_lsa_report.pyTitle Case LaTeX section headers, governing equations, attribution notices, and licenses. - Replaces the README's previous image embeds with one research-process diagram, retaining the scientific example files and their credits. Keeps the Markdown onboarding guide; the previously published HTML walkthrough is unchanged, and the new interactive onboarding page is not included.
- Clarifies supported physics-based model families with per-type requirements and exclusions; mechanism-free empirical fitting and surrogate or machine-learned model development remain outside scope. Brainstorming agrees on the model rationale, deliverables, checks, and stopping condition before work, including long-horizon tasks.
- Records MIASE Box 2's three groups and ten rules with source credit, keeps model versioning separate from simulation records, and aligns the model-document template and review requirements.
- Incorporates canonical updates from the unpublished
2.1.1draft (there was no separate2.1.1release):computational-modelingcompeting-hypothesis test design and fresh-reader assumption review,jupyter-notebookexecution-onlynbclientloading,output_changesreporting, and public overview,paper-reproduceSlurm batch-job and job-array wording, andresearch-project-setupNoble (2009) experiment repeatability organization. - Preserves all other skill names, workflow triggers, confirmation pauses, scientific checks, examples, attribution notices, privacy projections, exclusions, and license terms.
2.1.0 — 2026-10-11
- Adds
Research_project_setupas the tenth skill, with explicit invocation, README and AGENTS templates, attributed Good Research Code guidance, and a reusable Git workflow. - Uses the renamed GitHub repository
surajinacademia/Computational_modeling_skillsin package links while retaining thecomputational-modeling-skillsplugin identifier and existing invocations. - Excludes an unpublished chemoattraction model proposal and private project identifiers from the public payload; retains the runnable example, scientific limitations, required checks, editable sources, attribution, and licenses.
- Includes maintained scientific notebook, plotting, schematic, clarification, and Slurm capacity guidance; Slurm supports jobs and independent sweeps using native scheduler commands.
- Keeps tests, evaluation suites, development logs, future-work plans, caches, and superseded diagrams outside the distribution. The documented optional legacy target-card helper remains available for compatible existing use.
2.0.0 — 2026-09-24 (corrected release)
At the maintainer's explicit request, this corrected 2.0.0 consolidates the initial 2.0.0 and the subsequently published 2.0.1 and 3.0.0. The original 2.0.0 is archived as archive/v2.0.0-original, retaining its original sources, release assets, attribution, and licenses. The former 3.0.0 is archived as archive/v3.0.0-before-correction with its original contents. Both archived releases are marked as prereleases; their release IDs and asset hashes are preserved. The historical v2.0.1 tag remains. These short-lived versions are superseded by this corrected release. This is a documented one-time version correction, not a claim that those versions were never published.
This release also incorporates the previously unpublished 1.0.1 cleanup; there was no separate 1.0.1 release.
- Removes the VIGIL visual example, editable sources, supporting files, and documentation from the current public package, along with its CC BY-NC 4.0 license notice. The privately maintained example is outside this distribution.
- Removes the previously documented
build_example.py vigilcase and bundled VIGIL paths. Users of that example cannot use those paths or that command with this corrected package. All nine skills and the remaining examples are retained. - Retains licenses and attribution for the remaining material, including ShareAlike examples and embedded fonts; the package remains mixed-license. Earlier distributed VIGIL copies retain their attribution and CC BY-NC 4.0 terms. This removal does not relicense them.
- Redraws the collective-cell schematic around complementary modeling choices, retained detail, and coarse-graining. Removes the misleading resolution axis and clarifies the captions and primary-source context.
- Separates single-site cellular automata from multisite Cellular Potts cells, and individual-cell phase fields from spatially averaged tissue density.
- Computes physical vectors from the illustrated force law and chemical field; labels model-dependency links separately from forces.
- Applies the maintainer's minimal README wording and removes installation instructions. Retains SVG examples, editable sources, and links to their scientific context and the third-party notices.
- Renames the collection from Theoretical Biophysics Modeling Skills to Computational Modeling Skills, and the plugin/extension identifier from
theoretical-biophysics-modeling-skillstocomputational-modeling-skills. This is a breaking package identity change; the eight individual skill names remain unchanged. - Adds
paper-reproduceas the ninth skill, with its reviewed operational references, target-card validator, and current decision diagram. Development notes and superseded diagrams remain outside the distribution. - Adds portable root plugin metadata, Codex and Claude repository catalogs, and package logo assets. The package contains no MCP server, app, hook, or automatic installation action.
- Documents scoped handoffs between modeling and documentation, notebooks and visualization, and schematic design and request clarification. Existing approvals and the coordinating skill's requested outputs remain authoritative.
- Changes qualified skill invocations from
theoretical-biophysics-modeling-skills:<skill-name>tocomputational-modeling-skills:<skill-name>. For example,theoretical-biophysics-modeling-skills:model-documentationbecomescomputational-modeling-skills:model-documentation. Update saved qualified invocations when adopting the renamed package. - Moves the derived local checkout to
public/computational-modeling-skills/. The current GitHub hosting address remainshttps://github.com/surajinacademia/theoretical-biophysics-modeling-skillsuntil the owner renames the remote repository. No installation or registration changes are performed by this local rename. - Limits the distribution to skills and their runtime dependencies, supporting material, package metadata, and licensing information.
- Removes development tests and evaluation suites, the development-only
check_model_doc.pychecker, and unused build files. - Routes five manual TikZ recipes through the private build workflow.
- Publishes quantitative PDF outputs through private staging and opened output directories; assembles the gallery from private inputs before publishing it. File replacements are atomic individually, not as a multi-file transaction.
- Rejects escaped or comment-obfuscated SVG CSS, unsupported style properties and functions, and SMIL animation; requires UTF-8 XML and rejects invalid XML control characters. Rejects nonregular TeX source/include files without blocking on FIFOs.
- Preserves the original eight skill names and remaining diagram creator credits and third-party license terms. The published
v1.0.0release and its history remain unchanged.
1.0.0
First stable eight-skill collection. This establishes the compatibility contract in VERSIONING.md.
- Retains computational modeling, model documentation, schematic design, and request clarification.
- Adds scientific notebooks, linear stability analysis, data visualization, and a portable single-job CPU Slurm workflow.
- Removes
gotchafrom the current package; this does not erase prior releases or repository history. Private skills are outside this release. - Aligns platform manifest versions and documents mixed licensing, per-example diagram attribution, notebook provenance, and font notices. VIGIL remains CC BY-NC 4.0; share-alike examples retain their applicable terms.