Verified:GitHub

ha-self-diagnosis

Diagnose Hope Agent behavior and draft source-backed GitHub issue drafts.

1.4k|129|Updated Mar 13, 2026

Search Tags:#troubleshooting #diagnostics #self-study #architecture mapping #runtime logs #GitHub issue reporting #SQLite read-only

Ready to run

npx skills add https://github.com/shiwenwen/hope-agent --skill ha-self-diagnosis

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: ha-self-diagnosis
Source: https://github.com/shiwenwen/hope-agent/tree/main/skills/ha-self-diagnosis
Command: npx skills add https://github.com/shiwenwen/hope-agent --skill ha-self-diagnosis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you understand how Hope Agent works internally and quickly produce useful diagnostics or a well-structured GitHub issue when something breaks, slows down, or needs improvement.

Core Features & Use Cases

Self-study with source-backed answers: maps a question to the right subsystem and provides concrete file/module references and debugging entry points.
Issue reporting for bugs and enhancements: classifies the request, gathers the right environment/context, optionally checks duplicates, drafts an issue, and creates it only with confirmation.
SQLite read-only diagnostics: guides you to inspect local logs and session evidence safely via read-only queries.

Quick Start

Ask the AI: "Self-diagnose why Hope Agent is crashing on my Windows server mode after I open the Web GUI, and draft a GitHub issue including the latest error evidence."

Frequently Asked Questions about ha-self-diagnosis

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

FAQPage Schema

How do I diagnose Hope Agent runtime crashes and find the relevant source code?▼

To diagnose Hope Agent runtime crashes, this Skill maps reported failures to the correct subsystem and provides concrete file and module references with debugging entry points. It performs architecture and source mapping to identify the root cause.

How do I create a GitHub issue for a Hope Agent bug with proper error logs?▼

Creating a GitHub issue for Hope Agent bugs involves classifying the request, gathering environment context, checking for duplicate issues, and drafting the report. The Skill initiates a safe issue_report workflow that creates the issue only after your confirmation.

Can I inspect local SQLite databases and settings to troubleshoot Hope Agent without modifying data?▼

Yes, you can inspect local SQLite databases and settings safely because the Skill performs read-only diagnostics. It guides you to query local logs and session evidence without risking data modification during your troubleshooting process.

What is the best way to understand Hope Agent internal architecture across different run modes?▼

Understanding Hope Agent internal architecture across desktop, server, ACP, and IM run modes is achieved through self-study with source-backed answers. The Skill maps implementation questions to specific subsystems and retrieves relevant context and settings.

Does Hope Agent issue reporting support redaction of sensitive data before submission?▼

Yes, Hope Agent issue reporting supports redaction of sensitive data before submission. The issue_report workflow includes built-in redaction and confirmation steps to ensure safe GitHub issue creation without exposing private configuration details.

Why does Hope Agent behave differently in server HTTP-WS mode compared to desktop mode?▼

Differences in Hope Agent behavior between server HTTP-WS and desktop modes stem from distinct runtime and config behaviors. The Skill retrieves settings and context specific to each run mode to provide source-backed explanations for these variations.