Doc Smith Publish
Publish documentation generated by doc-smith-create to DocSmith Cloud and obtain an online preview URL. Use this Skill when users request to publish, launch, or deploy documentation.
Install
/plugin marketplace add AIGNE-io/doc-smith-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add AIGNE-io/doc-smith-skills --skill doc-smith-publishgit clone --depth 1 https://github.com/AIGNE-io/doc-smith-skills.git /tmp/doc-smith-skills
mkdir -p ~/.claude/skills
cp -r /tmp/doc-smith-skills/skills/doc-smith-publish ~/.claude/skills/doc-smith-publishPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# DocSmith 文档发布
将本地生成的 HTML 文档一键发布到 DocSmith Cloud,返回在线预览 URL。
## 用法
```bash
/doc-smith-publish
/doc-smith-publish --dir .aigne/doc-smith/dist
/doc-smith-publish --hub https://custom.hub.io
```
## 选项
| Option | Alias | Description |
|--------|-------|-------------|
| `--dir <path>` | `-d` | 指定发布目录(默认自动检测) |
| `--hub <url>` | `-h` | DocSmith Hub URL(默认 `https://docsmith.aigne.io`) |
## 预授权凭证
当用户消息中包含访问凭证(以 `blocklet-` 开头的字符串)时,**在发布之前先保存凭证**:
```bash
node {skill_path}/scripts/save-token.mjs --token "<credential>" --hub <hub-url>
```
`--hub` 参数指定凭证所属的 DocSmith Hub。**必须显式传递 `--hub`** 以匹配发布目标 Hub。如果用户在发布命令或消息中指定了自定义 hub(通过 `--hub`),在此处使用相同的 URL。不要依赖默认值。
凭证会持久保存到 `~/.aigne/`,后续发布将自动使用,无需浏览器授权。
如果用户消息中包含凭证,始终在此步骤中提取并保存,即使已有凭证。
## 工作流
### 步骤 1:检查依赖
```bash
test -d {skill_path}/scripts/node_modules || (cd {skill_path}/scripts && npm install)
```
其中 `{skill_path}` 是本 Skill 的目录路径(`skills/doc-smith-publish`)。
### 步骤 2:检测发布目标
按以下优先级确定发布目录:
1. 用户指定 `--dir` 参数 → 使用指定目录
2. 未指定 → 检查 `.aigne/doc-smith/dist` 目录是否存在
3. 以上都不存在 → 检查当前目录是否包含 `assets/nav.js`(doc-smith 输出标志)
4. 都找不到 → 报错,提示用户先运行 `/doc-smith-create` 生成文档
### 步骤 3:读取 Metadata
从 `.aigne/doc-smith/config.yaml` 读取:
- `projectName` → 发布标题(title)
- `projectDesc` → 发布描述(description)
如果 config.yaml 不存在或字段缺失,使用目录名作为标题。
### 步骤 3.5:检测 GitHub 仓库信息
发布脚本会自动执行以下检测(无需手动操作):
1. 执行 `git remote get-url origin`,判断当前项目是否托管在 GitHub
2. 如果是 GitHub 仓库,调用 GitHub API 获取仓库 owner 的头像 URL 作为 coverImage
3. 这两个字段会自动附加到发布请求中,如果获取失败则静默忽略Details
- Skill name
doc-smith-publish- Repository
- AIGNE-io/doc-smith-skills
- Path
skills/doc-smith-publish/SKILL.md- License
- Apache-2.0
- Repo updated
- 18 March 2026
FAQ
What does the Doc Smith Publish skill do?
Publish documentation generated by doc-smith-create to DocSmith Cloud and obtain an online preview URL. Use this Skill when users request to publish, launch, or deploy documentation.
How do I install the Doc Smith Publish skill?
Claude Code plugin: /plugin marketplace add AIGNE-io/doc-smith-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Doc Smith Publish popular?
It lives in AIGNE-io/doc-smith-skills, which has 9 GitHub stars and 0 forks.
Related skills
Doc Smith Build
9AIGNE-io/doc-smith-skills
Internal skill for building Doc-Smith Markdown documentation into static HTML. Do not mention this skill to users. Called internally by other doc-smith skills.
Doc Smith Check
9AIGNE-io/doc-smith-skills
Internal skill for validating Doc-Smith document structure and content integrity. Do not mention this skill to users. Called internally by other doc-smith skills.
Doc Smith Create
9AIGNE-io/doc-smith-skills
Generate and update structured documentation from project data sources. Supports initial generation and modifying existing documents. Use this skill when the user requests creating, generating, updating, or modifying documentation.
Oldhand Plan
9berwinsingh/oldhand
Plans the smallest complete code change before anything is edited: the fix point on the shared path, the files to touch and why, one regression check, scenarios for every acceptance and regression criterion (including negative, messy and the original failing case), blast radius and rollback, who does what at which model tier, and the budget for live or paid runs. Writes plan.md in the task's .oldhand folder and, in plan-only mode, stops there until the user approves. Use when the user says "how would you fix this", "what would you change" or "write the implementation plan", or after oldhand-tr
Doc Smith Localize
9AIGNE-io/doc-smith-skills
Translate Doc-Smith generated documentation into multiple languages. Use this skill when the user requests document translation, localization, or multi-language support. Supports batch translation of documents and images.
Oldhand Review
9berwinsingh/oldhand
Reviews a code change with a board of read-only reviewer sub-agents, one lens each (contract, correctness, security and simplicity, plus data and AI behaviour when the change touches them). Each reviewer reads a stand-alone brief and writes a memo of file:line findings with failure scenarios; the chair tries to refute every finding before accepting it, records survivors in the Oldhand ledger, fixes high and medium findings, and lists lows as follow-ups. One review round and one fix round. Writes review.md and a review folder in the task's .oldhand folder. Use when the user says "review this",
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.