inspector

Inspect OpenSpec artifacts for gaps, correctness, and consistency.

1|Updated May 7, 2026
One-click install
npx skills add https://github.com/agoodway/GoodSkills --skill inspector-agoodway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: inspector
Source: https://github.com/agoodway/GoodSkills/tree/main/skills/inspector
Command: npx skills add https://github.com/agoodway/GoodSkills --skill inspector-agoodway

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

OpenSpec changes can drift from the codebase or from canonical specs, and UI/flow details can become inconsistent. This Skill helps you inspect those OpenSpec artifacts for gaps, correctness, and alignment before you implement or archive the change.

Core Features & Use Cases

  • OpenSpec change audit (review): identify missing scenarios, correctness issues, consistency problems, and misalignment with canonical specs and related changes.
  • Fast fix pass (review-update): auto-patch findings that have clear mechanical fixes, then ask you about the rest.
  • Spec-to-tracker workflow (sync-linear): keep a Linear issue in sync with the current proposal/tasks state.
  • Codebase-to-spec reconciliation (reconcile): detect codebase drift vs the proposed tasks/deltas and patch change artifacts to match reality.
  • Prose + diagram explanations (explain, mockups, flows): generate human-readable documentation with ASCII diagrams and wireframes to clarify impact and intent.

Quick Start

Ask for a targeted inspection by instructing the AI to run: "Run /inspector review <change-id> to audit the specified OpenSpec change and produce an inspection report."

Frequently Asked Questions about inspector

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

FAQPage Schema
How do I audit OpenSpec artifacts for gaps and codebase alignment?

To audit OpenSpec artifacts for gaps and alignment, run a targeted inspection to identify missing scenarios, correctness issues, and consistency problems against canonical specs and the current codebase, producing a detailed inspection report.

What is the best way to reconcile codebase drift with proposed OpenSpec deltas?

The best way to reconcile codebase drift with proposed OpenSpec deltas is through a reconciliation process that detects divergence between tasks/deltas and reality, then patches change artifacts to match the actual codebase state.

How do I keep a Linear issue in sync with OpenSpec proposal and task states?

You keep a Linear issue in sync with OpenSpec proposal and task states by using a spec-to-tracker workflow that maps the current proposal and tasks state directly to the Linear issue, ensuring both remain aligned.

Can I automatically fix OpenSpec spec review findings that have clear mechanical solutions?

Yes, you can automatically fix OpenSpec spec review findings with clear mechanical solutions using a fast fix pass that auto-patches straightforward issues, then prompts for manual input on remaining complex findings.

Does OpenSpec inspection work across different AI coding environments like Claude Code and Codex?

Yes, OpenSpec inspection works across different AI coding environments by preserving runtime compatibility across Claude Code, OpenCode, and Codex, ensuring the audit and reconciliation workflows function consistently in each environment.

How do I generate ASCII diagrams and wireframes to explain OpenSpec change impact?

You generate ASCII diagrams and wireframes to explain OpenSpec change impact by dispatching to dedicated explanation workflows that produce human-readable documentation, clarifying the intent and impact of proposed changes.