{
  "markdown": "# Scientific Coding Skill\n\nA [Claude Code plugin](https://code.claude.com/docs/en/plugins) that teaches Claude to write correct scientific code.\n\nScientific code serves truth, not users. This plugin encodes the principles that follow from that distinction: fail loudly instead of silently, require explicit parameters instead of dangerous defaults, prioritize correctness over convenience.\n\n## Install\n\n### As a plugin (from GitHub)\n\nIn Claude Code, run:\n\n```\n/plugin marketplace add cemde/Scientific-Coding-Skill\n/plugin install scientific-coding@cemde-Scientific-Coding-Skill\n```\n\nThe first command adds this repo as a plugin marketplace. The second installs the skill from it. The skill will be available in all your projects.\n\n### As a standalone skill (copy into your project)\n\nClone the repo and copy the skill directory:\n\n```bash\n# Into a single project\ncp -r Scientific-Coding-Skill/skills/scientific-coding your-project/.claude/skills/\n\n# Into all your projects (personal skills)\ncp -r Scientific-Coding-Skill/skills/scientific-coding ~/.claude/skills/\n```\n\n### For local development\n\n```bash\nclaude --plugin-dir /path/to/Scientific-Coding-Skill\n```\n\n## What It Does\n\nThe skill activates automatically when Claude writes code for scientific computing, data analysis, simulations, numerical methods, or statistical analysis. 12 principles:\n\n1. **Understand the experiment** before deciding what to parameterize\n2. **You are a co-researcher** -- ask questions, verify, read papers\n3. **Fail loudly** -- a crash beats a silently wrong result\n4. **No defaults in code** -- defaults belong in config files\n5. **Be explicit** about units, shapes, assumptions, conversions\n6. **Correctness over performance** -- numerical stability first\n7. **Raw data is immutable** -- never modify, always trace\n8. **Reproducibility is non-negotiable** -- explicit seeds, pinned versions\n9. **Validate against reality** -- known solutions, conservation laws, convergence\n10. **Statistical honesty** -- no p-hacking, report effect sizes\n11. **Do not reinvent** -- use established tools, skip custom infrastructure\n12. **Do not refactor validated code** -- working science code is sacred\n\nSee [skills/scientific-coding/SKILL.md](skills/scientific-coding/SKILL.md) for the full set of principles.\n\n## Structure\n\n```\nScientific-Coding-Skill/\n├── .claude-plugin/\n│   ├── plugin.json              # Plugin manifest\n│   └── marketplace.json         # Marketplace catalog\n├── skills/\n│   └── scientific-coding/\n│       ├── SKILL.md             # Core principles\n│       └── examples/\n│           ├── common-mistakes.md\n│           └── full-analysis.md\n└── README.md\n```\n\n## Contributing\n\nContributions are welcome. In particular:\n\n- **Validation experiments.** Have you tested whether this skill actually changes Claude's coding behavior? We would love to see before/after comparisons, failure cases, or systematic evaluations.\n- **New principles or examples.** If you have encountered a scientific coding mistake that LLMs make repeatedly, open an issue or PR.\n- **Corrections.** If a principle is wrong, misleading, or missing nuance, say so.\n\nOpen an issue or submit a pull request at [github.com/cemde/Scientific-Coding-Skill](https://github.com/cemde/Scientific-Coding-Skill).\n\n## Acknowledgements\n\nThis skill was developed through iterative refinement between a researcher and Claude, attempting to bridge the gap between how LLMs are trained to write code (for production) and how scientific code must be written (for truth). Contributions, criticism, and validation experiments from the community are appreciated.\n\n## Citation\n\nIf you use this skill in your research or reference it in a publication, see [CITATION.cff](CITATION.cff).\n\n```bibtex\n@software{emde2025scientificcoding,\n  author    = {Emde, Cornelius},\n  title     = {Scientific Coding Skill},\n  year      = {2025},\n  url       = {https://github.com/cemde/Scientific-Coding-Skill},\n  version   = {0.1.0}\n}\n```\n",
  "bytes": 3959,
  "sha": "c08ed75fb0ac35d1f9685cb51c1c5243998d014ad60e3d5897baf537202d7949",
  "repo_slug": "cemde/scientific-coding-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_cemde_scientific_coding_skill_scientific_a169bdd4/readme"
}