← Back to Skills Marketplace
572
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install mindgraph
Description
Create and query an Obsidian-style [[wikilink]] knowledge graph with learnable repeatable MindSkills for managing and analyzing workspace files.
Usage Guidance
This skill appears to do what it says: it will scan all .md files in the workspace, write a mindgraph.json index in the workspace root, and create mindskill folders/results under skills/mindgraph/. It does not require credentials or contact external services. Before installing, consider: (1) If your workspace includes sensitive content in markdown, the index will read it — move or exclude sensitive files if needed. (2) The skill will persistently write mindgraph.json and result files; back up any existing files with the same names. (3) The SKILL.md enforces a broad authoring rule (always use [[wikilinks]]), which may change how the agent edits or writes notes — decide whether you want that convention applied automatically. (4) If you enable autonomous agent invocation, remember it could create/modify files when asked; consider limiting write actions to manual approval if you want stricter control.
Capability Analysis
Type: OpenClaw Skill
Name: mindgraph
Version: 1.0.0
The skill bundle is classified as suspicious due to its broad file system read/write/create capabilities within the agent's workspace and the potential for vulnerability via user-controlled input. The `SKILL.md` instructs the agent to use user-provided names (e.g., for new mindskills or result subjects) in file paths, which are then processed by `scripts/mindgraph.py`. While `os.path.join` is used to construct paths, mitigating simple path traversal, an attacker could still inject slashes into the name (e.g., `mindgraph.py learn "foo/bar"`) to create arbitrary nested directory structures, potentially leading to resource exhaustion or unexpected file system layout. This represents a vulnerability in input handling, rather than clear malicious intent. Additionally, the strong behavioral instructions in `SKILL.md` constitute a form of prompt injection, though currently aimed at enforcing knowledge management practices rather than harmful actions.
Capability Assessment
Purpose & Capability
The name/description (wikilinks + MindSkills) match the included SKILL.md and scripts: the Python script indexes .md files, resolves [[wikilinks]], and stores mindskill results under skills/mindgraph/mindskills/. No unrelated binaries, cloud credentials, or surprising resources are required.
Instruction Scope
SKILL.md explicitly instructs the agent to read workspace markdown files and to create/write MindSkill result files and the graph index (mindgraph.json). That behavior is consistent with the purpose, but the 'Always-On Rules' (use [[wikilinks]] for every markdown file you write) is a broad stylistic mandate that could affect many files and authoring workflows — review whether you want the agent to edit or standardize existing workspace files.
Install Mechanism
No install spec; this is an instruction-only skill that bundles a plain Python script. Nothing is downloaded from external URLs and there are no package-install steps in the manifest.
Credentials
No credentials or special environment variables are required. The script supports an optional MINDGRAPH_WORKSPACE env var to override the workspace root — this is reasonable and proportional.
Persistence & Privilege
always:false (normal). The skill does create persistent artifacts in the workspace (mindgraph.json, mindskill directories/results). That's expected for a knowledge-graph skill, but be aware these files are written into your workspace and persist across sessions.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install mindgraph - After installation, invoke the skill by name or use
/mindgraph - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of MindGraph: A knowledge graph and learnable process engine for OpenClaw workspaces.
- Supports Obsidian-style [[wikilinks]] across all workspace markdown files for people, projects, tools, and concepts.
- Introduces MindSkills: repeatable, learnable frameworks with process definitions and graph-connected results.
- Provides CLI tools for indexing, querying, visualization, and memory maintenance (orphans, dead links, unconnected files).
- Enforces workspace-wide linking rules to connect knowledge and keep notes useful.
- MindSkills can be learned, viewed, executed, and results saved with structured metadata and automatic linking.
Metadata
Frequently Asked Questions
What is Mindgraph?
Create and query an Obsidian-style [[wikilink]] knowledge graph with learnable repeatable MindSkills for managing and analyzing workspace files. It is an AI Agent Skill for Claude Code / OpenClaw, with 572 downloads so far.
How do I install Mindgraph?
Run "/install mindgraph" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Mindgraph free?
Yes, Mindgraph is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Mindgraph support?
Mindgraph is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Mindgraph?
It is built and maintained by hulkworks (@hulkworks); the current version is v1.0.0.
More Skills