Documentation

Getting Started

RPASkills.ai provides enterprise-grade automation skills with deterministic-first design.

# Clone and configure

cp .env.example .env

# Start with Docker

make docker-up

# Or run locally

make dev

Skill Contract

Every skill follows a strict contract: manifest.json, input_schema.json, output_schema.json, and handler.py.

  • manifest.json - Metadata: name, version, tags, category, mode
  • input_schema.json - JSON Schema for input validation
  • output_schema.json - JSON Schema for output structure
  • handler.py - async handle(input) -> output function
  • mcp_adapter.py - MCP tool definition for packaging

API Reference

GET/api/healthHealth check
POST/api/auth/registerRegister new user
POST/api/auth/loginLogin
GET/api/skillsList skills (paginated)
GET/api/skills/{slug}Get skill detail
POST/api/skills/{id}/executeExecute a skill
GET/api/executionsList executions

UiPath Integration

RPASkills.ai is designed for deep integration with the UiPath ecosystem.

  • Orchestrator API - Skills can read queues, jobs, assets, and processes
  • Agent Builder - Package skills for UiPath Agent Builder consumption
  • Maestro - Human-in-the-loop escalation via Maestro actions
  • REFramework - Aligned failure classification and retry logic

MCP Server Guide

Skills can be packaged as Model Context Protocol (MCP) servers for use with UiPath and other AI agents.

# Generate MCP server scaffold

python -m rpaskills scaffold --type mcp-server my-skill

 

# Run the MCP server

cd my-skill && python mcp_server.py

Contributing

Want to create and publish your own skills? Follow these steps:

  1. Use the Skill Scaffold Generator to bootstrap your project
  2. Implement the handler.py with your automation logic
  3. Define input_schema.json and output_schema.json
  4. Write tests and ensure deterministic behavior
  5. Submit a pull request or publish through the API

Workflow Generation

The Workflow Generator converts structured JSON definitions into valid UiPath XAML using 94 deterministic Python generators across 10 activity categories.

  • UI Automation - Click, Type Into, Get Text, Check State, and more (11 generators)
  • Control Flow - If, While, For Each, Switch, Flowchart, State Machine (12 generators)
  • Data Operations - DataTable build, filter, sort, join, and LINQ operations (15 generators)
  • Integrations - Excel, Email, PDF, Database connectors (12 generators)
  • File System - Read, write, copy, move, and path operations (9 generators)
  • Error Handling - Try/Catch, Retry Scope, Throw, Rethrow (4 generators)

XAML Validation

The XAML Validator runs 71 deterministic lint rules against UiPath XAML files, specifically targeting patterns produced by LLM hallucinations.

  • Phantom Namespaces - Detects XML namespaces that do not correspond to real UiPath packages
  • Impossible Nesting - Catches activities placed inside containers that cannot host them
  • Fabricated Properties - Identifies property names that do not exist on the target activity
  • Naming Conventions - Enforces UiPath community naming standards for variables, arguments, and workflows
  • Variable Scoping - Validates that variables are declared in the correct scope and are not shadowed

Project Scaffolding

The Project Scaffolder creates production-ready UiPath project structures from three templates.

  • Sequence - Simple linear workflow with Main.xaml and project.json
  • REFramework Dispatcher - Queue population process with Init, GetTransactionData, Process, and End states
  • REFramework Performer - Transaction processing with retry logic, exception handling, and Config.xlsx

Security Best Practices

RPASkills.ai enforces enterprise security patterns across your UiPath automation estate.

  • Credential Guardian - Scans for hardcoded passwords and insecure credential handling
  • SecureString Enforcement - Ensures sensitive data uses SecureString types, not plain strings
  • GetRobotCredential Patterns - Validates that credentials are retrieved via Orchestrator APIs
  • Compliance Reporting - Generates audit-ready reports with severity rankings and remediation steps