Installation

Open Claude Code and run this command:

/plugin install remofirst-pack@claude-code-plugins-plus

Use --global to install for all projects, or --project for current project only.

What It Does

> Claude Code skill pack for RemoFirst — global HR, Employer of Record (EOR), payroll, and compliance management (12 skills)

Skills (12)

remofirst-common-errors SKILL.md View full skill →

"RemoFirst common errors \u2014 global HR, EOR, and payroll platform\.

ReadWriteEditBash(npm:*)Bash(curl:*)Grep

remofirst-core-workflow-a SKILL.md View full skill →

"RemoFirst core workflow a \u2014 global HR, EOR, and payroll platform\.

ReadWriteEditBash(npm:*)Bash(curl:*)Grep

RemoFirst Core Workflow A

Overview

Employee onboarding workflow: create employee records, manage documents, handle country-specific compliance requirements.

Prerequisites

Completed remofirst-install-auth

Instructions

Step 1: Create Employee Record


employee = client.post("/employees", {
    "first_name": "Alice",
    "last_name": "Johnson",
    "email": "alice@company.com",
    "country_code": "GB",  # United Kingdom
    "job_title": "Senior Engineer",
    "start_date": "2026-05-01",
    "salary": {
        "amount": 85000,
        "currency": "GBP",
        "frequency": "annual",
    },
    "employment_type": "full_time",
})
print(f"Employee created: {employee['id']}")

Step 2: Check Country Requirements


# Get country-specific onboarding requirements
requirements = client.get(f"/countries/GB/requirements")
for req in requirements["documents"]:
    print(f"  Required: {req['name']} — {req['description']}")
    # Examples: Passport, National Insurance Number, Bank Details, P45

Step 3: Submit Onboarding Documents


# Upload required documents
client.post(f"/employees/{employee['id']}/documents", {
    "document_type": "passport",
    "file_url": "https://secure-storage.com/passport.pdf",
    "expiry_date": "2030-12-31",
})

Step 4: Track Onboarding Status


status = client.get(f"/employees/{employee['id']}/onboarding")
print(f"Onboarding status: {status['status']}")  # pending, in_progress, completed
for step in status["steps"]:
    print(f"  {step['name']}: {step['status']}")

Output

Employee record created with salary and country
Country-specific requirements checked
Documents uploaded for compliance
Onboarding progress tracked

Error Handling

Error	Cause	Solution
`422 Invalid country`	Unsupported country code	Check supported countries list
`422 Missing required field`	Country-specific field missing	Check country requirements first
Onboarding stuck	Missing documents	Upload all required documents

Resources

RemoFirst

remofirst-core-workflow-b SKILL.md View full skill →

"RemoFirst core workflow b \u2014 global HR, EOR, and payroll platform\.

ReadWriteEditBash(npm:*)Bash(curl:*)Grep

RemoFirst Core Workflow B

Overview

Payroll workflow: process payroll runs, manage benefits, handle multi-currency payments, and generate invoices.

Prerequisites

Completed remofirst-core-workflow-a (employee onboarding)

Instructions

Step 1: Get Payroll Summary


payroll = client.get("/payroll", params={
    "month": "2026-03",
    "country_code": "GB",
})
print(f"Payroll for {payroll['period']}:")
print(f"  Employees: {payroll['employee_count']}")
print(f"  Total gross: {payroll['currency']} {payroll['total_gross']}")
print(f"  Total employer cost: {payroll['currency']} {payroll['total_employer_cost']}")

Step 2: Review Employee Payslip


payslip = client.get(f"/employees/{employee_id}/payslips", params={"month": "2026-03"})
print(f"Gross: {payslip['gross_salary']}")
print(f"Deductions: {payslip['total_deductions']}")
print(f"  Tax: {payslip['income_tax']}")
print(f"  National Insurance: {payslip['social_security']}")
print(f"Net pay: {payslip['net_salary']}")

Step 3: Manage Benefits


benefits = client.get(f"/employees/{employee_id}/benefits")
for benefit in benefits:
    print(f"  {benefit['type']}: {benefit['provider']} — {benefit['status']}")
    # Types: health_insurance, pension, dental, vision

# Add benefit
client.post(f"/employees/{employee_id}/benefits", {
    "type": "health_insurance",
    "plan": "premium",
    "start_date": "2026-04-01",
})

