building-surmise-relations

Identify prerequisite relationships between knowledge items using the QUERY algorithm.

13|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/vanderbilt-data-science/knowledge-spaces --skill building-surmise-relations
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: building-surmise-relations
Source: https://github.com/vanderbilt-data-science/knowledge-spaces/tree/main/.claude/skills/building-surmise-relations
Command: npx skills add https://github.com/vanderbilt-data-science/knowledge-spaces --skill building-surmise-relations

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill helps establish principled prerequisite relationships between knowledge items in a knowledge space by expert querying and structured reasoning, enabling robust knowledge-space construction.

Core Features & Use Cases

  • QUERY-based expert elicitation of direct prerequisites using a formalized questioning protocol.
  • IITA and FCA cross-validation to compare expert-derived relations with data-driven and lattice-based insights.
  • Graph I/O and governance: reading/writing graphs in graphs/*.json, conforming to schemas/knowledge-graph.schema.json, and updating surmise_relations and competence_relations with transitive closure and acyclicity checks.
  • Use Case: Deploy within course materials pipelines to generate a coherent prerequisite structure that supports adaptive assessment and personalized learning paths.

Quick Start

Start by running the surmise-relations workflow on your knowledge graph to produce and persist the updated item prerequisites.

Frequently Asked Questions about building-surmise-relations

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

FAQPage Schema
How do I identify prerequisite relationships between knowledge items in a knowledge space?

The QUERY algorithm elicits direct prerequisites from experts using a formalized questioning protocol, producing a quasi-order of knowledge items to establish principled prerequisite relationships within a knowledge space.

What is the best way to validate expert-derived surmise relations against data-driven methods?

Validating expert-derived surmise relations is best done using IITA and FCA cross-validation, which compares expert-elicited prerequisites with data-driven and lattice-based insights to ensure the knowledge-space structure is robust and coherent.

How do I enforce transitive closure and acyclicity when building a knowledge graph?

To enforce transitive closure and acyclicity when building a knowledge graph, use a structured workflow that checks and updates surmise_relations and competence_relations during graph I/O, ensuring the persisted JSON graph remains valid and cycle-free.

Can I use this prerequisite discovery workflow to support adaptive assessment and personalized learning paths?

Yes, you can use this prerequisite discovery workflow to support adaptive assessment and personalized learning paths by deploying it within course materials pipelines to generate a coherent prerequisite structure across knowledge items.

Does the surmise relations workflow require a specific JSON schema for reading and writing knowledge graphs?

Yes, the surmise relations workflow requires reading and writing graphs in JSON files conforming to the knowledge-graph.schema.json schema, ensuring updated surmise_relations and competence_relations maintain provenance data for audit and reproducibility.

When should I not use expert querying for knowledge space construction?

You should avoid expert querying for knowledge space construction when you lack domain experts available for the formalized questioning protocol, as the QUERY algorithm relies on expert input to accurately identify and codify direct prerequisites.