tla-spec-review

Review TLA+ specifications against a checklist for correctness and TLC validation.

Updated Jan 27, 2026
One-click install
npx skills add https://github.com/photoszzt/tlaplus-ai-tools --skill tla-spec-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tla-spec-review
Source: https://github.com/photoszzt/tlaplus-ai-tools/tree/main/skills/tla-spec-review
Command: npx skills add https://github.com/photoszzt/tlaplus-ai-tools --skill tla-spec-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you systematically review TLA+ specifications, ensuring they are correct, complete, and adhere to best practices, thereby reducing errors and improving the reliability of your formal models.

Core Features & Use Cases

  • Comprehensive Checklist: Provides a detailed checklist covering TLA+ formulas, spec structure, readability, and TLC validation.
  • Common Issue Identification: Highlights frequent pitfalls and syntax errors in TLA+ specifications.
  • MCP Tool Integration: Guides the use of TLA+ MCP tools for parsing, checking, and model validation.
  • Use Case: Before deploying a critical TLA+ specification, use this skill to perform a thorough review, catching potential bugs in invariants, actions, or fairness conditions that could lead to incorrect model checking results.

Quick Start

Use the tla-spec-review skill to check the attached TLA+ specification file 'MySpec.tla' against the review checklist.

Frequently Asked Questions about tla-spec-review

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

FAQPage Schema
How do I review a TLA+ specification for correctness and completeness?

Reviewing a TLA+ specification requires checking formulas, spec structure, readability, and TLC validation. You can systematically verify correctness and completeness by applying a dedicated review checklist that covers invariants, actions, and fairness conditions.

What are common issues to look for when checking TLA+ formulas?

Common issues in TLA+ formulas include frequent pitfalls and syntax errors that compromise formal models. Identifying these issues early ensures robust specification development and prevents incorrect model checking results caused by faulty invariants or actions.

Can I use MCP tools for TLA+ parsing and model checking validation?

You can use MCP tools for TLA+ parsing and model checking validation. Guided integration with these tools helps automate spec checks, ensuring your formal specification adheres to best practices during the model validation process.

What's the best way to validate TLA+ fairness conditions before model checking?

Validating TLA+ fairness conditions involves checking them against a comprehensive review checklist before deploying critical specifications. This systematic approach catches potential bugs in invariants and actions, ensuring correct model checking results.

Why does my TLA+ model checking fail despite syntactically correct formulas?

Model checking can fail due to hidden bugs in TLA+ invariants, actions, or fairness conditions despite correct syntax. Performing a thorough specification review identifies these structural issues and ensures your formal models are complete and robust.