Step 4: Generate Invoice


invoice = client.get("/invoices/current")
print(f"Invoice #{invoice['number']}")
print(f"  Period: {invoice['period']}")
print(f"  Total: {invoice['currency']} {invoice['total']}")
print(f"  Due date: {invoice['due_date']}")

Output

Payroll summary with gross/net calculations
Employee payslips with tax breakdowns
Benefits enrollment and management
Invoice generation and tracking

Error Handling

Error Cause Solution

Payroll not ready Missing employee data Complete onboarding first

Currency mismatch Wrong country payroll Check country_code filter

Benefits unavailable

Country not supported

Check country benefit opt

remofirst-debug-bundle SKILL.md View full skill →

"RemoFirst debug bundle \u2014 global HR, EOR, and payroll platform integration.

ReadWriteEditBash(npm:*)Bash(curl:*)Grep

remofirst-hello-world SKILL.md View full skill →

"RemoFirst hello world \u2014 global HR, EOR, and payroll platform integration.

ReadWriteEditBash(npm:*)Bash(curl:*)Grep

remofirst-install-auth SKILL.md View full skill →

"RemoFirst install auth \u2014 global HR, EOR, and payroll platform integration.

ReadWriteEditBash(npm:*)Bash(curl:*)Grep

remofirst-local-dev-loop SKILL.md View full skill →

"RemoFirst local dev loop \u2014 global HR, EOR, and payroll platform\.

ReadWriteEditBash(npm:*)Bash(curl:*)Grep

remofirst-prod-checklist SKILL.md View full skill →

"RemoFirst prod checklist \u2014 global HR, EOR, and payroll platform\.

ReadWriteEditBash(npm:*)Bash(curl:*)Grep

remofirst-rate-limits SKILL.md View full skill →

"RemoFirst rate limits \u2014 global HR, EOR, and payroll platform integration.

ReadWriteEditBash(npm:*)Bash(curl:*)Grep

remofirst-sdk-patterns SKILL.md View full skill →

"RemoFirst sdk patterns \u2014 global HR, EOR, and payroll platform integration.

ReadWriteEditBash(npm:*)Bash(curl:*)Grep

remofirst-security-basics SKILL.md View full skill →

"RemoFirst security basics \u2014 global HR, EOR, and payroll platform\.

ReadWriteEditBash(npm:*)Bash(curl:*)Grep

remofirst-upgrade-migration SKILL.md View full skill →

"RemoFirst upgrade migration \u2014 global HR, EOR, and payroll platform\.

ReadWriteEditBash(npm:*)Bash(curl:*)Grep

Error	Cause	Solution
401 Unauthorized	Invalid API key	Contact RemoFirst support
429 Rate Limited	Too many requests	Implement backoff
422 Validation Error	Missing required field	Check API documentation

remofirst-pack

Installation

What It Does

Skills (12)

RemoFirst Common Errors

Overview

Prerequisites

Instructions

Step 1: API Pattern

Output

Error Handling

Resources

Next Steps

RemoFirst Core Workflow A

Overview

Prerequisites

Instructions

Step 1: Create Employee Record

Step 2: Check Country Requirements

Step 3: Submit Onboarding Documents

Step 4: Track Onboarding Status

Output

Error Handling

Resources

RemoFirst Core Workflow B

Overview

Prerequisites

Instructions

Step 1: Get Payroll Summary

Step 2: Review Employee Payslip

Step 3: Manage Benefits

Step 4: Generate Invoice

Output

Error Handling

RemoFirst Debug Bundle

Overview

Prerequisites

Instructions

Step 1: API Pattern

Output

Error Handling

Resources

Next Steps

RemoFirst Hello World

Overview

Prerequisites

Instructions

Step 1: API Pattern

Output

Error Handling

Resources

Next Steps

RemoFirst Install Auth

Overview

Prerequisites

Instructions

Step 1: Get API Credentials

Step 2: Configure Environment

Step 3: Initialize Client

Step 4: Verify Connection

Output

Error Handling

Resources

Next Steps

RemoFirst Local Dev Loop

Overview

Prerequisites

Instructions

Step 1: API Pattern

Output

Error Handling

Resources

Next Steps

RemoFirst Prod Checklist

Overview

Prerequisites

Instructions

Step 1: API Pattern

Output

Error Handling