Jupyter Notebook Skill for Codex
當使用者要求建立、搭建或編輯 Jupyter 筆記本（`.ipynb`）用於實驗、探索或教學時使用；優先使用隨附範本並執行輔助腳本 `new_notebook.py` 來產生一個乾淨的起始筆記本。
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/microsoft/ai-agents-for-beginners --skill jupyter-notebookWhat comes with it
10 318 bytes besides the instructionThe instruction itself
1 sections, as written by the authorJupyter Notebook 技能
為兩種主要模式建立乾淨、可重現的 Jupyter 筆記本：
- 實驗與探索性分析
- 教學與教學導向的逐步示範
優先使用內建的範本與輔助腳本，以維持一致的結構並減少 JSON 錯誤。
何時使用
- 從頭建立新的
.ipynb筆記本。 - 將粗略筆記或腳本轉換為結構化的筆記本。
- 將現有筆記本重構為更可重現且易於瀏覽的版本。
- 建立將由其他人閱讀或重新執行的實驗或教學內容。
決策樹
- 如果請求是探索性、分析性或以假設為驅動，選擇
experiment。 - 如果請求是教學性、逐步導引或針對特定觀眾，選擇
tutorial。 - 如果是在編輯現有筆記本，視為重構：保留原意並改善結構。
技能路徑（設定一次）
export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
export JUPYTER_NOTEBOOK_CLI="$CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py"
User-scoped skills install under $CODEX_HOME/skills (default: ~/.codex/skills).
工作流程
- Lock the intent.
Identify the notebook kind: experiment or tutorial.
Capture the objective, audience, and what "done" looks like.
- Scaffold from the template.
Use the helper script to avoid hand-authoring raw notebook JSON.
uv run --python 3.12 python "$JUPYTER_NOTEBOOK_CLI" \
--kind experiment \
--title "Compare prompt variants" \
--out output/jupyter-notebook/compare-prompt-variants.ipynb
uv run --python 3.12 python "$JUPYTER_NOTEBOOK_CLI" \
--kind tutorial \
--title "Intro to embeddings" \
--out output/jupyter-notebook/intro-to-embeddings.ipynb
- 填充筆記本，使用小且可執行的步驟。
保持每個程式碼儲存格專注於單一步驟。
新增簡短的 markdown 儲存格來說明目的與預期結果。
當簡短摘要足夠時，避免產生大量嘈雜的輸出。
- 應用正確的模式。
對於實驗，請遵循 references/experiment-patterns.md。
對於教學，請遵循 references/tutorial-patterns.md。
- 在處理現有筆記本時安全地編輯。
保留筆記本結構；除非能改善從上到下的敘事流程，否則避免重新排序儲存格。
偏好有針對性的編輯而非全部重寫。
如果必須編輯原始 JSON，先檢閱 references/notebook-structure.md。
- 驗證結果。
在環境允許時，從上到下執行筆記本。
如果無法執行，請明確說明並指出如何在本機驗證。
使用 references/quality-checklist.md 中的最終檢查清單。
範本與輔助腳本
- 範本位於
assets/experiment-template.ipynb與assets/tutorial-template.ipynb。 - 輔助腳本會載入範本、更新標題儲存格，並寫出筆記本。
腳本路徑：
$JUPYTER_NOTEBOOK_CLI(installed default:$CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py)
暫存與輸出慣例
- 對於中間檔案，使用
tmp/jupyter-notebook/；完成後刪除。 - 在此 repo 工作時，將最終產物寫入
output/jupyter-notebook/。 - 使用穩定且具描述性的檔名（例如，
ablation-temperature.ipynb）。
相依性（僅在需要時安裝）
偏好使用 uv 進行相依性管理。
供本機筆記本執行的可選 Python 套件：
uv pip install jupyterlab ipykernel
The bundled scaffold script uses only the Python standard library and does not require extra dependencies.
環境
沒有必需的環境變數。
參考對照表
references/experiment-patterns.md: 實驗結構與啟發式規則。references/tutorial-patterns.md: 教學結構與教學流程。references/notebook-structure.md: 筆記本 JSON 形態與安全編輯規則。references/quality-checklist.md: 最終驗證檢查清單。
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
免責聲明：
本文件已透過 AI 翻譯服務 Co-op Translator (https://github.com/Azure/co-op-translator) 進行翻譯。雖然我們力求準確，但請注意自動翻譯可能包含錯誤或不準確之處。原始語言版本的文件應被視為具權威性的來源。對於重要資訊，建議採用專業人工翻譯。因使用本翻譯而產生的任何誤解或誤譯，我們不承擔任何責任。
<!-- CO-OP TRANSLATOR DISCLAIMER END -->
Other skills for the same job
different authors, same section of the catalogue
Integration with protocols.io API for managing scientific protocols. This skill should be used when working with protocols.io to search, create, update, or publish protocols; manage protocol steps and materials; handle discussions and comments; organize workspaces; upload and manage files; or integrate protocols.io functionality into workflows. Applicable for protocol discovery, collaborative protocol development, experiment tracking, lab protocol management, and scientific documentation.
Analyzes job descriptions and generates tailored resumes that highlight relevant experience, skills, and achievements to maximize interview chances
Generate Excalidraw diagrams from natural language descriptions. Use when asked to "create a diagram", "make a flowchart", "visualize a process", "draw a system architecture", "create a mind map", or "generate an Excalidraw file". Supports flowcharts, relationship diagrams, mind maps, and system architecture diagrams. Outputs .excalidraw JSON files that can be opened directly in Excalidraw.
Build and distribute Expo development clients locally or via TestFlight
Use when you have a written implementation plan to execute in a separate session with review checkpoints
Data structure for annotated matrices in single-cell analysis. Use when working with .h5ad files or integrating with the scverse ecosystem. This is the data format skill—for analysis workflows use scanpy; for probabilistic models use scvi-tools; for population-scale queries use cellxgene-census.
Benchling R&D platform integration. Access registry (DNA, proteins), inventory, ELN entries, workflows via API, build Benchling Apps, query Data Warehouse, for lab data management automation.
Comprehensive molecular biology toolkit. Use for sequence manipulation, file parsing (FASTA/GenBank/PDB), phylogenetics, and programmatic NCBI/PubMed access (Bio.Entrez). Best for batch processing, custom bioinformatics pipelines, BLAST automation. For quick lookups use gget; for multi-service integration use bioservices.
How to use it
Take microsoft/ai-agents-for-beginners-.agents-jupyter-notebook from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.
The instructions reference pip, uv.
Without those the skill loads but fails at the first command.