OpenParable
Skip to content
← Back to skills

Form Filling

Apps & Automation
form-filling

Form Filling is an Agent Skill for apps & automation published in the platonai/Browser4 repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Automatically fills web forms using provided field data and can optionally submit the form. Use when automating form input, testing forms, or submitting structured data to websites.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/platonai/Browser4/blob/HEAD/browser4-agentic/src/main/resources/skills/form-filling/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/form-filling, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Form Filling Skill

Description

Automatically fill web forms with provided data. This skill handles various form field types and can optionally submit the form after filling.

Dependencies

  • web-scraping - Required for detecting form fields and structure

Parameters

ParameterTypeRequiredDefaultDescription
urlStringYes-The URL of the page containing the form
formDataMap<String, String>Yes-Key-value pairs representing field names and values
submitBooleanNofalseWhether to submit the form after filling

Return Value

Returns a SkillResult with the following data structure:

{
  "url": "string",
  "filledFields": ["field1", "field2"],
  "submitted": boolean,
  "message": "status message"
}

Usage Examples

Basic Form Filling

val result = registry.execute(
    skillId = "form-filling",
    context = context,
    params = mapOf(
        "url" to "https://example.com/contact",
        "formData" to mapOf(
            "name" to "John Doe",
            "email" to "[email protected]",
            "message" to "Hello!"
        )
    )
)

Form Filling with Submission

val result = registry.execute(
    skillId = "form-filling",
    context = context,
    params = mapOf(
        "url" to "https://example.com/signup",
        "formData" to mapOf(
            "username" to "johndoe",
            "password" to "securepass123",
            "email" to "[email protected]"
        ),
        "submit" to true
    )
)

Tool Call Specification

ToolSpec(
    domain = "skill.form",
    method = "fill",
    arguments = [
        "url: String",
        "formData: Map<String, String>",
        "submit: Boolean = false"
    ],
    returnType = "SkillResult",
    description = "Fill a web form with the provided data"
)

Error Handling

The skill returns a failure result in the following cases:

  • Missing required parameter url
  • Missing required parameter formData
  • Empty formData map
  • Form fields not found on the page

Lifecycle Hooks

onBeforeExecute

Validates that formData is not empty before execution.

validate

Checks if the required dependency skill (web-scraping) is available in the registry.

Implementation Notes

  • Supports various input types: text, email, password, textarea, select, checkbox, radio
  • Automatically handles form field detection and mapping
  • Respects CSRF tokens and hidden fields
  • Can handle multi-page forms through shared context
  • Thread-safe execution

Security Considerations

  • Never log sensitive form data (passwords, credit cards, etc.)
  • Validate form URLs to prevent CSRF attacks
  • Use HTTPS URLs for sensitive forms
  • Clear sensitive data from memory after use

See Also