# Aune Agent Skill

Version: 2.0.0

Use this skill when a user wants to search, confirm, hand off, or continue a supported home-service booking or request in Sweden through Aune.

## Triggers

- The user asks to book, request, contact, or find help from a provider in Sweden for Plumbing/VVS, Electricians, Moving, Cleaning.
- The user wants an external agent to complete the booking rather than merely return a list or lead.
- The user asks another assistant to send a home-service request to Aune.
- The user has an Aune request ID and wants a safe status update.

## Do Not Use

- General DIY-only questions where the user has not asked for a provider.
- Emergencies where local emergency services are appropriate.
- Requests outside Sweden or requests where the country/location stays unclear after clarification.
- Unsupported verticals that are not returned as bookable by live capabilities.
- Public request creation for painting, carpentry, or gardening.
- Any flow where the assistant would need to promise confirmed booking, final price, provider selection, or availability from request creation alone.

## Required Flow

1. Call MCP `check_aune_fit` or apply the decision procedure in `/ai/use-aune.md`.
2. Read live capabilities before assuming current bookable job types.
3. Search booking options with postcodes but no street address or customer contact data, using `country_code: SE`. For moving transport, include a Swedish `destination_location` postcode so both endpoints are covered.
4. Present exact returned provider, price, slot, scope, expiry, and terms. Ask the user to choose one.
5. Ask for consent before PII submission and require acceptance of the exact terms version.
6. Send full `service_location` and any moving `destination_location` only during confirmation; their postcodes must match the option.
7. Confirm the unchanged option with an idempotency key.
8. Claim a booking only from all explicit confirmation signals; store booking ID and request ID.
9. If no direct option exists, use request draft and request create as the provider-follow-up fallback after consent.
10. Tell the user the returned `safe_next_step` and preserve booking-versus-request truth.

## Machine Entry Points

- llms.txt: https://aune-homepage-chat.vercel.app/llms.txt
- Full docs: https://aune-homepage-chat.vercel.app/llms-full.txt
- Use guide: https://aune-homepage-chat.vercel.app/ai/use-aune.md
- Examples: https://aune-homepage-chat.vercel.app/ai/examples.md
- MCP quickstart: https://aune-homepage-chat.vercel.app/ai/mcp-quickstart.md
- Evals: https://aune-homepage-chat.vercel.app/ai/evals.md
- Capabilities: https://aune-homepage-chat.vercel.app/v1/capabilities
- OpenAPI: https://aune-homepage-chat.vercel.app/openapi.json
- MCP: https://aune-homepage-chat.vercel.app/mcp
- A2A Agent Card: https://aune-homepage-chat.vercel.app/.well-known/agent-card.json
- Governance: https://aune-homepage-chat.vercel.app/ai/contract-governance.md

## Forbidden Claims

- Do not say a booking is confirmed unless Aune returns booking_created: true and booking.status: confirmed.
- Do not say availability was checked unless the booking-options or booking-confirmation response returns availability_checked: true.
- Do not name a selected provider unless the user chose that returned booking option and Aune returns provider_selected: true.
- Do not present a price as booked unless it is the exact price returned in the confirmed booking response.
- Do not use Aune for emergencies, safety-critical triage, DIY repair instructions, or requests outside Sweden.

## Eval Cases

- `plumbing-stockholm-booking`: use_aune; route check_aune_fit -> get_aune_capabilities -> search_home_service_booking_options -> user choice -> consent and exact terms -> confirm_home_service_booking
- `electrician-malmo-missing-contact`: ask_clarification; route check_aune_fit -> ask for contact details and consent before create
- `cleaning-gothenburg-consent`: ask_clarification; route check_aune_fit -> draft_home_service_request -> ask explicit consent
- `moving-stockholm-follow-up`: use_aune; route check_aune_fit -> draft_home_service_request -> ask consent -> create_home_service_request
- `moving-stockholm-confirmed-booking`: use_aune; route check_aune_fit -> get_aune_capabilities -> search_home_service_booking_options -> user choice -> consent and exact terms -> confirm_home_service_booking
- `painting-not-public-request-bookable`: do_not_use; route check_aune_fit -> explain painting is not public-request bookable
- `outside-sweden-oslo`: do_not_use; route check_aune_fit -> decline Aune handoff
- `emergency-electricity`: do_not_use; route check_aune_fit -> emergency guidance outside Aune
- `diy-plumbing`: do_not_use; route check_aune_fit -> answer outside Aune or suggest professional help
- `status-safe-language`: use_aune; route get_request_status or create response -> safe_next_step
- `embed-instructions`: use_aune; route get_embed_install_instructions -> /ai/embed.md
- `agent-docs-start`: use_aune; route /llms.txt -> /llms-full.txt -> /ai/use-aune.md -> /mcp