{
  "markdown": "# JustFix Skill 🛠️\n\nQuote UK trades jobs from any AI agent. Get a price breakdown and a tappable booking link in a single turn.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Skill format: AgentSkills](https://img.shields.io/badge/Skill-AgentSkills-blueviolet)](https://docs.openclaw.ai)\n[![MCP](https://img.shields.io/badge/MCP-justfix-teal)](https://estimator-mcp.justfix.app/mcp)\n\n👉 **[How to install JustFix on your AI agent →](./INSTALL.md)** — Claude Desktop, Cursor, Claude Code, Codex CLI, Gemini CLI, OpenClaw, Hermes, or any MCP-aware client.\n\n---\n\n## See it in action\n\n### On OpenClaw + Telegram\n\nAsk Squid (or any OpenClaw agent) for a quote in plain English. The skill maps the request to the right JustFix service code, calls the MCP, and replies with a clean quote card and a tappable booking URL.\n\n![JustFix quote in OpenClaw Telegram](assets/screenshots/openclaw-telegram-quote.jpg)\n\n### In ChatGPT (via the JustFix app)\n\nThe same underlying MCP server powers JustFix's official ChatGPT app. The skill in this repo gives you the equivalent experience in any other agent, with a tappable booking link instead of the ChatGPT rich card.\n\n<table>\n  <tr>\n    <td><img src=\"assets/screenshots/chatgpt-app-1.jpg\" alt=\"ChatGPT JustFix step 1\" /></td>\n    <td><img src=\"assets/screenshots/chatgpt-app-2.jpg\" alt=\"ChatGPT JustFix step 2\" /></td>\n  </tr>\n  <tr>\n    <td><img src=\"assets/screenshots/chatgpt-app-3.jpg\" alt=\"ChatGPT JustFix step 3\" /></td>\n    <td><img src=\"assets/screenshots/chatgpt-app-4.jpg\" alt=\"ChatGPT JustFix step 4\" /></td>\n  </tr>\n</table>\n\n### In Claude Code (and Cursor, Codex CLI, Gemini CLI)\n\nThe same skill loads natively in Claude Code. Ask in plain English, the skill resolves the service, calls the MCP, and returns the same quote card plus a tappable booking link.\n\n![JustFix skill running inside Claude Code](assets/screenshots/claude-code-cli.jpg)\n\n_One-pager install guide: **[INSTALL.md](./INSTALL.md)**. Detailed per-harness notes in [install/](install/)._\n\n---\n\n## What is this?\n\nA portable AI skill that plugs into [JustFix's public MCP server](https://estimator-mcp.justfix.app/mcp) and lets your AI agent quote real trades jobs in real time. Built for OpenClaw, Hermes, Claude Code, Cursor, Codex CLI, Gemini CLI, and any other harness that supports AgentSkills or the Model Context Protocol.\n\n**One conversation, one quote, one tap to book.**\n\n```\nYou: How much would it cost to get someone to fix a broken kitchen tap?\n\nAgent: 🔧 Plumbing Estimate\n       Scope: Diagnose and repair dripping kitchen tap.\n       Estimated duration: 1 hour\n\n       Labour (1 hr × £90/hr): £90.00\n       Call-out fee:           £50.00\n       Total estimate:        £140.00\n\n       📅 Tap to book this job → my.justfix.app/booking/...\n```\n\n## What it does\n\nThe skill exposes three MCP tools from JustFix's estimator server to your AI agent:\n\n| Tool | What it does |\n|---|---|\n| `list_services` | Lists JustFix's 13 service categories with hourly rates |\n| `call_out_fee` | Returns the flat booking call-out fee |\n| `service-estimate-card` | Generates a full cost estimate plus a unique booking URL |\n\nWhen the user is ready to confirm, the URL pops them to `my.justfix.app` where they finish the booking (date, postcode, payment).\n\n## Supported services\n\nElectrical · Plumbing · Locksmith · Glazing · Carpentry · Handyperson · Heating + Gas · Gas Appliances · Roofing · Drains · White Goods · Boiler Service · Something Else (catch-all)\n\nUK only. Hourly rates from £55 (white goods) to £90 (most trades). £50 flat call-out fee per booking.\n\n## Installation (pick your harness)\n\n| Harness | Install guide |\n|---|---|\n| OpenClaw | [install/openclaw.md](install/openclaw.md) |\n| Hermes | [install/hermes.md](install/hermes.md) |\n| Claude Code | [install/claude-code.md](install/claude-code.md) |\n| Cursor | [install/cursor.md](install/cursor.md) |\n| Codex CLI | [install/codex-cli.md](install/codex-cli.md) |\n| Gemini CLI | [install/gemini-cli.md](install/gemini-cli.md) |\n\nIf your harness isn't listed but supports MCP, the pattern is:\n\n1. Register `https://estimator-mcp.justfix.app/mcp` as a streamable-HTTP MCP server.\n2. Put `SKILL.md` somewhere the harness's skill discovery picks up (or paste its contents into your agent instructions).\n3. Done. No auth, no config, no API keys.\n\n## Sample conversations\n\nWorked examples for common queries:\n\n- [Quote a boiler service](examples/quote-boiler-service.md)\n- [Multi-hour electrical job](examples/quote-multi-hour-electrical.md)\n- [What services does JustFix offer?](examples/what-services.md)\n\n## How it works\n\n```\n┌─────────────┐         ┌──────────────────────┐         ┌────────────────────┐\n│  AI agent   │ ──MCP──▶│ JustFix MCP server   │ ──API──▶│ justfix.app        │\n│ + SKILL.md  │         │ estimator-mcp        │         │ pricing engine     │\n└─────────────┘         └──────────────────────┘         └────────────────────┘\n       │                                                          │\n       │                                                          │\n       │  ◀── booking URL with unique tracking ID ────────────────┘\n       │\n       ▼\n┌─────────────┐\n│   User      │ ──── taps URL ────▶ my.justfix.app booking form\n└─────────────┘\n```\n\nThe MCP server is hosted on Vercel by JustFix and is open – no API key required. Each estimate is tagged with a unique `chatgpt_booking_link_id` for attribution.\n\n## What this skill CAN'T do\n\nHonest about the boundaries:\n\n- ❌ Complete the booking itself (the user finishes on the JustFix website)\n- ❌ Check live engineer availability (handled at booking time)\n- ❌ Take payment (handled on the booking page)\n- ❌ Quote outside the UK\n- ❌ Quote materials or parts (labour-only estimate)\n\nThese are functions of the underlying JustFix product, not the skill. As JustFix expands the MCP, the skill will too.\n\n## Branding and attribution\n\nThis is an official integration with JustFix's public MCP server, but the skill repo itself is community-maintained. JustFix takes no responsibility for the skill's behaviour – only for the underlying MCP server.\n\nIf you fork, modify, or embed this skill, you must:\n\n- Keep the MIT license intact\n- Not misrepresent the JustFix brand\n- Pass through the booking URL unchanged (for attribution tracking)\n\n## Roadmap\n\nWhen JustFix expands the MCP server, the skill will follow:\n\n- Engineer availability lookup\n- Quote-to-booking-confirmation in one turn\n- Multi-job bundle pricing\n- Recurring service plans (e.g. annual boiler service auto-rebook)\n- Photo upload for diagnostic estimates\n\nTrack progress in [GitHub Issues](https://github.com/squid-ea/justfix-skill/issues).\n\n## Contributing\n\nPull requests welcome. Please:\n\n1. Read SKILL.md and understand the format\n2. Run the install/* guides in your own harness to test changes\n3. Open an issue first for anything bigger than a typo fix\n\n## License\n\n[MIT](LICENSE) – use, modify, distribute, embed in commercial products. No warranty.\n\n## About JustFix\n\nJustFix is a UK home-services platform connecting customers with vetted local tradespeople. Boiler service, electrical, plumbing, locksmith, glazing and more. Same-day availability in most UK cities.\n\n🌐 [justfix.app](https://justfix.app)\n",
  "bytes": 7253,
  "sha": "c7190e7f73f56a219a8e80ac71c344239fca3ba141ac79f05f8eb221d29558ff",
  "repo_slug": "just-fix/justfix-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_just_fix_justfix_skill_829fc77c/readme"
}