# Send tper-hellobus to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - 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. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "tper-hellobus-skill", "name": "tper-hellobus", "source": "tencent", "type": "skill", "category": "通讯协作", "sourceUrl": "https://clawhub.ai/lore2601/tper-hellobus-skill", "canonicalUrl": "https://clawhub.ai/lore2601/tper-hellobus-skill", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/tper-hellobus-skill", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tper-hellobus-skill", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "README.md", "SKILL.md", "test-cases.json" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "tper-hellobus-skill", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-02T04:33:03.351Z", "expiresAt": "2026-05-09T04:33:03.351Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tper-hellobus-skill", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tper-hellobus-skill", "contentDisposition": "attachment; filename=\"tper-hellobus-skill-0.0.2.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "tper-hellobus-skill" }, "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/tper-hellobus-skill" }, "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." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/tper-hellobus-skill", "downloadUrl": "https://openagent3.xyz/downloads/tper-hellobus-skill", "agentUrl": "https://openagent3.xyz/skills/tper-hellobus-skill/agent", "manifestUrl": "https://openagent3.xyz/skills/tper-hellobus-skill/agent.json", "briefUrl": "https://openagent3.xyz/skills/tper-hellobus-skill/agent.md" } } ``` ## Documentation ### TPER Hellobus: Bologna & Ferrara Bus Times This skill provides real-time and scheduled arrival information for TPER buses in Bologna and Ferrara by querying the official Hellobus API. ### When to Use This Skill Use this skill when the user: Asks about bus arrivals at a specific stop in Bologna or Ferrara Mentions TPER, bus line numbers, or stop codes Wants to know when the next bus is coming Requests scheduled arrival times for a specific time Asks about real-time bus tracking ### How It Works The skill queries the TPER Hellobus API with three parameters: fermata (required): Numeric stop code (e.g., "4476", "8001") linea (required): Bus line number (e.g., "11", "27", "101") oraHHMM (optional): Time in HHmm format (e.g., "1830" for 6:30 PM) Critical Logic: If oraHHMM is omitted or empty, the API returns real-time GPS tracking data If oraHHMM is provided, the API returns scheduled arrivals for that time ### API Endpoint GET https://hellobuswsweb.tper.it/web-services/hellobus.asmx/QueryHellobus ### Parameters: fermata: Stop code (string, numeric) linea: Line number (string, numeric) oraHHMM: Time in HHmm format (string, optional - leave empty for real-time) ### Example API Calls: Real-time tracking (GPS): https://hellobuswsweb.tper.it/web-services/hellobus.asmx/QueryHellobus?fermata=4476&linea=11&oraHHMM= Scheduled times: https://hellobuswsweb.tper.it/web-services/hellobus.asmx/QueryHellobus?fermata=4476&linea=11&oraHHMM=1830 ### Response Format The API returns a response like: TperHellobus: 11B DaSatellite 18:02 (Bus1634 CON PEDANA), 11B DaSatellite 18:18 (Bus5504 CON PEDANA) Components: 11B: Line number with variant DaSatellite: Real-time GPS data indicator (or scheduled time indicator) 18:02: Arrival time Bus1634: Bus identifier CON PEDANA: Wheelchair accessible platform indicator ### 1. Parse User Input Extract from the user's query: Stop code: Numeric identifier (e.g., 4476) Line number: Numeric line (e.g., 11) Time (optional): If user mentions a specific time like "6:30 PM", "18:30", "at 3pm" ### 2. Convert Time Format If the user provides a time: Parse the time from natural language (e.g., "6:30 PM", "18:30", "3pm") Convert to HHmm format (e.g., "1830", "1500") Use Europe/Rome timezone for any timezone-related conversions Time conversion examples: "6:30 PM" → "1830" "3:00 PM" → "1500" "9:15 AM" → "0915" "18:30" → "1830" ### 3. Make API Request Use the bash_tool with curl to call the API (web_fetch has URL restrictions): # For real-time (no time specified): curl "https://hellobuswsweb.tper.it/web-services/hellobus.asmx/QueryHellobus?fermata={stop_code}&linea={line_number}&oraHHMM=" # For scheduled time: curl "https://hellobuswsweb.tper.it/web-services/hellobus.asmx/QueryHellobus?fermata={stop_code}&linea={line_number}&oraHHMM={time_hhmm}" Important: Ensure proper URL encoding and handle the XML/text response from the API. ### 4. Parse and Format Response The API response is plain text. Parse it and format as a bullet list: Input: TperHellobus: 11B DaSatellite 18:02 (Bus1634 CON PEDANA), 11B DaSatellite 18:18 (Bus5504 CON PEDANA) Output format: Bus arrivals for line 11 at stop 4476: • 11B DaSatellite 18:02 (Bus1634 CON PEDANA) • 11B DaSatellite 18:18 (Bus5504 CON PEDANA) Split on commas and present each arrival as a bullet point. ### 5. Error Handling If the API returns an error or unexpected response: Report the error clearly to the user Include the original API response if helpful for debugging Suggest checking the stop code and line number Common errors might include: Invalid stop code Line doesn't serve that stop No buses found for the specified time API connection issues ### User Interaction Examples Example 1: Real-time tracking User: "When is the next bus 11 arriving at stop 4476?" Claude: [Queries API with oraHHMM empty] Response: Bus arrivals for line 11 at stop 4476 (real-time): • 11B DaSatellite 18:02 (Bus1634 CON PEDANA) • 11B DaSatellite 18:18 (Bus5504 CON PEDANA) Example 2: Scheduled time User: "Check the schedule for bus 27 at stop 8001 for 6:30 PM" Claude: [Queries API with oraHHMM=1830] Response: Bus arrivals for line 27 at stop 8001 at 18:30: • 27 Orario 18:35 (Bus2045) • 27 Orario 18:50 (Bus3012) Example 3: Error handling User: "Bus 99 at stop 1234" Claude: [Queries API, receives error] Response: "I couldn't find bus 99 at stop 1234. Please verify the stop code and line number are correct for the TPER network." ### Important Notes Stop codes are numeric only (not stop names) Line numbers are numeric only (e.g., "11", not "11B" - the API adds variants) Empty oraHHMM = real-time GPS tracking Provided oraHHMM = scheduled arrivals Always use Europe/Rome timezone for time conversions Format times as HHmm (24-hour format, no colon) ### Testing Test cases to verify the skill works: Line 11, Stop 4476 (real-time) Line 11, Stop 4476, Time 18:30 (scheduled) Invalid stop code (error handling) Time format conversion (various user inputs) ## Trust - Source: tencent - Verification: Indexed source record - Publisher: lore2601 - Version: 0.0.2 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-02T04:33:03.351Z - Expires at: 2026-05-09T04:33:03.351Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/tper-hellobus-skill) - [Send to Agent page](https://openagent3.xyz/skills/tper-hellobus-skill/agent) - [JSON manifest](https://openagent3.xyz/skills/tper-hellobus-skill/agent.json) - [Markdown brief](https://openagent3.xyz/skills/tper-hellobus-skill/agent.md) - [Download page](https://openagent3.xyz/downloads/tper-hellobus-skill)