optimus-resolve

Resolve merge conflicts in optimus-tasks.md while preserving state.json status data.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/alexgarzao/optimus --skill optimus-resolve
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: optimus-resolve
Source: https://github.com/alexgarzao/optimus/tree/main/resolve/skills/optimus-resolve
Command: npx skills add https://github.com/alexgarzao/optimus --skill optimus-resolve

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineering teams resolve merge conflicts in optimus-tasks.md caused by parallel edits to the task structure, ensuring critical status data remains in state.json and not in the markdown file.

Core Features & Use Cases

  • Per-task conflict resolution across T-IDs with additive handling for added/removed tasks.
  • Phase-driven approach: detection, resolution, user decisions, and validation.
  • Integration with existing merge workflows (PRs, rebases).

Quick Start

Invoke the optimus-resolve skill when optimus-tasks.md shows merge conflicts and follow the prompts to auto-resolve where possible while requesting user decisions for unresolved fields.

Frequently Asked Questions about optimus-resolve

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

FAQPage Schema
How do I resolve merge conflicts in a markdown task management file?

To resolve merge conflicts in a markdown task management file, the skill parses conflict regions and compares per-task fields across two-way conflicts, safely merging structural columns while preserving status data in state.json. Ambiguous changes are presented for user decisions.

What is the best way to handle git merge conflicts for task IDs without losing status data?

Handling git merge conflicts for task IDs without losing status data requires isolating structural markdown changes from status tracking. The skill safely merges structural columns in optimus-tasks.md while avoiding changes to status data stored in state.json.

How does conflict resolution handle added or removed tasks during a git rebase?

Conflict resolution handles added or removed tasks during a git rebase by applying additive handling across task IDs. It compares per-task fields in two-way conflicts and stages resolved changes for user review after validating against formatting rules.

Can I auto-resolve optimus-tasks.md conflicts while keeping state.json untouched?

You can auto-resolve optimus-tasks.md conflicts while keeping state.json untouched. The skill automatically merges unambiguous structural columns and stages changes, only requesting user decisions for unresolved fields to ensure status data integrity.

Does this conflict resolution approach validate the final markdown file against formatting rules?

This conflict resolution approach validates the final markdown file against the system's formatting rules. After resolving structural conflicts and handling adds or deletes, it ensures the merged output complies with formatting standards before staging.

When should I manually review ambiguous changes during markdown conflict resolution?

You should manually review ambiguous changes during markdown conflict resolution when per-task fields cannot be safely auto-merged. The skill detects these ambiguous changes across task IDs and presents them as user decisions before final validation.