Form Filling

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

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 "john@example.com",
            "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 "john@example.com"
        ),
        "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

• Headless mode is the default for AI agents: Always open browsers in headless mode unless the user explicitly requests a visible browser window (e.g., "show me the browser", "open visibly", "headed"). Headless mode is faster, uses fewer resources, and avoids unnecessary GUI windows.
• 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

• Web Scraping Skill
• Data Validation Skill