Agent Skills provide compatible AI coding agents with packaged knowledge about how to work with WS Form. They help an agent understand the product, choose the appropriate native functionality, and follow recommended workflows when building or modifying forms.

The official WS Form Agent Skills repository is available at github.com/wsform/skills.

There is currently one skill available, named ws-form.

What Are WS Form Agent Skills?

WS Form Agent Skills are designed for AI coding agents that support the Agent Skills specification.

Compatible agents can load the ws-form skill to learn how WS Form works and how it should be used.

The skill provides knowledge and workflow guidance covering areas such as native functionality, preferred workflows, architectural decisions, common pitfalls, and best practices.

For example, the skill teaches an agent to prefer native WS Form functionality instead of unnecessarily writing custom PHP or JavaScript.

Agent Skills provide guidance only. They do not execute operations on a form or WordPress site by themselves.

Agent Skills, Abilities, And MCP

Agent Skills, WS Form Abilities, and the WS Form MCP Server perform different roles.

These components are designed to complement each other.

The ws-form skill helps the agent decide what it should do. Abilities and MCP provide the executable capabilities needed to make those changes when connected to a WordPress site.

For example, an agent can use the skill to determine the appropriate native WS Form approach for a task, then use MCP to inspect the existing form and make the required changes.

Agent Skills are not a replacement for Abilities or MCP.

Prerequisites

To use the WS Form Agent Skill, you need an AI coding agent that supports the Agent Skills format.

Examples of compatible coding agents include Cursor and Claude Code. Other agents that support Agent Skills can also use the repository.

If you only want the agent to use WS Form knowledge while helping with development, you do not need to connect it to a WordPress site.

If you want the agent to inspect or modify forms on a WordPress installation, you will also need WS Form installed on that site and an appropriate Abilities or MCP connection.

See MCP Server for information about connecting an AI client to WS Form.

Installing The WS Form Skill

The official skill can be installed from the WS Form Skills GitHub repository using the Vercel Skills CLI.

1. Open a terminal in the environment where you use your AI coding agent.
2. Run the following command:

npx skills add wsform/skills --skill ws-form

The CLI installs the ws-form skill for use by supported agents.

List Available Skills

You can list the skills available in the repository without installing them by running:

npx skills add wsform/skills --list

There is currently one official skill:

• ws-form

What The ws-form Skill Covers

The ws-form skill gives compatible agents guidance for working with WS Form across common form-building and administration tasks.

It helps agents:

• Build and modify forms using native WS Form functionality.
• Select appropriate field types.
• Work with sections, tabs, and layouts.
• Configure Conditional Logic.
• Work with calculations.
• Configure actions and integrations.
• Work with submissions.
• Use validation correctly.
• Use spam protection correctly.
• Style forms using supported WS Form mechanisms.
• Troubleshoot forms and submissions.
• Use WS Form Abilities and MCP effectively.
• Avoid unnecessary custom PHP and JavaScript.

The skill also provides WS Form-specific terminology and conventions.

For example, repeatable rows in WS Form are implemented using repeatable sections. WS Form does not use a repeater field.

It also teaches agents that email notifications are configured using Send Email actions rather than form settings, and uses terminology such as Field ID 123 when referring to a field by ID.

Using Agent Skills With MCP And Abilities

For the most complete AI-assisted workflow, you can use the ws-form skill together with the WS Form MCP Server and WS Form Abilities.

The skill provides the knowledge. Abilities and MCP provide the executable capabilities.

A typical workflow is:

1. Install the ws-form skill so your agent understands WS Form workflows and best practices.
2. Connect your AI client to WS Form using MCP if you want it to work with forms on a WordPress site.
3. Ask the agent to inspect the existing form before making changes.
4. Use the skill’s guidance to determine the appropriate native WS Form solution.
5. Use the available Abilities through MCP to make the required changes.
6. Review the changes before publishing or using the form on a live site.

You do not need to duplicate the MCP configuration when installing the skill. The skill and MCP connection are separate components.

For MCP setup, authentication, and supported capabilities, see MCP Server.

Working Safely With AI Form Editing

When allowing an AI agent to modify forms, we recommend working on a staging site rather than a production site and reviewing all changes before publishing them.

New forms created through Abilities are created as drafts. You must publish the form before embedding it on a live page.

Form editing through AI is disabled by default. To enable it:

1. Go to WS Form → Settings → AI.
2. Enable Allow Updates.

Deleting forms or other supported resources requires Allow Deletes, which is also disabled by default.

Only enable the permissions your AI client needs.

Using The Skill Effectively

Install the ws-form skill whenever you want a compatible AI coding agent to help with WS Form development. This gives the agent product-specific context before it starts proposing solutions.

If the agent also needs to inspect or change forms on a WordPress site, connect it to the WS Form MCP Server.

Where possible, have the agent inspect an existing form before modifying it. This gives it the context it needs to work with the existing fields, sections, actions, Conditional Logic, calculations, and other configuration.

Prefer native WS Form functionality wherever possible. Custom PHP or JavaScript should generally only be considered when the required behavior cannot be achieved using supported WS Form features.

MCP can be used with both WS Form LITE and WS Form PRO. Available field types and some capabilities differ by edition. See MCP Server for information about field-type scope.