← Back to Skills Marketplace

Liudao Heritage

Name: Liudao Heritage
Author: sirius-777-llm

by sirius-777-llm · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

299

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install liudao-heritage

Description

Search, enrich, and manage family heritage and historical relationship data from the LiùDào (六道) SQLite database. Use this skill when answering questions abo...

README (SKILL.md)

六道 (LiùDào) Heritage Manager

This skill provides access to the LiùDào family heritage and relationship database. It allows you to query historical figures, analyze relationship networks, and manage personal data with strict privacy controls.

Core Capabilities

Search Database: Look up people by name, including their basic info, relationships, and milestones.
Relationship Engine: Resolve complex queries like "A的B" (e.g., "康熙的父亲").
Data Enrichment: Safely upsert new records or append milestones (history today) to existing ones.

Environment Details

Database Path: /home/admin/.openclaw/workspace/liudao-bot/data/liudao.db
Core Scripts: Located in /home/admin/.openclaw/workspace/liudao-bot/
User Privacy: For private entries (e.g., family members), ensure you pass the correct viewer_id (e.g., 1234567890 for the specific authorized user).

Workflows

1. Searching for a Person

When a user asks about a specific historical figure or family member:

Run the python search script passing the name and the user's ID for privacy.
Example: python3 scripts/search_person.py "康熙" --viewer_id "5104087055"

2. Resolving Relationships ("A的B")

When a user asks relationship questions (e.g., "朱元璋的长子是谁？"):

Use the relation engine script.
Example: python3 scripts/resolve_relation.py "朱元璋" "长子"

3. Adding/Editing Data

For inserting a new person or adding milestones:

Write a quick python script using db_manager.py's upsert_person method.
Ensure is_private=1 and creator_id are set when adding personal family data.

Important Notes

Always parse the relations_json and milestones_json carefully; they contain structured relationship links and life events.
See references/db_schema.md for exact table structures.

Usage Guidance

Do not run these scripts or install the skill until you verify the missing modules and the database. Specifically: 1) Ask for or inspect the source of relation_engine.py and db_manager.py (they control DB reads/writes and privacy enforcement). 2) Confirm the DB path (/home/admin/.openclaw/workspace/liudao-bot/data/liudao.db) is the intended local file and contains only expected records. 3) Review db_manager.upsert_person and any network or file-I/O code to ensure there is no silent exfiltration or unexpected writes. 4) If you must test, do so in an isolated environment (non-production user, VM or container) with no sensitive data and monitor outbound connections. 5) If the skill is expected to be self-contained, request the missing files from the publisher; the current bundle is incomplete and therefore risky to run as-is.

Capability Analysis

Type: OpenClaw Skill Name: liudao-heritage Version: 1.0.0 The liudao-heritage skill bundle is a legitimate tool for managing a genealogy database (SQLite). The Python scripts (resolve_relation.py, search_person.py) and documentation (SKILL.md, db_schema.md) are consistent with the stated purpose of querying and managing historical and family relationship data, with no evidence of data exfiltration, malicious execution, or prompt injection.

Capability Assessment

ℹ Purpose & Capability

Name and description match the included search and relation scripts and the DB schema (local SQLite). However, the scripts import db_manager and relation_engine modules that are not included in the bundle/manifest, which is inconsistent with the SKILL.md claim to provide 'full source of all included files'. This could mean the skill expects an existing workspace environment; either way it is an important omission.

⚠ Instruction Scope

SKILL.md directs running Python scripts that change working directories to /home/admin/.openclaw/workspace and operate against a hard-coded DB path under /home/admin/.openclaw/workspace/liudao-bot/data/liudao.db. The scripts append the bot directory to sys.path and import other modules (db_manager, relation_engine) not provided. Because the code manipulates cwd and imports modules from a host workspace, it can access any files under that workspace at runtime — the instructions give the agent broad filesystem reach beyond just a single DB file. The upsert/edit workflow references db_manager.upsert_person without showing its implementation, so write/modify behavior is unknown.

✓ Install Mechanism

There is no install spec (instruction-only plus two scripts). No external downloads or package installs are requested in the bundle, which reduces installer risk. The remaining risk is runtime: the scripts expect other modules and a DB already present on the host.

ℹ Credentials

The skill requests no environment variables or external credentials, which is proportionate to a local-DB heritage manager. However, it uses a hard-coded absolute path under /home/admin/.openclaw/workspace and suggests passing a 'viewer_id' (example looks like a Telegram ID) for privacy checks — you should verify that the code enforcing privacy is present and correct (db_manager and relation_engine), since those modules are missing from the bundle.

✓ Persistence & Privilege

always is false and there's no install routine that would grant the skill persistent system-wide privileges. It does, however, run Python scripts that change cwd and import modules from the host workspace, so its runtime scope is as broad as the workspace contents but it does not request persistent agent-level privileges in the manifest.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install liudao-heritage
After installation, invoke the skill by name or use /liudao-heritage
Provide required inputs per the skill's parameter spec and get structured output

Version History

v1.0.0

liudao-heritage 1.0.0 – Initial Release - Search, enrich, and manage family heritage and historical relationship data via the LiùDào (六道) SQLite database. - Answer questions about historical figures and resolve relationship queries (e.g., "A的B"). - Add or update records with privacy controls for sensitive personal information. - Supports searching, relationship path resolution, and milestone management with script-based workflows.

Metadata

Slug liudao-heritage

Version 1.0.0

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 1

Frequently Asked Questions

What is Liudao Heritage?

Search, enrich, and manage family heritage and historical relationship data from the LiùDào (六道) SQLite database. Use this skill when answering questions abo... It is an AI Agent Skill for Claude Code / OpenClaw, with 299 downloads so far.

How do I install Liudao Heritage?

Run "/install liudao-heritage" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Liudao Heritage free?

Yes, Liudao Heritage is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Liudao Heritage support?

Liudao Heritage is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Liudao Heritage?

It is built and maintained by sirius-777-llm (@sirius-777-llm); the current version is v1.0.0.

More Skills