Numpy
DevelopmentnumpyNumpy is an Agent Skill for development published in the microsoft/debugpy repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Best practices for numerical computing with NumPy including arrays, broadcasting, and vectorization.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/microsoft/debugpy/blob/HEAD/.claude/skills/numpy/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/numpy, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Skill: NumPy
Best practices for numerical computing with NumPy including arrays, broadcasting, and vectorization.
When to Use
Apply this skill when doing numerical computing with NumPy — arrays, broadcasting, linear algebra, random sampling.
Arrays
- Use explicit dtypes (
np.float64,np.int32) when creating arrays. - Prefer
np.zeros,np.ones,np.empty,np.arange,np.linspaceover list-based construction. - Use structured arrays or separate arrays instead of object arrays.
Vectorization
- Replace Python loops with vectorized NumPy operations wherever possible.
- Use broadcasting rules to operate on arrays of different shapes without explicit expansion.
- Use
np.where()for conditional element-wise operations.
Memory
- Use
np.float32instead ofnp.float64when precision is not critical to halve memory. - Use views (
reshape, slicing) instead of copies when data doesn't need mutation. - Use
np.memmapfor arrays too large to fit in RAM.
Random
- Use
np.random.default_rng(seed)(new Generator API) instead ofnp.random.seed(). - Always seed random generators in tests for reproducibility.
Pitfalls
- Don't compare floats with
==; usenp.allclose()ornp.isclose(). - Beware of silent integer overflow in integer arrays.
- Avoid
np.matrix— it's deprecated; use 2Dnp.ndarray.