python-analytics-skills

Python Analytics Skills

A plugin for Claude Code and other AI coding platforms providing Agent Skills for Bayesian modeling and reactive notebooks. Packages specialized knowledge for PyMC and marimo into skills that Claude loads on-demand.

Skills

Skill	Description
pymc-modeling	Bayesian statistical modeling with PyMC v5+. Covers model specification, MCMC inference (nutpie, NumPyro), ArviZ diagnostics, hierarchical models, GLMs, GPs, BART, time series, and more.
pymc-testing	Testing PyMC models with pytest. Covers mock sampling with pymc.testing.mock_sample, pytest fixtures, and the distinction between fast structure-only tests (mocking) and slow posterior inference tests.
marimo-notebook	Reactive Python notebooks with marimo. Covers CLI, UI components, layout, SQL integration, caching, state management, and wigglystuff widgets.

Installation

Via npx (Recommended — works across agents)

npx skills add pymc-labs/python-analytics-skills

One command, works with Claude Code, Cursor, Gemini CLI, and 15+ other agents.

As a Claude Code Plugin

Two-step process using Claude Code slash commands:

/plugin marketplace add pymc-labs/python-analytics-skills
/plugin install analytics@pymc-labs-python-analytics-skills

Installs all skills plus the keyword-suggestion hook. Supports /plugin update for future updates.

Manual Installation

git clone https://github.com/pymc-labs/python-analytics-skills.git
cd python-analytics-skills
./install.sh claude              # Claude Code
./install.sh all                 # All platforms
./install.sh claude -- pymc-modeling  # Specific skill only

Utility Commands

# List available skills with descriptions
./install.sh --list

# Validate skill structure
./install.sh --validate

Platform Support

Platform	Install Location	Auto-Discovered
Claude Code	~/.claude/skills/	Yes
OpenCode	~/.config/opencode/skills/	Yes
Gemini CLI	~/.gemini/skills/	Yes
Cursor	~/.cursor/skills/	Yes
VS Code Copilot	~/.copilot/skills/	Yes

Plugin Structure

python-analytics-skills/
├── .claude-plugin/
│   ├── marketplace.json    # Plugin registry metadata
│   └── plugin.json         # Plugin configuration
├── skills/
│   ├── pymc-modeling/
│   │   ├── SKILL.md        # Main skill instructions
│   │   └── references/     # 12 detailed reference docs
│   ├── pymc-testing/
│   │   ├── SKILL.md        # Main skill instructions
│   │   └── references/
│   └── marimo-notebook/
│       ├── SKILL.md        # Main skill instructions
│       ├── references/     # 4 reference docs
│       ├── assets/         # Notebook templates
│       └── scripts/        # Conversion utilities
├── hooks/
│   ├── hooks.json          # Hook configuration
│   └── suggest-skill.sh    # Keyword-based skill suggestion
├── install.sh              # Multi-platform installer
├── package.json            # npm package metadata
└── skills.json             # Skills registry

Hooks

The plugin includes a UserPromptSubmit hook that suggests relevant skills when it detects keywords in your prompt:

• PyMC keywords: bayesian, pymc, mcmc, posterior, inference, arviz, prior, sampling, divergence, hierarchical model, gaussian process, bart, etc.
• Marimo keywords: marimo, reactive notebook, @app.cell, mo.ui, etc.

Troubleshooting

Skill not loading:

1. Verify the skill directory exists with a valid SKILL.md
2. Run ./install.sh --validate to check structure
3. For Claude Code plugins, check claude --debug for hook/skill loading errors

Hook not firing:

1. Hooks load at session start -- restart Claude Code after changes
2. Use /hooks in Claude Code to see loaded hooks
3. Test the hook script directly: echo '{"user_prompt": "bayesian model"}' | bash hooks/suggest-skill.sh

Contributing

See CONTRIBUTING.md for guidelines on adding new skills.

License

MIT License. See LICENSE for details.