formspec-mapping

Transform form response data into external schemas using a JSON mapping DSL.

4|2|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/Formspec-org/formspec --skill formspec-mapping
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: formspec-mapping
Source: https://github.com/Formspec-org/formspec/tree/main/.claude-plugin/skills/formspec-mapping/formspec-mapping
Command: npx skills add https://github.com/Formspec-org/formspec --skill formspec-mapping

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This mapping skill enables teams to declaratively write Mapping documents—the JSON DSL that transforms form response data to and from external schemas, enabling clean data exchange across systems.

Core Features & Use Cases

  • Declarative, bidirectional mappings between form data and external schemas (JSON, XML, CSV).
  • Support for common transform types (preserve, drop, valueMap, coerce, expression, constant, concat, split, flatten, nest) and conditional rules.
  • Real-world scenarios include syncing grant applications to backend APIs, normalizing field names, and bidirectional data synchronization with external services.

Quick Start

Create a mapping.json following the defined schema and run the MappingEngine in Python to apply forward transformations.

Frequently Asked Questions about formspec-mapping

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I map JSON form data to an external API schema?

You can map JSON form data to an external API schema by creating a declarative mapping document and running the Python MappingEngine to apply forward transformations for clean data exchange.

What is bidirectional JSON mapping for data integration?

Bidirectional JSON mapping is a declarative DSL that transforms form response data to and from external schemas, enabling two-way data synchronization across systems with optional reverse mappings.

Can I drop or coerce form fields during ETL data normalization?

Yes, you can drop or coerce form fields during ETL data normalization by applying supported transform types like preserve, drop, coerce, valueMap, and expression within your mapping rules.

Does this JSON mapping DSL support conditional rules and error handling?

Yes, the JSON mapping DSL supports condition guards for rule execution and configurable error handling to manage data normalization scenarios across systems safely.

What is the best way to sync grant application forms to a backend API?

The best way to sync grant applications to a backend API is using a declarative JSON mapping document with transforms like concat, split, flatten, and nest to normalize fields before exchange.