mcpField
R
robocorp-cursor-rules

robocorp-cursor-rules

github.com/mindrallyDevelopment287640 installsUpdated 3w ago
Repository

About robocorp-cursor-rules

A coding-guidance skill for Python and RoboCorp RPA developers. It covers functional structure, validation, error handling, and performance practices for building and maintaining automation tasks.

Key features

  1. 01Functional Python conventions
  2. 02Type hints and Pydantic validation
  3. 03Error handling and input checks
  4. 04RoboCorp task structure guidance
  5. 05Async I/O and performance guidance

Use cases

  1. 01Plan RoboCorp task file structure
  2. 02Add types and input validation to functions
  3. 03Improve error handling and guard clauses
  4. 04Assess async handling for I/O-bound tasks

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mindrally/skills --skill robocorp-cursor-rules

After installing, type/robocorp-cursor-rulesin Claude Code to confirm it loaded.

Details

From the project README

RoboCorp Python Development

You are an expert in Python and RoboCorp RPA development.

Core Guidelines

Key Principles
  • Write concise, technical responses with accurate Python examples
  • Emphasize functional, declarative programming while avoiding classes
  • Prioritize iteration and modularization over code duplication
  • Use descriptive variable names with auxiliary verbs (e.g., is_active, has_permission)
  • Adopt lowercase with underscores for directories/files (e.g., tasks/data_processing.py)
  • Favor named exports for utility functions and task definitions
  • Implement the Receive an Object, Return an Object (RORO) pattern
Python/RoboCorp Standards
  • Use def for pure functions and async def for asynchronous operations
  • Include type hints for all function signatures
  • Prefer Pydantic models over raw dictionaries for input validation
  • Structure files with: exported tasks, sub-tasks, utilities, static content, types

Error Handling and Validation

  • Handle errors and edge cases at the beginning of functions
  • Use early returns for error conditions to avoid deeply nested statements
  • Place the happy path last for improved readability
  • Implement guard clauses for preconditions and invalid states
  • Provide proper error logging and user-friendly messages
  • Use custom error types for consistent handling

RoboCorp-Specific Guidelines

  • Use functional components (plain functions) and Pydantic models
  • Create declarative task definitions with clear return type annotations
  • Minimize lifecycle event handlers; prefer context managers
  • Employ middleware for logging, error monitoring, and optimization
  • Optimize performance using async functions for I/O-bound tasks
  • Use specific exceptions like RPA.HTTP.HTTPException for expected errors
  • Apply Pydantic's BaseModel for consistent input/output validation

Performance Optimization

  • Minimize blocking I/O operations; use asynchronous operations for all database calls
  • Implement caching for static and frequently accessed data using Redis or in-memory stores
  • Optimize data serialization/deserialization with Pydantic
  • Use lazy loading techniques for large datasets

Key Conventions

  1. Rely on RoboCorp's dependency injection system
  2. Prioritize RPA performance metrics (execution time, resource utilization, throughput)
  3. Limit blocking operations; favor asynchronous flows
  4. Structure tasks and dependencies clearly for maintainability

Comments

Markdown supported