A specialized diagnostic utility designed to verify the health, connectivity, and configuration of Openclaw Skills within your AI agent environment.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install skillnote-doctor
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install skillnote-doctor using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is SkillNote Doctor?
SkillNote Doctor serves as the essential health-check utility for developers using the SkillNote and Openclaw ecosystem. It provides an automated, read-only audit of your entire integration stack, ensuring that your AI agent can effectively communicate with skill registries and resolve dependencies without friction. By analyzing local configurations and remote endpoints, it eliminates the guesswork involved in troubleshooting broken agent workflows.
This tool is particularly valuable when Openclaw Skills fail to load or when the agent's behavior suggests a configuration drift. It systematically verifies everything from binary existence to specific API response schemas, providing a clear pass/fail report with actionable remediation steps for every failure encountered.
SkillNote Doctor Use Cases
- Troubleshooting broken skill loading or registry connectivity issues.
- Performing a routine audit of the agent's AGENTS.md configuration and markers.
- Verifying the availability of the SkillNote server and resolver endpoints.
- Debugging malformed or missing JSON configuration files in the .openclaw directory.
- Ensuring the correct installation of core binaries and resolver dependencies.
How SkillNote Doctor Works
- The tool first verifies the existence of the clawhub binary on the system path to ensure the base environment is functional.
- It reads the local SkillNote configuration file to validate JSON integrity and extract the necessary host metadata.
- A connectivity test is performed against the SkillNote registry to ensure the remote host is reachable and responding correctly.
- It audits the workspace AGENTS.md file for the required version markers necessary for agent grafting.
- The tool checks for the presence of the skillnote-resolver skill to ensure context-bundling capabilities are active.
- A final end-to-end test is performed via a POST request to the context-bundle endpoint to confirm the system can successfully resolve skills for the agent.
SkillNote Doctor Setup
To install and run the diagnostic tool for your Openclaw Skills, use the following commands:
# Install the SkillNote Doctor skill
clawhub install skillnote-doctor
# Trigger a diagnostic run via your agent
# Use triggers like: "diagnose", "check setup", or "debug"
SkillNote Doctor Data Schema & Taxonomy
SkillNote Doctor interacts with the following files and endpoints to validate your Openclaw Skills environment:
| Component | Path / Endpoint | Validation Logic |
|---|---|---|
| Binary | which clawhub |
Checks if the CLI tool is in the system PATH |
| Configuration | ~/.openclaw/skills/skillnote/config.json |
Validates JSON structure and host field |
| Agent Registry | ~/.openclaw/workspace/AGENTS.md |
Scans for the <skillnote v1> marker |
| Resolver Skill | ~/.openclaw/skills/skillnote-resolver/SKILL.md |
Verifies the resolver is locally installed |
| API Connectivity | <host>/v1/skills |
GET request to verify HTTP 200 status |
| Context API | <host>/v1/openclaw/context-bundle |
POST request to verify functional skill resolution |
SkillNote Doctor Advanced Features
- Comprehensive 6-point health check that runs to completion regardless of individual failures.
- Non-destructive diagnostic mode that strictly follows read-only rules for local files.
- Specific remediation strings provided for every failure type (e.g., malformed JSON vs. missing host).
- Support for multi-agent environments by validating global workspace markers in AGENTS.md.
- Version-specific endpoint validation ensuring compatibility with SkillNote v0.3.0+.
SKILL.md
Loading
Related Openclaw Skills
Display Controller
A comprehensive hardware management skill for controlling monitor settings and retrieving detailed display specifications via command-line automation.
Arxiv HTML CN Static
A specialized tool for converting experimental arXiv HTML papers into fully localized, offline-ready Chinese static webpages.
ClickUp Enterprise Integration
An enterprise-grade integration for ClickUp designed to manage complex multi-client workflows with high-level reporting and automated subtask tracking.
molt-space
molt-space provides a persistent 3D environment where AI agents can physically exist, move, and interact using custom avatars and spatial audio.
Openclaw Git Manager
A dedicated version control tool for OpenClaw that tracks configuration changes, allowing for seamless commits, diffs, and rollbacks.
WeChat Pay Deduction Service
A professional integration solution for WeChat Pay entrusted deductions, covering recurring payments, automated renewals, and pay-after-use workflows.
Featured*
