Import Claude Code marketplace plugins into FactoryAI
npm install droid-importImport Claude Code marketplace plugins into FactoryAI, including skills (which other tools lack).
- Full skill support - copies entire skill directories with resources, references, scripts
- Agent → Droid conversion - transforms Claude agents to Factory droids with proper YAML frontmatter
- Interactive mode - beautiful multi-select UI with @clack/prompts
- Non-interactive mode - CLI flags for automation and CI/CD
- Dry-run mode - preview changes before writing
- GitHub integration - fetch marketplaces directly from GitHub repos
``bashRun directly with bunx (recommended)
bunx droid-import
Usage
$3
bash
bunx droid-import
`This launches a guided flow:
1. Enter marketplace URL or GitHub shorthand
2. Select install location (project or personal)
3. Select plugins to import
4. Select components (agents, commands, skills)
5. Choose overwrite behavior
$3
bash
Import from GitHub shorthand
bunx droid-import --marketplace majesticlabs-dev/majestic-marketplaceImport specific plugins
bunx droid-import --marketplace majesticlabs-dev/majestic-marketplace \
--plugins majestic-engineer,majestic-railsDry run to preview
bunx droid-import --marketplace --dry-run --verboseImport to personal directory
bunx droid-import --marketplace --scope personalSkip specific components
bunx droid-import --marketplace --no-skills --no-commands
`CLI Options
| Option | Description |
|--------|-------------|
|
| Marketplace URL, GitHub shorthand (owner/repo), or local path |
| --plugins | Comma-separated plugin names (default: all) |
| --scope | Install location: personal (~/.factory) or project (.factory, default) |
| --path | Project directory for 'project' scope (default: cwd) |
| --force | Overwrite existing files |
| --dry-run | Preview changes without writing files |
| --analyze | Show compatibility analysis report before import |
| --no-filter | Import all items without filtering incompatible ones |
| --verbose | Show detailed output |
| --verify | Run droid CLI verification after import (non-interactive only) |
| --no-agents | Skip agent/droid import |
| --no-commands | Skip command import |
| --no-skills | Skip skill import |
| --help | Show help message |Compatibility Analysis
droid-import automatically analyzes plugins for Factory AI compatibility before importing:
`bash
Show detailed compatibility report
bunx droid-import --marketplace --analyze
`What gets checked:
- Tool compatibility (Claude tools → Factory tools mapping)
- Required frontmatter fields (
, description)
- Claude-specific patterns that won't work in FactoryTool Mapping:
| Claude Code | Factory AI |
|-------------|-----------|
|
Write | Edit |
| Bash | Execute |
| NotebookEdit | (skipped - no equivalent) |
| BrowseURL | (skipped - use WebSearch/FetchUrl) |
| AskUserQuestion | (converted - uses conversation flow) |Incompatible items are automatically filtered out during import. Use
--no-filter to import everything regardless of compatibility.Post-Import Verification
After importing, you can verify that all files are properly converted for Factory AI:
Interactive mode: You'll be prompted to run verification after successful import.
Non-interactive mode: Use the
--verify flag:`bash
bunx droid-import --marketplace --verify
`The verifier launches the
CLI to:
1. Sample imported files from droids, commands, and skills
2. Check that tool names use Factory AI equivalents
3. Report any files that need manual fixesWhat Gets Converted
| Claude Code | Factory AI | Location |
|-------------|-----------|----------|
|
agents/.md | droids/.md | .factory/droids/ |
| commands/.md | commands/.md | .factory/commands/ |
| skills/ | skills/ | .factory/skills/ |$3
`yaml
Claude Code agent # Factory droid
--- ---
name: code-reviewer name: code-reviewer
description: Reviews code description: Reviews code
tools: Read,Edit model: inherit
--- tools:
- Read
- Edit
---
`$3
Skills are copied with their full directory structure:
-
/ skill.mdx - main skill file (frontmatter normalized)
- resources/ - supporting documentation
- references/ - reference materials
- scripts/ - executable scripts
- assets/ - templates and other filesMarketplace Format
The tool expects marketplaces with a
.claude-plugin/marketplace.json file:`json
{
"name": "my-marketplace",
"plugins": [
{
"name": "my-plugin",
"description": "Plugin description",
"source": "./plugins/my-plugin"
}
]
}
`Each plugin directory should contain:
plugins/my-plugin/
├── agents/ # → .factory/droids/
├── commands/ # → .factory/commands/
└── skills/ # → .factory/skills/
└── my-skill/
├── SKILL.md
└── resources/
Troubleshooting
$3
If
shows an outdated version, clear the cache:`bash
rm -rf ~/.bun/install/cache
bunx droid-import
`Or force the latest version:
bash
bunx droid-import@latest
`Requirements
- Bun runtime
- FactoryAI CLI with Custom Droids enabled (
MIT