← Back to Skills Marketplace
134
Downloads
0
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install publish-wiki-js
Description
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...
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install publish-wiki-js - After installation, invoke the skill by name or use
/publish-wiki-js - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 134 downloads so far.
How do I install Publish Wiki Pages?
Run "/install publish-wiki-js" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Publish Wiki Pages free?
Yes, Publish Wiki Pages is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Publish Wiki Pages support?
Publish Wiki Pages is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Publish Wiki Pages?
It is built and maintained by Hugo Gu (@hugogu); the current version is v1.2.0.
More Skills