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.