ha-manual

Answers Hope Agent usage questions by reading the built-in bilingual user manual.

1.6k|149|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/shiwenwen/hope-agent --skill ha-manual
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ha-manual
Source: https://github.com/shiwenwen/hope-agent/tree/main/skills/ha-manual
Command: npx skills add https://github.com/shiwenwen/hope-agent --skill ha-manual

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Users often ask how to use a feature, where a setting lives, or what a panel does, and answering from memory risks inventing wrong setting names or UI paths. This Skill grounds every answer in the official bilingual user guide shipped with Hope Agent.

Core Features & Use Cases

  • Manual lookup: Resolves the mirrored manual directory dynamically via $HA_DATA_DIR (or ~/.hope-agent) and reads the correct language folder (zh or en).
  • Chapter routing: A routing table maps questions to 14 chapters covering install, models, chat, memory, knowledge space, tools, autonomous tasks, IM channels, MCP/hooks/skills, settings, and more.
  • Faithful citation: Answers quote exact UI labels and cite chapter and section numbers, and explicitly say so when the guide lacks the answer.
  • Use Case: A user asks "在哪设置主模型和备用模型" — the Skill reads 02.md (Models & Providers) and replies with the exact panel names and section reference.

Quick Start

Ask how to use a Hope Agent feature or where a setting is located, and the Skill will look it up in the built-in user manual and answer with cited sections.

Frequently Asked Questions about ha-manual

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find where a setting is in Hope Agent?

Ask the question in natural language and the Skill reads chapter 13 of the built-in manual, which contains the settings navigation map showing which panel changes which option. Answers quote the exact panel names from the guide.

How does the skill answer Hope Agent usage questions?

It resolves the manual directory via the HA_DATA_DIR environment variable, picks the zh or en folder matching the user's language, routes the question to the right chapter using a routing table, and answers by quoting the guide text.

Does the manual lookup work in Docker deployments?

Yes. The Skill resolves the data directory dynamically, using /data when HA_DATA_DIR is set in Docker and ~/.hope-agent otherwise. It never hard-codes a path, so portable and container installs both work.

What happens if the manual directory is missing?

The Skill tells the user the manual is still being prepared and to retry shortly. It does not fall back to other paths, since the mirrored directory is the only on-disk copy in packaged installs.

When should I not use the user manual lookup?

Do not use it for internal architecture questions (use ha-self-diagnosis), error or log investigation (use ha-logs), or actually changing a setting for the user (use ha-settings). It only answers usage and navigation questions.