FiftyOne Skills

 

Expert workflows for computer vision powered by AI assistants

Documentation · MCP Server · FiftyOne Plugins · Discord

What are Skills?

Skills are packaged workflows that teach AI assistants to perform complex computer vision tasks autonomously. Combined with the FiftyOne MCP Server, you can find duplicates, run inference, and explore datasets using natural language.

"Find and remove duplicate images from my dataset"
"Import this COCO dataset and run object detection"
"Visualize my embeddings and identify outliers"

Skills bridge the gap between natural language and FiftyOne's 80+ operators, providing step-by-step guidance that AI assistants follow to complete complex workflows.

Available Skills

Skill	Description	MCP
📥 Dataset Import	Universal import for all media types, label formats, multimodal groups, and Hugging Face Hub	Yes
📤 Dataset Export	Export datasets to COCO, YOLO, VOC, CVAT, CSV, Hugging Face Hub, and more	Yes
🔍 Find Duplicates	Find and remove duplicate images using brain similarity	Yes
🤖 Dataset Inference	Run Zoo models for detection, classification, segmentation, embeddings	Yes
📈 Model Evaluation	Compute mAP, precision, recall, confusion matrices, analyze TP/FP/FN	Yes
📊 Embeddings Visualization	Visualize datasets in 2D, find clusters, identify outliers	Yes
🔌 Develop Plugin	Create custom FiftyOne plugins (operators and panels)	—
🎨 VOODO Design	Build UIs with VOODO React components and design tokens	—
📝 Code Style	Write Python code following FiftyOne's official conventions	—
📓 Create Notebook	Create Jupyter notebooks: getting-started guides, tutorials, recipes, ML pipelines	—
🏷️ Issue Triage	Triage GitHub issues: validate status, categorize, generate responses	—
🔧 Troubleshoot	Fix common issues: dataset persistence, App connection, MongoDB errors, codecs, performance	—

Quick Start

Step 1: Install Skills

Universal Installer (Recommended):

curl -sL skil.sh | sh -s -- voxel51/fiftyone-skills

Interactive prompts let you select skills, agents, and install scope (project or global).

Supported agents: Claude Code, Cursor, Codex, OpenCode, GitHub Copilot, Amp, Antigravity, Roo Code, Kilo Code, Goose

Claude Code:

# Register the skills marketplace
/plugin marketplace add voxel51/fiftyone-skills

# Install a skill
/plugin install fiftyone-find-duplicates@fiftyone-skills

Gemini CLI:

gemini extensions install https://github.com/voxel51/fiftyone-skills.git --consent

Step 2: Use It

"Write a FiftyOne plugin that displays model confidence"
"Write Python code following FiftyOne conventions"

Your AI assistant will automatically load the skill instructions and execute the workflow.

Step 3: Set Up MCP Server (Optional)

Skills marked with MCP in the table above require the FiftyOne MCP Server to interact with datasets and run operators.

pip install fiftyone-mcp-server

⚠️ Important: Make sure to use the same Python environment where you installed the MCP server when configuring your AI tool. If you installed it in a virtual environment or conda environment, you must activate that environment or specify the full path to the executable.

Then configure your AI tool:

Claude Code (Recommended)

claude mcp add fiftyone -- fiftyone-mcp

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "fiftyone": {
      "command": "fiftyone-mcp"
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "fiftyone": {
      "command": "fiftyone-mcp"
    }
  }
}

VSCode

Add to .vscode/mcp.json:

{
  "servers": {
    "fiftyone": {
      "command": "fiftyone-mcp"
    }
  }
}

Once configured, you can use MCP-dependent skills:

"Find and remove duplicate images from my dataset"
"Import this COCO dataset and run object detection"

Skill Structure

Each skill follows the Agent Skills specification:

skills/
└── fiftyone-find-duplicates/
    └── SKILL.md                     # Instructions for AI

SKILL.md format:

---
name: skill-name
description: When to use this skill
---

# Overview
What this skill does

# Prerequisites
Required setup

# Key Directives
ALWAYS/NEVER rules for AI

# Workflow
Step-by-step instructions

# Troubleshooting
Common errors and solutions

Contributing

We welcome contributions! Here's how to create a new skill:

1. Fork this repository
2. Copy an existing skill folder (e.g., skills/fiftyone-find-duplicates/)
3. Update SKILL.md with your workflow
4. Add your skill to .claude-plugin/marketplace.json
5. Test with your AI assistant
6. Submit a Pull Request

See find-duplicates SKILL.md for a complete example.

Feedback

Help us improve FiftyOne Skills!

Just ask your AI assistant:

"Help me submit feedback about [your issue]"

The agent will automatically gather session context, environment info, and can submit directly via gh CLI or generate content to paste at Submit Feedback

Resources

Resource	Description
FiftyOne Docs	Official documentation
FiftyOne MCP Server	MCP server for AI integration
FiftyOne Plugins	Official plugin collection
Agent Skills Spec	Skills format specification
PyPI Package	MCP server on PyPI
Discord Community	Get help and share ideas

🧡 Community

Join the FiftyOne community to get help, share your skills, and connect with other users:

• Discord: FiftyOne Community
• GitHub Issues: Report bugs or request features

---

Copyright 2017-2026, Voxel51, Inc. · Apache 2.0 License