← 返回 Skills 市场
134
总下载
0
收藏
0
当前安装
5
版本数
在 OpenClaw 中安装
/install publish-wiki-js
功能描述
Publish markdown content to Wiki.js with proper formatting and metadata. Use when user wants to create or update wiki pages, convert notes/articles to wiki f...
安全使用建议
This skill's code and instructions are consistent with publishing markdown to a Wiki.js instance, but there are manifest inconsistencies you should address before installing. Steps to consider:
- Verify the source and trustworthiness of the skill (owner ID/slug are present but no homepage was provided).
- Confirm the platform will actually provide WIKI_KEY and WIKI_URL to the skill; the registry metadata omits these but SKILL.md and the script require them.
- Create a scoped API key in Wiki.js with minimal write permissions, and test on a staging wiki or non-production space first.
- Review the included script (scripts/publish_to_wiki.py) yourself — it makes POST requests only to the user-supplied WIKI_URL and reads only the file you pass to it.
- Ensure WIKI_URL points to your trusted Wiki.js endpoint (do not set it to an unknown third-party URL). If anything looks unexpected, revoke the API key and do not provide production credentials.
If you want higher confidence, ask the publisher to fix the registry metadata to declare WIKI_KEY and WIKI_URL and the runtime dependency, or request an explanation for the mismatch.
功能分析
Type: OpenClaw Skill
Name: publish-wiki-js
Version: 1.2.0
The skill bundle is a legitimate tool for publishing markdown content to a Wiki.js instance via its GraphQL API. The Python script `scripts/publish_to_wiki.py` and the instructions in `SKILL.md` follow security best practices by explicitly warning against string interpolation and advocating for the use of GraphQL variables to prevent injection vulnerabilities. No evidence of data exfiltration, unauthorized access, or malicious prompt injection was found.
能力评估
Purpose & Capability
The SKILL.md and included Python script both target Wiki.js GraphQL API and require WIKI_KEY and WIKI_URL — this matches the stated purpose. However, the registry-level metadata at the top of the submission lists no required env vars or primary credential, which is inconsistent with the SKILL.md and script. The requested credentials (WIKI_KEY/WIKI_URL) are appropriate for the declared purpose.
Instruction Scope
SKILL.md instructions and the script limit actions to reading a user-specified markdown file and interacting with the Wiki.js GraphQL endpoint. There are no instructions to read unrelated system files, secret stores, or to transmit data to third-party endpoints other than the user-supplied WIKI_URL.
Install Mechanism
There is no install spec (instruction-only), which lowers install-time risk. The SKILL.md declares a Python runtime dependency ('requests') and the included script imports requests; the registry metadata did not declare runtime deps. This mismatch is a packaging/manifest inconsistency but not inherently malicious.
Credentials
The only sensitive values needed are WIKI_KEY (primary credential) and WIKI_URL, which are proportional to a wiki-publishing task. The concern is the mismatch between the SKILL.md (which marks WIKI_KEY required/credential) and the registry metadata (which lists no required env vars). Confirming which metadata the platform enforces is important.
Persistence & Privilege
The skill does not request 'always: true', does not attempt to modify other skills or global agent configurations, and does not persist credentials beyond using the provided environment variables. Autonomous invocation is allowed (default) but not combined with unusual privileges.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install publish-wiki-js - 安装完成后，直接呼叫该 Skill 的名称或使用
/publish-wiki-js触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.2.0
- Improved documentation for update and create operations: now clarifies that the tags and description fields are required for both mutations, even if empty.
- Added explicit response structure examples, including responseResult for error handling and status checking.
- Expanded create and update mutation examples to include “tags” (required, can be empty) and clearer type requirements.
- Provided step-by-step guidance and example queries for updating pages, including page ID lookup by path.
- Highlighted common causes of mutation failure and remedies, especially for missing required fields and handling special characters/escaping in complex markdown.
- General formatting and clarity improvements for API usage instructions.
v1.1.2
- No code changes included in this release.
- Improved example request.
v1.1.1
**No functional code changes; added explicit metadata for deployment and environment.**
- Added a `metadata` section specifying required environment variables (`WIKI_KEY`, `WIKI_URL`) and runtime Python dependencies (`requests`) in SKILL.md.
- Declared `WIKI_KEY` as the primary credential and provided descriptions for both environment variables.
- Ensured deployment requirements are clearly documented for all users and systems.
- No changes to skill logic, workflow, or usage instructions.
v1.1.0
**Major update focusing on safe and robust GraphQL string handling.**
- Added `scripts/publish_to_wiki.py` for streamlined publishing workflow.
- Overhauled documentation to clarify that all GraphQL mutations must use variables—not direct string interpolation—for content and string values.
- Explained common pitfalls with string escaping, markdown/code blocks, and double-escaping; provided correct implementation patterns.
- Included a complete example using Python, requests, and json for Wiki.js API with variable-based GraphQL queries.
- Added explicit requirements and error handling for variable types, tags, and encoding.
v1.0.0
- Initial release of the wiki-publisher skill.
- Enables publishing markdown content to Wiki.js with proper formatting and metadata handling.
- Automatically removes YAML frontmatter and suggests wiki paths and tags.
- Supports creating and updating Wiki.js pages via the GraphQL API.
- Includes workflow for content extraction, metadata suggestion, confirmation, and publishing.
- Handles API authentication and common errors such as path conflicts or connectivity issues.
元数据
常见问题
Publish Wiki Pages 是什么？
Publish markdown content to Wiki.js with proper formatting and metadata. Use when user wants to create or update wiki pages, convert notes/articles to wiki f... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 134 次。
如何安装 Publish Wiki Pages？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install publish-wiki-js」即可一键安装，无需额外配置。
Publish Wiki Pages 是免费的吗？
是的，Publish Wiki Pages 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Publish Wiki Pages 支持哪些平台？
Publish Wiki Pages 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Publish Wiki Pages？
由 Hugo Gu（@hugogu）开发并维护，当前版本 v1.2.0。
推荐 Skills