PyOD 3.2.0 — od-expert skill deepening

Minor release that transforms the bundled od-expert skill from a 78-line API documentation file into a real expert distillation (~1000 lines) that drives PyOD's ADEngine autonomously for non-expert users.

What's new

• Deepened od-expert skill (~1000 lines across SKILL.md + 6 reference files).
• SKILL.md: activation rules, master decision tree, top-10 critical pitfalls, 11 adaptive escalation triggers
• references/workflow.md: autonomous loop pattern, escalation phrasings, cardio canonical worked example, result interpretation patterns
• references/pitfalls.md: 23 additional pitfalls organized by phase (preprocessing / detection / analysis / reporting / iteration), severity-tagged
• references/{tabular,time_series,graph,text_image}.md: per-modality decision tables, KB-derived detector lists, worked snippets, modality-specific pitfalls
• Skill maintenance methodology guide at docs/skill_maintenance.rst documenting the hybrid hand-written + KB-derived pattern, manual + automatic update workflows, and the recipe for adding new skills.
• Build-time generator scripts/regen_skill.py refreshes KB-derived sections in skill files from pyod.utils.knowledge.
• CI safety net pyod/test/test_skill_kb_consistency.py asserts every backtick-wrapped detector name in the skill matches the live KB; drift fails the build loudly.
• Tree-aware skill installer: pyod install skill now copies the entire skill directory tree (including references/), not just SKILL.md.
• KB metadata fix for SUOD and FeatureBagging so engine.explain_detector() now correctly surfaces their suod and combo extras as install hints.

Behind the scenes

• Skill content distilled from a one-shot research pass over 2024-2025 OD/AD literature, industry case studies, and benchmarks. Cited sources in docs/superpowers/research/2026-04-13-od-ad-state-of-art.md.
• Literature recommendations not yet supported by PyOD are tracked in docs/v3.3-backlog.md for future releases.

Install

:::bash
pip install --upgrade pyod
pyod install skill
pyod info

No breaking changes. v3.0.0 / v3.1.0 user code keeps working unchanged.