gspec-analyze

Analyze gspec specification documents to identify substantive discrepancies and guide user-approved reconciliation.

6|2|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/gballer77/gspec --skill gspec-analyze
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gspec-analyze
Source: https://github.com/gballer77/gspec/tree/main/pages/.claude/skills/gspec-analyze
Command: npx skills add https://github.com/gballer77/gspec --skill gspec-analyze

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyze across all gspec specification documents to identify substantive conflicts and inconsistencies, and guide user-driven reconciliation to achieve a coherent spec set.

Core Features & Use Cases

  • Cross-reference all gspec docs (profile.md, stack.md, style.md, practices.md, architecture.md, research.md, features/*.md) to surface substantive discrepancies.
  • Propose 2-3 resolution options per discrepancy and update affected specs only after user approval.
  • Ensure the spec suite remains in-sync without creating new files, preserving original document structure.

Quick Start

Start the analysis to detect discrepancies across all gspec documents and present each conflict for user-approved resolution.

Frequently Asked Questions about gspec-analyze

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

FAQPage Schema
How do I identify discrepancies across multiple specification documents?

Cross-referencing multiple specification documents detects discrepancies by scanning all gspec files for overlapping functionality, constraints, or data models. It analyzes profile, stack, style, practices, architecture, research, and feature docs to surface substantive conflicts.

What is the best way to resolve conflicts between overlapping software specifications?

Resolving conflicts between overlapping software specifications involves proposing 2-3 resolution options per discrepancy and applying controlled in-place updates only after user approval. This guided reconciliation ensures the spec suite remains coherent without altering original document structures.

Can I synchronize multiple specification files without creating new documents?

Yes, you can synchronize multiple specification files without creating new documents. The Skill performs controlled in-place updates on affected specs, preserving the original document structure while ensuring the entire spec suite remains in-sync after conflict resolution.

How does cross-document validation work for gspec specifications?

Cross-document validation for gspec specifications works by scanning all documents including profile.md, stack.md, and features/*.md to detect substantive inconsistencies. It reports each conflict and guides user-driven reconciliation to achieve a coherent spec set.

When do I need to run a specification conflict analysis?

You need to run a specification conflict analysis when multiple specs describe overlapping functionality, constraints, or data models. It is required for cross-document validation, conflict reporting, and controlled in-place updates to maintain a coherent spec set.