MAGIC Agent Skills is now open source! Star on GitHub
MAGIC Agent SkillsMAGIC Agent Skills
Getting Started

CLI Installer

The CLI installer is the recommended way to install MAGIC Data Agent Skills. It supports 30+ AI coding tools with interactive setup and auto-detection.

Quick Start

# 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

For each selected tool, the installer copies:

  • 12 skill packages — each with SKILL.md, scripts/, and references/ directories
  • 13 slash commands — adapted to each tool's native command format
  • magic-data-agent-skills.json — config file saved in your project root to track installed tools

Skills are placed in the tool's configuration directory (e.g., .claude/skills/, .cursor/skills/) where the agent discovers them automatically.

Options

FlagDescription
--tools <list>Comma-separated tool names, or all for all 30 tools
--forceReinstall over an existing installation
--skills <list>Install only specific skills (comma-separated skill names)
--globalInstall to home directory (~/.magic/skills/) for cross-project use

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

Supported Tool Values

Use these values with --tools:

Tool--tools value
Claude Codeclaude
Cursorcursor
Windsurfwindsurf
Gemini CLIgemini
GitHub Copilotgithub-copilot
Clinecline
RooCoderoocode
Continuecontinue
Codexcodex
Kilo Codekilocode
Kirokiro

See the full list of supported tools for all 30 tool values and command format details.

Examples

# Claude Code only
npx @votee-ai/magic-data-agent-skills init --tools claude

# Claude Code + Cursor + Windsurf
npx @votee-ai/magic-data-agent-skills init --tools claude,cursor,windsurf

# All tools
npx @votee-ai/magic-data-agent-skills init --tools all

# Only the synthesis and cleaning skills for Claude Code
npx @votee-ai/magic-data-agent-skills init --tools claude --skills magic-data-synthesis,magic-data-cleaning

# Global install (available across all projects)
npx @votee-ai/magic-data-agent-skills init --global --tools claude

After Installation

Verify the installation by asking your AI assistant:

"What MAGIC data skills do you have available?"

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

cat magic-data-agent-skills.json

Prerequisites

  • Node.js 20+ — required for the CLI installer
  • Python 3.12+ — required for skill scripts

After installing skills, install the Python dependencies:

pip install -r requirements.txt

The requirements.txt is included in each skill's directory and covers all required packages.

Was this page helpful?
Edit on GitHub

Last updated on

On this page