← Back to Skills Marketplace
118
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install doc-first
Description
Automatically consult official documentation first to accurately resolve configuration, usage, permission, or error issues with tools and APIs.
README (SKILL.md)
doc-first
任何外部工具、服务、API 的配置或问题，第一时间查官方文档，力求精准解决。
触发条件
遇到以下情况时自动触发：
- 不确定某个工具/服务的正确配置格式
- 不确定某个命令的用法或选项
- 遇到权限、授权、认证相关问题
- 遇到错误不知道原因
- 任何不确定的操作
- 配置 openclaw.json / 环境变量 / CLI 参数时
执行原则
第一原则：查官方文档
- 优先查官方文档/官方 API 文档
- 用
web_fetch抓取官方页面 - 英文文档为主，中文文档用于辅助确认（中文翻译常有滞后或不完整）
- 查完官方文档仍无解 → 按序尝试：GitHub Issue → Stack Overflow → 开发者社区搜索
- 每次查文档须说明依据：告诉用户查了哪篇文档、哪个版本（URL + 日期或版本号），方便用户核实
第二原则：精准解决
- 不确定答案时，宁可说"我不确定"也不瞎猜
- 遇到奇怪报错，先查文档再尝试修复
- 配置文件动手前，先确认正确格式和路径
第三原则：如实告知
- 官方文档没有 → 直接说明，不编造
- 找不到解决方案 → 说清楚，而不是给可能错误的答案
- 不确定的地方 → 提出最可能的猜测，但标注不确定
第四原则：验证步骤
改了配置之后，重新对比官方文档，确认格式/路径/选项都匹配，再继续下一步。不匹配就修正，不确定就停下来如实告知用户。
第五原则：版本意识
查文档时先确认版本号或服务版本，尤其是 Discord API 这类有大版本变化的（v10 → v14 格式完全不同）。不确定用哪个版本时，优先用最新版文档，并在回答中注明版本依据。
常见误区
- 以为配置格式和旧版本一样（实际上经常变）
- 记错选项名（比如
--force写成--forced） - 混用不同 API 版本（v1 和 v2 格式完全不同）
- 用错误的路径（比如把 user 配置放进 system 配置）
常用文档入口
| 服务 | 文档地址 |
|---|---|
| OpenClaw | https://docs.openclaw.ai/llms.txt |
| OpenAI | https://platform.openai.com/docs |
| Anthropic | https://docs.anthropic.com/ |
| GLM (智谱) | https://open.bigmodel.cn/dev/api |
| MiniMax | https://www.minimaxi.com/document/Guide |
| 阿里云通义千问 (DashScope) | https://qianwen-api.aliyun.com/ |
| 百度文心一言 (千帆) | https://qianfan.cloud.baidu.com/ |
| 讯飞星火认知大模型 | https://www.xfyun.cn/doc/spark/ |
| 月之暗面 Kimi (Moonshot) | https://platform.moonshot.cn/ |
| 昆仑万维天工AI | https://www.tiangong.cn/ |
| 字节扣子 (Coze) | https://www.coze.cn/docs/ |
| 微信小程序 | https://developers.weixin.qq.com/miniprogram/dev/framework/ |
| Telegram Bot API | https://core.telegram.org/bots/api |
| DeepSeek | https://api.deepseek.com/docs |
| Slack API | https://api.slack.com/ |
| Discord API | https://discord.com/developers/docs |
| GitHub API | https://docs.github.com/rest |
| Notion API | https://developers.notion.com/docs/getting-started |
| GMAIL API | https://developers.google.com/gmail/api |
规则
不查官方文档不开口。找不到就直说，不编答案。
Usage Guidance
This skill is internally coherent and low-risk because it only contains written guidance to consult official docs and record source URLs/versions. Things to consider before installing: (1) The runtime instructions require the agent to fetch external web pages — confirm you are comfortable with the agent making outbound HTTP requests and how fetched content is logged/cached by the platform. (2) The skill may direct the agent to consult API docs that could lead to API calls; ensure the agent will not automatically submit any of your credentials or secrets while following the guidance. (3) Confirm the platform's web_fetch/network policy (allowed domains, privacy, retention). If those are acceptable, this skill appears safe and appropriate for its stated purpose.
Capability Analysis
Type: OpenClaw Skill
Name: doc-first
Version: 1.2.0
The 'doc-first' skill bundle is a set of instructions designed to improve the accuracy of an AI agent by mandating the use of official documentation for troubleshooting and configuration. The SKILL.md file provides a list of legitimate documentation URLs (e.g., OpenAI, Anthropic, DeepSeek) and establishes principles for verification and honesty, with no evidence of malicious intent, data exfiltration, or harmful execution.
Capability Assessment
Purpose & Capability
The name/description (consult official docs first) matches the instructions. The SKILL.md explicitly says to fetch official documentation and record URLs/versions; no unrelated credentials, binaries, or installs are requested.
Instruction Scope
Instructions require using a web_fetch-like tool to retrieve official docs and to consult GitHub Issues/Stack Overflow when needed. This is appropriate for the stated purpose, but it does entail network fetching of external web pages (the skill instructs the agent to fetch many official documentation URLs).
Install Mechanism
No install spec and no code files — instruction-only skill with no downloads or installs. Lowest-risk category for install behavior.
Credentials
The skill requests no environment variables, credentials, or config paths. All declared requirements are proportional to its function (none).
Persistence & Privilege
always is false, autonomous invocation is allowed (platform default). The skill does not request permanent presence or modify other skills' config.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install doc-first - After installation, invoke the skill by name or use
/doc-first - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.0
改进：英文为主文档策略、查文档须说明依据、明确升级路径、新增版本意识原则、扩充文档入口表（9→17个）、修正MiniMax URL
v1.1.0
新增常见误区、验证步骤、多语言优先规则
v1.0.0
- Initial release introducing the "doc-first" skill.
- Automatically consults official documentation when configuring or troubleshooting external tools, services, or APIs.
- Clearly outlines strict principles: always check docs first, prioritize precise solutions, and honestly communicate uncertainty or lack of information.
- Includes a quick-access table of common documentation entry points for major platforms.
- Establishes the rule: do not provide answers without consulting official documentation first.
Metadata
Frequently Asked Questions
What is Doc-First Research?
Automatically consult official documentation first to accurately resolve configuration, usage, permission, or error issues with tools and APIs. It is an AI Agent Skill for Claude Code / OpenClaw, with 118 downloads so far.
How do I install Doc-First Research?
Run "/install doc-first" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Doc-First Research free?
Yes, Doc-First Research is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Doc-First Research support?
Doc-First Research is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Doc-First Research?
It is built and maintained by Ekin-chn (@ekin-chn); the current version is v1.2.0.
More Skills