Skip to content

BotCity Phoenix — UiPath to Python Migration

BotCity Phoenix is a Claude Code skill that converts UiPath workflow files (.xaml + .json) into Python automations ready for the BotCity ecosystem. This guide describes how to install the skill and run your first conversion.

Prerequisites

  • Claude Code installed on your machine
  • UiPath process files available locally: the .xaml file (workflow) and the .json file (usually project.json)
  • Python with the BotCity SDK installed:
pip install botcity-maestro-sdk

Install the Phoenix skill

Copy the skill folder to Claude Code's skills directory:

mkdir -p ~/.claude/skills
cp -r ./phoenix-botcity ~/.claude/skills/

Restart Claude Code for the skill to be recognized.

Tip

Confirm the skill was installed correctly: when you type / in Claude Code, phoenix-botcity should appear in the list of available skills.

Open Claude Code in the project folder

Navigate to the directory where the UiPath process .xaml and .json files are located:

cd /path/to/your/uipath-project

Open Claude Code in that directory. The skill needs access to the project files to perform the conversion.

Run the conversion

In Claude Code, call the skill:

/phoenix-botcity

To pass additional context — such as keeping the original variable names or converting a specific file —, include the instruction in the call:

/phoenix-botcity convert ProcessBilling.xaml keeping the original variable names

To convert an entire project with multiple .xaml files, point to the root folder and instruct the skill:

/phoenix-botcity convert the entire project

Review the generated files

After execution, the skill generates three files in the project folder:

File Content
.py Automation converted to Python
requirements.txt Required BotCity dependencies
MIGRATION_NOTES.md Points that require manual review

Open MIGRATION_NOTES.md first. It lists:

  • Custom activities that became # TODO in the Python code
  • UiPath selectors that may need manual adjustment
  • Credentials and environment variables that need to be reconfigured

Warning

BotCity Phoenix is a migration accelerator, not a complete automatic converter. Review the generated code and MIGRATION_NOTES.md before using the automation in production.

Expected result

At the end of the process, you will have:

  • A functional .py file with the automation converted to the BotCity standard
  • A requirements.txt with the libs needed to run the automation
  • A MIGRATION_NOTES.md detailing everything that requires human attention before going to production