tachikoma-schema

Analyze Context Lake workspaces to propose schema improvements and generate decision files.

1|1|Updated Nov 19, 2025

Search Tags:#schema #analysis #cleanup #yaml #workspace #tachikoma

Ready to run

npx skills add https://github.com/joshuacook/motoko --skill tachikoma-schema

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: tachikoma-schema
Source: https://github.com/joshuacook/motoko/tree/main/.claude/skills/tachikoma-schema
Command: npx skills add https://github.com/joshuacook/motoko --skill tachikoma-schema

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill analyzes a Context Lake workspace and proposes schema improvements, guiding the creation of decisions in decisions/.

Core Features & Use Cases

Workspace analysis: Inspect workspace structure and existing schema.
Decision generation: Propose schema updates in a consolidated decision.
Summary update: Record findings in tachikoma-summary.yaml for traceability.

Quick Start

Run tachikoma-schema to scan a workspace and generate a consolidated decision file in decisions/.

Frequently Asked Questions about tachikoma-schema

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

FAQPage Schema

How do I analyze and improve my workspace schema in a Context Lake?▼

Schema analysis examines your workspace structure and proposes improvements by sampling entity types, identifying naming patterns, and generating consolidated decisions. Run tachikoma-schema to scan your workspace, read schema.yaml and tachikoma-summary.yaml, then create decision files documenting recommended schema updates.

What does a workspace schema cleanup process involve?▼

Schema cleanup involves inspecting your existing schema.yaml, sampling markdown files to identify entity type patterns, proposing naming consistency improvements, and recording findings in decisions/. The process creates traceability by updating tachikoma-summary.yaml with analysis results.

Can I use schema analysis when updating entity types in YAML?▼

Yes. Schema analysis is designed for creating or updating schema.yaml by first identifying entity types across your workspace. It samples multiple markdown files per candidate type, detects naming patterns, and proposes entity type definitions before you finalize schema changes.

How does workspace root directory analysis help with schema design?▼

Listing and analyzing workspace root directories reveals structural patterns that inform entity type definitions. Schema analysis uses these patterns alongside markdown sampling to propose entities that align with your actual workspace organization.

What's the relationship between tachikoma-summary.yaml and schema decisions?▼

Tachikoma-summary.yaml records findings from workspace analysis, providing traceability for schema improvement decisions. After schema analysis generates decision files, the summary is updated to document what was proposed and why.