← Back to Skills Marketplace
narrative-topology
by
TurinFohlen
· GitHub ↗
· v1.0.0
· MIT-0
122
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install narrative-topology
Description
Extract semantic relationships from long narratives, architectures, or complex discussions using RDF-style triple notation. Generate adjacency matrices to re...
Usage Guidance
This skill appears to do what it says: a small Python scanner that finds single-line '<<{Subject, Predicate, Object}.' entries and outputs a subject→object adjacency matrix. It does not access the network or secrets. Before running: 1) Run the script in a dedicated directory (or a copy of your docs) because it recursively reads files under the current working directory and will process any matching extensions. 2) Note that the predicate is ignored by the code — if you need predicate-aware graphs, the script will need modification. 3) The scanner only matches one-line triples that end with '}.', so multi-line or differently formatted triples will be missed. If these limitations are acceptable, the skill is coherent and low-risk; otherwise ask the author for predicate handling, multi-line support, or a narrower file-glob.
Capability Analysis
Type: OpenClaw Skill
Name: narrative-topology
Version: 1.0.0
The narrative-topology skill is a utility designed to extract semantic relationships from text files using a custom RDF-style triple syntax. The provided Python script (scanner.py) recursively scans the current directory for specific file extensions (.md, .txt, etc.), parses the triples, and outputs a compressed adjacency matrix to stdout. The code contains no network calls, no data exfiltration logic, and no suspicious execution patterns; its behavior is entirely consistent with its documented purpose.
Capability Assessment
Purpose & Capability
Name/description (extract RDF-style triples and produce adjacency matrices) align with the included scanner.py and SKILL.md. The only substantive mismatch: the scanner explicitly ignores the predicate field (comment: "p is ignored (predicate)") — the tool converts triples into subject→object edges only. This is coherent for adjacency matrices but means predicate semantics are discarded.
Instruction Scope
SKILL.md tells the user to place scanner.py in a markdown directory and run it; the script recursively reads all files under the current working directory with extensions (.txt, .def, .erl, .ex, .md). It only matches single-line triples that start with '<<{' and end with '}.' so multi-line triples won't be picked up. Scanning entire cwd is expected for this use case but could process files you did not intend (e.g., source files) — run in a dedicated folder if needed.
Install Mechanism
No install spec and no external downloads; this is an instruction-only skill with a small Python script. No packages are installed, nothing is written to disk beyond standard script execution.
Credentials
No environment variables, credentials, or external config paths are requested or used. The script performs only local filesystem reads and stdout writes.
Persistence & Privilege
Skill does not request persistent/system-wide presence (always:false) and does not modify other skills or system settings. It does not persist tokens or change config.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install narrative-topology - After installation, invoke the skill by name or use
/narrative-topology - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of narrative-topology skill.
- Introduces RDF-style triple notation for semantic extraction from narratives.
- Provides a Python scanner to extract and expand triples, generating an adjacency matrix.
- Supports parallel subjects/objects with cartesian product notation.
- Outputs compressed adjacency matrices and basic narrative graph statistics.
- Enables downstream graph analysis (degree, paths, cycles) for complex discussions.
- Includes instructions for extending output to weighted edges and Mermaid diagram generation.
Metadata
Frequently Asked Questions
What is narrative-topology?
Extract semantic relationships from long narratives, architectures, or complex discussions using RDF-style triple notation. Generate adjacency matrices to re... It is an AI Agent Skill for Claude Code / OpenClaw, with 122 downloads so far.
How do I install narrative-topology?
Run "/install narrative-topology" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is narrative-topology free?
Yes, narrative-topology is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does narrative-topology support?
narrative-topology is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created narrative-topology?
It is built and maintained by TurinFohlen (@turinfohlen); the current version is v1.0.0.
More Skills