story-arborist

Diagnose and fix structural and semantic issues in a story-tree database.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Mharbulous/SyncoPaid --skill story-arborist
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-arborist
Source: https://github.com/Mharbulous/SyncoPaid/tree/main/.claude.backup-20241224/skills/story-arborist
Command: npx skills add https://github.com/Mharbulous/SyncoPaid --skill story-arborist

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires sqlite3, story-tree, and includes scripts (resource) components.

What problem does it solve?

This Skill analyzes, diagnoses, and reorganizes the story tree to improve structure and health, while delegating mechanical operations to deterministic scripts.

Core Features & Use Cases

  • Structural health checks: deterministic scripts validate closure table integrity.
  • Semantic organization: AI analysis guides improvements to grouping and hierarchy.
  • Deterministic operations: Move, rename, and reparent operations are handled by scripts to avoid AI drift.

Quick Start

Run tree_health.py to get a health report. If issues are found, use the reparent/move/rename scripts to implement fixes.

Frequently Asked Questions about story-arborist

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check the health of my story tree database?

Story-arborist diagnoses structural and semantic issues in your story-tree.db using deterministic Python scripts. Run tree_health.py to generate a comprehensive health report that validates closure table integrity and identifies problems like orphaned nodes or structural inconsistencies.

What structural issues can story-arborist detect and fix?

Story-arborist detects closure table integrity violations, orphaned nodes, and path inconsistencies through two-phase structural assessment and semantic analysis. It applies deterministic move, rename, and reparent operations to resolve issues while maintaining auditable operation logs.

Can I reorganize my story tree without manual database edits?

Yes. Story-arborist uses isolated deterministic scripts for reparenting, renaming, and moving nodes, eliminating manual SQL edits and AI drift. All mechanical operations produce auditable health reports and operation logs for verification.

How does story-arborist maintain data integrity during reorganization?

Story-arborist combines deterministic Python scripts for mechanical operations with AI-guided semantic analysis. Structural validation precedes any reorganization, and all changes generate detailed operation logs for auditability and rollback verification.

What does story-arborist require to run?

Story-arborist requires sqlite3 for database access and depends on story-tree as its data source. It operates on story-tree.db files and uses Python scripts to perform all diagnostics and reorganization operations.