remote-api-forms
Build and validate request bodies for Remote.com's dynamic JSON-Schema form endpoints - the schema-first mechanism behind most REST writes. Use when fetching a form schema (GET /v1/countries/{country_code}/{form}, /v1/companies/schema, /v1/contract-amendments/schema, and similar), honoring required/enum/oneOf/if-then-else, handling conditionally-forbidden fields or x-jsf-* presentation/currency, or 422 validation on any form-driven write - company creation, personal-details, contract amendments, terminations, contractor onboarding, legal-entity details, benefits. For the multi-form hire sequence use remote-api-onboarding. Do NOT use to operate via the MCP, for auth (remote-api-auth), endpoint discovery (remote-api-integration), or webhooks (remote-api-webhooks).
Install
With your agent
Install OMGSkills skill "remoteoss/remote-for-ai:skills/remote-api-forms" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/remoteoss/remote-for-ai /tmp/remote-for-ai && ln -s /tmp/remote-for-ai/skills/remote-api-forms ~/.claude/skills/remote-api-formsFrom README
Remote API Forms Build and submit request bodies for Remote.com's dynamic JSON-Schema form endpoints. Most Remote write operations do not accept a fixed field list — the required and optional fields are determined at runtime by a JSON Schema that varies by country, employment type, and regulatory context. This skill covers the full cycle: find the right schema endpoint, fetch the schema, build a conforming body, submit it, and handle 422 validation errors. Invoke This Skill When Creating or updating any resource that uses a country, company, or resource-specific form (employment, contractor, contract amendment, termination, company creation, personal details). Building or validating a request body for an onboarding, contract, company, personal-details, or termination write. Implementing a UI for Remote JSON Schema forms, including rendering fields, visibility, required state, conditionals, computed attributes, or client-side validation.
More from this repo
remote-api-auth
Authenticate to the Remote.com REST API and obtain access tokens for an integration.
remote-api-integration
Used to build integrations that call the Remote.com REST API (developer.remote.com) - global HR/payroll/EOR.
remote-api-webhooks
Receive and verify Remote.com webhooks in an integration.