cleanup-notebooks
Clean up and reorganize markdown in enriched Jupyter notebooks. Arguments: [target] [--dry-run] [--aggressive] [--hierarchy-only]
Instal·la
npx skillscat add jsboige/coursia/cleanup-notebooks Instal·la des del registre de SkillsCat.
SKILL.md
Cleanup Notebooks
Reorganize and deduplicate pedagogical markdown in Jupyter notebooks.
Target: $ARGUMENTS
Arguments
target: Notebook path, family name, orall--dry-run: List problems without modifying--aggressive: Aggressive deduplication--hierarchy-only: Fix heading structure only
Process
Parse target - Discover notebooks
For each notebook, launch a background agent:
- Read notebook-cleaner agent instructions (
.claude/agents/notebook-cleaner.md) - Read entire notebook, analyze structure
- Identify problems (duplicates, misplaced cells, heading jumps, empty cells)
- Fix via NotebookEdit (one operation at a time, verify diff after each)
- Re-read notebook after each operation (indices change)
- Read notebook-cleaner agent instructions (
If --dry-run: List problems without modifying
Generate summary with cells deleted/modified per notebook
Common Issues
| Pattern | Fix |
|---|---|
| Double introduction | Keep first, delete second |
| Orphan interpretation (before code) | Move after code cell |
Heading jump (## then ####) |
Change to ### |
| Empty transition cell | Delete or add content |
| Repeated concept definition | Keep best, delete others |
| Consecutive interpretation cells | Merge or delete duplicate |
Safety Rules
- GOLDEN RULE: "Don't break what works" - if structure is good, don't modify
- Verify diffs after every operation
- Never delete code cells (only markdown)
- Re-read notebook after each edit (indices change)
- Use cell CONTENT for identification, not indices
Categories
Instal·la
npx skillscat add jsboige/coursia/cleanup-notebooks Instal·la des del registre de SkillsCat.
Estrelles del repositori
El nombre d’estrelles correspon al repositori (jsboige/CoursIA), no a aquest skill concret.
.claude/skills/cleanup-notebooks