Form Filling
Apps & Automationform-fillingForm 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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
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
| 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
formDatamap - 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