tutorial-guide-orientation

Teaches Lingtai orientation lessons by discovering live architecture and directory contents.

692|60|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/Lingtai-AI/lingtai --skill tutorial-guide-orientation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tutorial-guide-orientation
Source: https://github.com/Lingtai-AI/lingtai/tree/main/tui/internal/preset/skills/lingtai-tutorial-guide/reference/orientation
Command: npx skills add https://github.com/Lingtai-AI/lingtai --skill tutorial-guide-orientation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

New Lingtai users lack a guided way to understand the platform's architecture, global configuration directory, and per-project agent working directories without reading static documentation that may be stale.

Core Features & Use Cases

  • Live Architecture Discovery: Dispatches daemons to locate and explore the lingtai-kernel and lingtai wrapper packages, counting actual capabilities, addons, and intrinsics instead of reciting fixed numbers.
  • Guided Directory Walkthroughs: Inspects ~/.lingtai-tui/ presets, covenant, principles, procedures, and templates, plus the project-level .lingtai/ directory and the agent's own working directory.
  • Use Case: A new user starting lessons 1-3 of the Lingtai tutorial gets an interactive tour where the Guide agent runs real commands (ls, glob, python introspection) to show what actually exists on their machine.

Quick Start

Ask the Guide agent to start lesson 1 of the Lingtai tutorial and walk you through the architecture and directories.

Frequently Asked Questions about tutorial-guide-orientation

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

FAQPage Schema
How do I learn the Lingtai architecture interactively?

Start lesson 1 of the tutorial guide, which dispatches two daemons to locate the lingtai-kernel and lingtai wrapper package install paths and explore their contents. The guide presents the actual capabilities, addons, and intrinsics found rather than reciting fixed numbers.

What is inside the ~/.lingtai-tui/ global directory?

The directory contains presets, the covenant, principle files defining how agents perceive the user role, procedures, soul flow files, templates, recipes, and an auto-generated commands.json slash command reference. Lesson 2 walks through each item by reading the real files.

How do Lingtai agents and humans share directory structure?

Agents and humans are peers with the same structure under the project .lingtai/ directory, each having an .agent.json and mailbox/. Lesson 3 shows the human's .agent.json and the agent's own working directory including init.json, system/, logs/, history/, and signal files.

Does the tutorial guide work without an installed lingtai-kernel?

The architecture discovery lesson requires lingtai-kernel to be importable in Python so daemons can locate its install path. Without it, the live exploration of intrinsics, services, and base_agent cannot run.

What are Lingtai signal files like .sleep and .suspend?

Signal files such as .sleep, .suspend, .interrupt, and .prompt live in an agent's working directory and control its runtime state. Lesson 3 of the orientation guide lists these files by globbing the agent's actual working directory.