# agent-import

agent-import moves an agent into Starchild from a migration bundle. Use it when an agent comes from another platform and you have its migration code and download token.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 232 installs · ★ 33 repo stars
- Author: starchild
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/agent-import/SKILL.md
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/agent-import

## What it does

This skill retrieves and unpacks an agent migration bundle, then presents its contents before making changes. The bundle can carry user settings, the agent profile, `SOUL.md`, agent and user memory, scheduled tasks, environment keys, and workspace files. After approval, the agent applies these parts through Starchild’s native tools.

The sequence is deliberate: user settings come first, followed by identity, memory, tasks, environment keys, and files. Memory has a 5000-character limit for the agent and a 3000-character limit for the user. Access to the Fly internal network is required; without it, the import fails. The download token is single-use and expires with the code after 1 hour.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill agent-import -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/agent-import/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/agent-import/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill agent-import -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/agent-import/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill agent-import -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/agent-import/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Starchild-ai-agent/official-skills agent-import
```

2. **Manually: put the files in place**
- File: `.github/skills/agent-import/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill agent-import -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path agent-import
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/agent-import/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill agent-import -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/agent-import/SKILL.md

## When to use it
- move an agent from another platform into Starchild
- download a migration bundle with its code and token
- restore agent settings and identity
- rebuild memory, tasks, and workspace files
- request environment keys after migration

## Example prompts
- Import this agent into Starchild using the migration code and download token I provided.
- Show me the bundle contents and wait for my approval before applying anything.
- Restore the settings, profile, memory, and tasks, while protecting important existing files.

## Similar
- [wiki-import](https://affpapa.org/en/nevibecode/skills/wiki-import.md) — skill · 1000 installs
- [re0-import](https://affpapa.org/en/nevibecode/skills/re0-import.md) — skill · 123 installs
- [neo4j-import-skill](https://affpapa.org/en/nevibecode/skills/neo4j-import-skill.md) — skill · 908 installs
- [paypal-import](https://affpapa.org/en/nevibecode/skills/paypal-import.md) — skill · 436 installs
- [stripe-import](https://affpapa.org/en/nevibecode/skills/stripe-import.md) — skill · 433 installs
- [import](https://affpapa.org/en/nevibecode/skills/import.md) — skill · 1 install

From the same set: [starchild-ai-agent/official-skills](https://affpapa.org/en/nevibecode/by/starchild-ai-agent/official-skills.md) — 66 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
