analyze

Compare spec.md, plan.md, and tasks.md to produce a read-only Markdown audit report.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/XinheLIU/human-leverage --skill analyze-xinheliu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: analyze
Source: https://github.com/XinheLIU/human-leverage/tree/main/.claude/skills/analyze
Command: npx skills add https://github.com/XinheLIU/human-leverage --skill analyze-xinheliu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Non-destructive cross-artifact consistency and constitution audit across spec.md, plan.md, and tasks.md. Use after /tasks and before implementation to catch duplication, ambiguity, terminology drift, coverage gaps, and constitution violations. Read-only — produces a report, never edits files.

Core Features & Use Cases

  • Read-only audit that analyzes spec.md, plan.md, and tasks.md for inconsistencies, ambiguities, and gaps.
  • Generates a structured Markdown report detailing findings, coverage gaps, and constitutional alignment without modifying any files.
  • Deterministic outputs with stable IDs to support reproducible reviews across runs.

Quick Start

Invoke the analyze skill after updating /spec, /plan, and /tasks to generate a read-only consistency report.

Frequently Asked Questions about analyze

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

FAQPage Schema
How do I audit cross-artifact consistency between spec, plan, and tasks files?

A read-only consistency audit compares spec.md, plan.md, and tasks.md to identify duplication, ambiguity, terminology drift, and coverage gaps. It generates a deterministic Markdown report detailing findings and constitutional alignment without modifying any source files.

When do I need to run a specification consistency check?

You need a specification consistency check after finishing your tasks breakdown and before starting implementation. This timing verifies coherence across your planning artifacts, catching constitutional misalignments and coverage gaps early when they are least expensive to resolve.

Can I check plan and tasks alignment without modifying my specification files?

Yes, you can check alignment without modifications by using a strictly read-only audit workflow. It analyzes the existing documents and outputs a structured Markdown report with stable IDs for reproducible reviews, ensuring your spec.md, plan.md, and tasks.md remain untouched.

What is terminology drift and how does a spec audit detect it?

Terminology drift occurs when inconsistent vocabulary is used across specification, planning, and task documents. A spec audit detects this by cross-referencing the text in spec.md, plan.md, and tasks.md, flagging ambiguous terms and inconsistencies in a structured findings report.

Do I need spec, plan, and tasks files to run a documentation audit?

Yes, the documentation audit strictly requires spec.md, plan.md, and tasks.md files to exist. The analysis cross-references all three artifacts to identify coverage gaps and constitutional misalignments, meaning it cannot run if any prerequisite file is missing.

What's the best way to verify constitution alignment before implementation?

The best way to verify constitution alignment is to run a deterministic audit comparing your specifications against constitutional rules. This generates a structured Markdown report with stable IDs, highlighting misalignments and coverage gaps for review before you begin implementation.