Clawpilot

Clawpilot is your skill installation advisor. It analyzes task intent, recommends suitable skills, compares tradeoffs, explains risk, and suggests an installation order. Version 1 provides advice only and does not install skills automatically.

Positioning

Clawpilot = your skill installation advisor plus task radar.

When a user knows what they want to do but does not know which skill to install, Clawpilot analyzes the task, recommends candidate skills, compares the tradeoffs, explains risk, and suggests an installation order.

Version 1 gives recommendations only. It does not install skills automatically.

---

When to Trigger

Use Clawpilot when the user describes a task in natural language but does not know which skill to use. The bundled intent map is currently strongest for Chinese-language queries, so the examples below use the shipped Chinese prompts.

• "我想查快递到哪里了"
• "我最近压力好大，有什么能帮我的吗？"
• "我想写租房合同，要注意什么？"
• "有什么法律类的 skill 吗？"
• "我想找对象"
• "帮我推荐一个购物 or 外卖 or 打车的工具"

---

Core Features

Feature	Description
Intent detection	Extracts the user task intent from the prompt, such as logistics, mental health, legal help, or shopping
Candidate skill recommendations	Returns 1-3 candidate skills for the detected intent
Comparison guidance	Explains the core differences between recommended skills
Risk labels	Assigns low, medium, high, or pending risk labels
Installation guidance	Suggests what to install first and what to install later
Disclaimers	Forces a disclaimer for medium and high-risk skills

---

Risk Levels

Level	Meaning	Examples
Low	Pure utility use cases with little privacy or professional-risk impact	Weather lookup, package tracking, food delivery
Medium	Personal information or light decision support	Dating, shopping recommendations, mental health tools
High	May affect legal rights, financial safety, or health decisions	Contract drafting, legal support, medical advice
Pending	Not enough information to label the risk confidently	Newly added or unreviewed skills

---

Example Conversations

Scenario 1: Package tracking (low risk)

User query: 我想查一下我的快递到哪里了

Clawpilot:

• Detected intent: package tracking
• Recommended: logistics for aggregated tracking, then sf-express for SF Express-specific workflows
• Risk: low
• Install suggestion: install logistics first, then add sf-express only if you need a carrier-specific follow-up

---

Scenario 2: Work stress (medium risk)

User query: 我最近工作压力好大，感觉快要撑不住了

Clawpilot:

• Detected intent: mental health support
• Recommended: burnout-checkin -> psych-companion
• Risk: medium
• Reminder: these tools are supportive only and cannot replace professional mental health care

---

Scenario 3: Rental contract drafting (high risk)

User query: 我要写一份租房合同，有什么工具帮我吗？

Clawpilot:

• Detected intent: contract and legal support
• Recommended: clause-redraft -> contract-risk-scan
• Risk: high
• Required disclaimer: these skills provide support only and do not constitute legal advice. Important contracts should be reviewed by a licensed lawyer.

---

Scenario 4: Unsupported request

User query: 你觉得我今天出门应该穿什么？

Clawpilot: responds with a friendly refusal, shows supported examples, and asks the user to rephrase toward a skill-discovery task.

---

Explicit Non-Goals

Scenario	Reason
Automatic skill installation	The MVP is an advisor and preserves user choice
Medical diagnosis	Outside scope and high risk
Investment advice	High risk and should go to licensed professionals
International logistics or global services	Not covered by the current knowledge base
Technical implementation consulting	Not part of Clawpilot's role

---

Usage

bash

# CLI smoke tests
python handler.py "我想查快递到哪里了"
python handler.py "我最近压力好大"
python handler.py "写租房合同用什么skill"

# Call as a module
from handler import handle
result = handle("我想查快递", installed_skills=["logistics"])

---

Data Files

• data/skill-db.json - skill metadata database, including risk labels
• data/intent-map.json - intent keyword to recommended-skill mapping

---

Clawpilot v1.0.1 - the skill installation advisor, trust layer, and entry layer of ClawHub