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

Parameter	Type	Required	Default	Description
url	String	Yes	-	The URL of the page containing the form
formData	Map<String, String>	Yes	-	Key-value pairs representing field names and values
submit	Boolean	No	false	Whether 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