{
"schemaVersion": "1.0",
"item": {
"slug": "formpass-submit",
"name": "FormPass Submit",
"source": "tencent",
"type": "skill",
"category": "通讯协作",
"sourceUrl": "https://clawhub.ai/jezjsa/formpass-submit",
"canonicalUrl": "https://clawhub.ai/jezjsa/formpass-submit",
"targetPlatform": "OpenClaw"
},
"install": {
"downloadMode": "redirect",
"downloadUrl": "/downloads/formpass-submit",
"sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=formpass-submit",
"sourcePlatform": "tencent",
"targetPlatform": "OpenClaw",
"installMethod": "Manual import",
"extraction": "Extract archive",
"prerequisites": [
"OpenClaw"
],
"packageFormat": "ZIP package",
"includedAssets": [
"SKILL.md"
],
"primaryDoc": "SKILL.md",
"quickSetup": [
"Download the package from Yavira.",
"Extract the archive and review SKILL.md first.",
"Import or place the package into your OpenClaw setup."
],
"agentAssist": {
"summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
"steps": [
"Download the package from Yavira.",
"Extract it into a folder your agent can access.",
"Paste one of the prompts below and point your agent at the extracted folder."
],
"prompts": [
{
"label": "New install",
"body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
},
{
"label": "Upgrade existing",
"body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
}
]
},
"sourceHealth": {
"source": "tencent",
"slug": "formpass-submit",
"status": "healthy",
"reason": "direct_download_ok",
"recommendedAction": "download",
"checkedAt": "2026-04-30T03:19:38.493Z",
"expiresAt": "2026-05-07T03:19:38.493Z",
"httpStatus": 200,
"finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=formpass-submit",
"contentType": "application/zip",
"probeMethod": "head",
"details": {
"probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=formpass-submit",
"contentDisposition": "attachment; filename=\"formpass-submit-1.0.0.zip\"",
"redirectLocation": null,
"bodySnippet": null,
"slug": "formpass-submit"
},
"scope": "item",
"summary": "Item download looks usable.",
"detail": "Yavira can redirect you to the upstream package for this item.",
"primaryActionLabel": "Download for OpenClaw",
"primaryActionHref": "/downloads/formpass-submit"
},
"validation": {
"installChecklist": [
"Use the Yavira download entry.",
"Review SKILL.md after the package is downloaded.",
"Confirm the extracted package contains the expected setup assets."
],
"postInstallChecks": [
"Confirm the extracted package includes the expected docs or setup files.",
"Validate the skill or prompts are available in your target agent workspace.",
"Capture any manual follow-up steps the agent could not complete."
]
},
"downloadPageUrl": "https://openagent3.xyz/downloads/formpass-submit",
"agentPageUrl": "https://openagent3.xyz/skills/formpass-submit/agent",
"manifestUrl": "https://openagent3.xyz/skills/formpass-submit/agent.json",
"briefUrl": "https://openagent3.xyz/skills/formpass-submit/agent.md"
},
"agentAssist": {
"summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
"steps": [
"Download the package from Yavira.",
"Extract it into a folder your agent can access.",
"Paste one of the prompts below and point your agent at the extracted folder."
],
"prompts": [
{
"label": "New install",
"body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
},
{
"label": "Upgrade existing",
"body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
}
]
},
"documentation": {
"source": "clawhub",
"primaryDoc": "SKILL.md",
"sections": [
{
"title": "FormPass — Discover & Submit to Forms",
"body": "FormPass is the identity and trust layer for AI agents submitting to web forms. Instead of scraping HTML and guessing field names, you get a structured API with schema validation and authenticated submissions.\n\nUse this skill when the user asks you to:\n\nFill out or submit a web form\nApply to something via a form\nSend a contact/enquiry/signup form\nInteract with any FormPass-enabled form"
},
{
"title": "How It Works",
"body": "FormPass forms expose a three-step flow: detect → schema → submit."
},
{
"title": "Step 1: Detect a FormPass Form",
"body": "When visiting a web page, look for these meta tags in the HTML :\n\n\n\n\nIf you find them, extract the formpass-form-id value — that's the Form ID.\n\nYou can also check these discovery endpoints:\n\n# Machine-readable discovery\ncurl -s https://form-pass.com/formpass.json | jq .\n\n# LLM-friendly guide\ncurl -s https://form-pass.com/llms.txt"
},
{
"title": "Step 2: Get the Form Schema",
"body": "Fetch the form's field definitions before submitting. This tells you exactly what fields exist, which are required, and what types they expect.\n\ncurl -s \"https://form-pass.com/api/forms/FORM_ID/schema\" \\\n -H \"Accept: application/json\" | jq .\n\nResponse:\n\n{\n \"formId\": \"abc123\",\n \"name\": \"Contact Form\",\n \"description\": \"Get in touch with us\",\n \"agentAccessible\": true,\n \"fields\": [\n {\n \"name\": \"name\",\n \"label\": \"Full Name\",\n \"type\": \"text\",\n \"required\": true,\n \"placeholder\": \"John Doe\"\n },\n {\n \"name\": \"email\",\n \"label\": \"Email Address\",\n \"type\": \"email\",\n \"required\": true,\n \"placeholder\": \"john@example.com\"\n },\n {\n \"name\": \"message\",\n \"label\": \"Message\",\n \"type\": \"textarea\",\n \"required\": false,\n \"placeholder\": \"How can we help?\"\n }\n ],\n \"branding\": {\n \"required\": true,\n \"text\": \"Powered by FormPass\",\n \"url\": \"https://form-pass.com\"\n }\n}\n\nImportant: If agentAccessible is false, the form owner has disabled agent submissions. Do not attempt to submit."
},
{
"title": "Step 3: Submit to the Form",
"body": "POST your data as JSON. Include your Agent ID as a Bearer token if you have one (this identifies you as a verified agent).\n\ncurl -s -X POST \"https://form-pass.com/api/submit/FORM_ID\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer YOUR_AGENT_ID\" \\\n -d '{\n \"name\": \"Agent Smith\",\n \"email\": \"agent@example.com\",\n \"message\": \"Hello from an AI agent\",\n \"_fp_branding\": true\n }' | jq .\n\nSuccess response:\n\n{\n \"success\": true,\n \"submissionId\": \"jh72...\"\n}"
},
{
"title": "Required Headers",
"body": "HeaderValueRequiredContent-Typeapplication/jsonYesAuthorizationBearer fpagent_XXXXRecommended"
},
{
"title": "The _fp_branding Field",
"body": "If the schema response includes branding.required: true, you must include \"_fp_branding\": true in your submission body. Without it the API returns 402."
},
{
"title": "Agent ID",
"body": "Your Agent ID (format: fpagent_XXXX) is issued when you register at FormPass. It verifies your identity to form owners. Submissions without an Agent ID are recorded as anonymous/human.\n\nTo get an Agent ID, register at: https://form-pass.com/dashboard/agents/new"
},
{
"title": "Error Responses",
"body": "StatusMeaning200Success — submission recorded402Branding required — add _fp_branding: true to your body404Form not found or inactive422Validation error — check required fields\n\nThe 422 response includes a fields array listing which fields failed validation."
},
{
"title": "Full Example: Detect and Submit",
"body": "# 1. You've found a page with formpass-form-id=\"abc123\"\nFORM_ID=\"abc123\"\nHOST=\"https://form-pass.com\"\n\n# 2. Get the schema\nSCHEMA=$(curl -s \"$HOST/api/forms/$FORM_ID/schema\")\necho \"$SCHEMA\" | jq '.fields[] | {name, type, required}'\n\n# 3. Build and submit your data\ncurl -s -X POST \"$HOST/api/submit/$FORM_ID\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer fpagent_your_id_here\" \\\n -d '{\n \"name\": \"Your Name\",\n \"email\": \"you@example.com\",\n \"message\": \"Submitted via OpenClaw agent\",\n \"_fp_branding\": true\n }' | jq ."
},
{
"title": "Tips",
"body": "Always fetch the schema first — field names and requirements can change.\nInclude your Agent ID to build trust with form owners. Anonymous submissions may be rejected.\nIf the schema shows agentAccessible: false, respect it and do not submit.\nThe _fp_branding field is stripped before data is stored — it's only for validation.\nFormPass is a growing network. More forms are joining daily. Check any web form for the detection meta tags."
}
],
"body": "FormPass — Discover & Submit to Forms\n\nFormPass is the identity and trust layer for AI agents submitting to web forms. Instead of scraping HTML and guessing field names, you get a structured API with schema validation and authenticated submissions.\n\nUse this skill when the user asks you to:\n\nFill out or submit a web form\nApply to something via a form\nSend a contact/enquiry/signup form\nInteract with any FormPass-enabled form\nHow It Works\n\nFormPass forms expose a three-step flow: detect → schema → submit.\n\nStep 1: Detect a FormPass Form\n\nWhen visiting a web page, look for these meta tags in the HTML :\n\n\n\n\n\nIf you find them, extract the formpass-form-id value — that's the Form ID.\n\nYou can also check these discovery endpoints:\n\n# Machine-readable discovery\ncurl -s https://form-pass.com/formpass.json | jq .\n\n# LLM-friendly guide\ncurl -s https://form-pass.com/llms.txt\n\nStep 2: Get the Form Schema\n\nFetch the form's field definitions before submitting. This tells you exactly what fields exist, which are required, and what types they expect.\n\ncurl -s \"https://form-pass.com/api/forms/FORM_ID/schema\" \\\n -H \"Accept: application/json\" | jq .\n\n\nResponse:\n\n{\n \"formId\": \"abc123\",\n \"name\": \"Contact Form\",\n \"description\": \"Get in touch with us\",\n \"agentAccessible\": true,\n \"fields\": [\n {\n \"name\": \"name\",\n \"label\": \"Full Name\",\n \"type\": \"text\",\n \"required\": true,\n \"placeholder\": \"John Doe\"\n },\n {\n \"name\": \"email\",\n \"label\": \"Email Address\",\n \"type\": \"email\",\n \"required\": true,\n \"placeholder\": \"john@example.com\"\n },\n {\n \"name\": \"message\",\n \"label\": \"Message\",\n \"type\": \"textarea\",\n \"required\": false,\n \"placeholder\": \"How can we help?\"\n }\n ],\n \"branding\": {\n \"required\": true,\n \"text\": \"Powered by FormPass\",\n \"url\": \"https://form-pass.com\"\n }\n}\n\n\nImportant: If agentAccessible is false, the form owner has disabled agent submissions. Do not attempt to submit.\n\nStep 3: Submit to the Form\n\nPOST your data as JSON. Include your Agent ID as a Bearer token if you have one (this identifies you as a verified agent).\n\ncurl -s -X POST \"https://form-pass.com/api/submit/FORM_ID\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer YOUR_AGENT_ID\" \\\n -d '{\n \"name\": \"Agent Smith\",\n \"email\": \"agent@example.com\",\n \"message\": \"Hello from an AI agent\",\n \"_fp_branding\": true\n }' | jq .\n\n\nSuccess response:\n\n{\n \"success\": true,\n \"submissionId\": \"jh72...\"\n}\n\nRequired Headers\nHeader\tValue\tRequired\nContent-Type\tapplication/json\tYes\nAuthorization\tBearer fpagent_XXXX\tRecommended\nThe _fp_branding Field\n\nIf the schema response includes branding.required: true, you must include \"_fp_branding\": true in your submission body. Without it the API returns 402.\n\nAgent ID\n\nYour Agent ID (format: fpagent_XXXX) is issued when you register at FormPass. It verifies your identity to form owners. Submissions without an Agent ID are recorded as anonymous/human.\n\nTo get an Agent ID, register at: https://form-pass.com/dashboard/agents/new\n\nError Responses\nStatus\tMeaning\n200\tSuccess — submission recorded\n402\tBranding required — add _fp_branding: true to your body\n404\tForm not found or inactive\n422\tValidation error — check required fields\n\nThe 422 response includes a fields array listing which fields failed validation.\n\nFull Example: Detect and Submit\n# 1. You've found a page with formpass-form-id=\"abc123\"\nFORM_ID=\"abc123\"\nHOST=\"https://form-pass.com\"\n\n# 2. Get the schema\nSCHEMA=$(curl -s \"$HOST/api/forms/$FORM_ID/schema\")\necho \"$SCHEMA\" | jq '.fields[] | {name, type, required}'\n\n# 3. Build and submit your data\ncurl -s -X POST \"$HOST/api/submit/$FORM_ID\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer fpagent_your_id_here\" \\\n -d '{\n \"name\": \"Your Name\",\n \"email\": \"you@example.com\",\n \"message\": \"Submitted via OpenClaw agent\",\n \"_fp_branding\": true\n }' | jq .\n\nTips\nAlways fetch the schema first — field names and requirements can change.\nInclude your Agent ID to build trust with form owners. Anonymous submissions may be rejected.\nIf the schema shows agentAccessible: false, respect it and do not submit.\nThe _fp_branding field is stripped before data is stored — it's only for validation.\nFormPass is a growing network. More forms are joining daily. Check any web form for the detection meta tags."
},
"trust": {
"sourceLabel": "tencent",
"provenanceUrl": "https://clawhub.ai/jezjsa/formpass-submit",
"publisherUrl": "https://clawhub.ai/jezjsa/formpass-submit",
"owner": "jezjsa",
"version": "1.0.0",
"license": null,
"verificationStatus": "Indexed source record"
},
"links": {
"detailUrl": "https://openagent3.xyz/skills/formpass-submit",
"downloadUrl": "https://openagent3.xyz/downloads/formpass-submit",
"agentUrl": "https://openagent3.xyz/skills/formpass-submit/agent",
"manifestUrl": "https://openagent3.xyz/skills/formpass-submit/agent.json",
"briefUrl": "https://openagent3.xyz/skills/formpass-submit/agent.md"
}
}