opsx-diff

Generate structured Markdown or JSON diffs of OpenSpec changes against baseline specs.

9|2|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/fjpulidop/specrails-core --skill opsx-diff
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: opsx-diff
Source: https://github.com/fjpulidop/specrails-core/tree/main/specrails-plugin/skills/opsx-diff
Command: npx skills add https://github.com/fjpulidop/specrails-core --skill opsx-diff

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Visualize and diff OpenSpec changes between a change and the current baseline, surfacing additions, removals, and behavioral modifications.

Core Features & Use Cases

  • Delta-spec diff against the baseline to show exact behavioral changes
  • Per-spec and line-level diffs with contextual summaries
  • Flexible output: Markdown or JSON for downstream tooling
  • Handles delta-spec mode or per-file spec comparisons, including API/contract changes

Quick Start

Invoke /opsx-diff <change-name> to generate a structured diff report.

Frequently Asked Questions about opsx-diff

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

FAQPage Schema
How do I diff OpenSpec changes against the current baseline specs?▼

To diff OpenSpec changes, you can generate a structured report comparing files under openspec/changes with the baseline in openspec/specs to surface added, modified, and removed requirements.

What is a delta-spec comparison in OpenSpec change management?▼

A delta-spec comparison shows exact behavioral changes between a proposed change and the baseline specs, providing contextual summaries of additions, removals, and modifications at the per-file or line level.

Can I output OpenSpec diff results in JSON format for downstream tooling?▼

Yes, you can output OpenSpec diff results in JSON format. This structured output supports downstream tooling and automation alongside the standard markdown report format.

How do I get a summary of added and removed requirements from OpenSpec specs?▼

You can get an itemized summary of added, modified, and removed requirements by running a diff analysis over your repository's OpenSpec changes and baseline specs directories.

Does the OpenSpec diff tool support per-file spec comparisons for API changes?▼

Yes, the diff tool supports per-file spec comparisons, allowing you to analyze specific API and contract changes between your change proposals and the current baseline.