dry-run

Simulate command effects with a --dry-run flag without applying changes.

91|10|Updated Oct 4, 2025
One-click install
npx skills add https://github.com/marcusgoll/Spec-Flow --skill dry-run
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dry-run
Source: https://github.com/marcusgoll/Spec-Flow/tree/main/.claude/skills/dry-run
Command: npx skills add https://github.com/marcusgoll/Spec-Flow --skill dry-run

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Preview command effects without making changes. Simulates file writes, git operations, agent spawns, and state changes. All reads execute normally for accurate preview. Use --dry-run flag on any command.

Core Features & Use Cases

  • Safe testing: simulate writes/edits and state mutations without actual changes
  • Accurate previews: reads run normally to reflect real outcomes
  • Unified preview: standardized summary of what would happen across commands

Quick Start

Invoke any command with the --dry-run flag to see a deterministic preview of outcomes without applying changes.

Frequently Asked Questions about dry-run

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

FAQPage Schema
How do I preview command effects without making actual changes?

Use the --dry-run flag with any command to simulate its effects. The dry-run workflow detects the flag, executes reads normally for accuracy, logs intended writes, avoids side effects, and outputs a standardized summary of what would change without applying modifications.

Can I safely test file writes and git operations before committing them?

Yes. Dry-run simulates file writes, git operations, agent spawns, and state mutations. All reads execute normally to reflect real outcomes, while writes are logged but not applied, giving you a deterministic preview before actual changes.

What happens to reads when I use --dry-run?

Reads execute normally during dry-run to ensure your preview is accurate. Only writes, git operations, agent spawns, and YAML state mutations are simulated and logged, not applied, so you see realistic outcomes based on current state.

Does dry-run work with CI and demonstration scenarios?

Yes. Dry-run is designed for development, testing, CI, and demonstration scenarios. It provides safe previews across file writes, git operations, and state changes without side effects, making it ideal for automated pipelines and walkthroughs.

How is dry-run different from other simulation approaches?

Dry-run applies a unified workflow across multiple operation types—file writes, git operations, agent spawns, and state mutations. It executes reads for accuracy while simulating all side effects and outputs a standardized summary, avoiding incomplete or partial previews.