Installation

There are two ways to install MAGIC Data Agent Skills, depending on which AI tool you use and how you prefer to manage installations.

Prerequisites

Python 3.12+ (for data processing scripts)
Node.js 20+ (for the CLI installer)
An AI coding assistant (Claude Code, Cursor, Windsurf, etc.)

Choose Your Installation Path

The CLI installer supports 30+ AI tools with interactive setup and auto-detection.

# Interactive — auto-detects tools in your project
npx @votee-ai/magic-data-agent-skills init

# Non-interactive — specify tools directly
npx @votee-ai/magic-data-agent-skills init --tools claude,cursor,windsurf

# Install for all supported tools
npx @votee-ai/magic-data-agent-skills init --tools all

Or install globally for repeated use:

npm install -g @votee-ai/magic-data-agent-skills
magic-data-agent-skills init --tools claude

What gets installed: 12 skills + 13 slash commands, configured for each selected tool. The installer copies skill packages into each tool's configuration directory (e.g., .claude/skills/, .cursor/skills/) and adapts slash commands to each tool's native format.

A magic-data-agent-skills.json config file is saved in your project root to track which tools are installed.

Managing Your Installation

# Update skills after upgrading the package
magic-data-agent-skills update

# Remove skills from specific tools
magic-data-agent-skills remove --tools cursor

# Remove all installed skills and config
magic-data-agent-skills remove

# Reinstall over an existing installation
magic-data-agent-skills init --force

Compatible with the open agent skills ecosystem:

npx skills add votee-ai/magic-data-agent-skills

What gets installed: 12 skills only (no slash commands). Convention-based installation that works with any agent supporting the skills protocol.

Comparison

Feature	CLI Installer	Skills CLI
Skills (12)	Yes	Yes
Slash Commands (13)	Yes	No
Multi-tool support	30+ tools	Any agent
Update management	`update` command	Manual
Interactive setup	Yes	No
Config tracking	`magic-data-agent-skills.json`	No

Install Python Dependencies

Skills use Python for data processing. Install the required packages:

pip install -r requirements.txt

The requirements.txt is included in the repository and covers all required packages (pandas, numpy, scipy, matplotlib, seaborn, chardet, openpyxl, pyarrow, and more).

For optional features (interactive charts, schema validation, database connections):

pip install plotly pandera sqlalchemy jinja2 tabulate

Verify Installation

After installing, ask your AI assistant:

"What MAGIC data skills do you have available?"

The agent should list the 12 installed skills and describe their capabilities. You can also check which tools are configured:

cat magic-data-agent-skills.json

Supported Tools

The CLI installer supports 30 AI coding tools across different command formats. See the full list for --tools values and compatibility details.

Was this page helpful?

On this page