moai-project-template-optimizer

Compare and merge Moai project templates with backups and package defaults.

Updated Dec 2, 2025
One-click install
npx skills add https://github.com/dolsoon/my-awesome-project --skill moai-project-template-optimizer-dolsoon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: moai-project-template-optimizer
Source: https://github.com/dolsoon/my-awesome-project/tree/main/.claude/skills/moai-project-template-optimizer
Command: npx skills add https://github.com/dolsoon/my-awesome-project --skill moai-project-template-optimizer-dolsoon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The moai-project-template-optimizer manages intelligent template comparison and optimization workflows, detects backups, preserves user customizations, and produces update reports.

Core Features & Use Cases

  • Automatic Backup Detection: Finds existing project backups.
  • Intelligent Comparison: Analyzes diffs across current, backup, and package templates.
  • Smart Merging: Preserves user customizations while applying template updates.
  • Conflict Resolution: Handles template vs user-content conflicts with options.
  • Update Reporting: Generates comprehensive change documentation.

Quick Start

Run the optimizer to compare backups with current templates and package templates, and perform a smart merge with user approval.

Frequently Asked Questions about moai-project-template-optimizer

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

FAQPage Schema
How do I handle template drift when updating Moai project templates?

Template drift occurs when local customizations diverge from package defaults during version updates. Smart template merging automatically compares your current template, backups, and package defaults to preserve customizations while applying updates, reducing manual conflict resolution.

Can I merge local template changes with package updates automatically?

Yes. Three-way merge logic combines the latest package template defaults, your preserved customizations from backups, and current state into a single merged result. The process detects conflicts and reports changes for approval before applying updates.

How does backup detection work in template synchronization?

Automatic backup discovery identifies existing project backups across development and deployment scenarios. These backups serve as the source of truth for user customizations, enabling the merge process to distinguish intentional changes from default values.

What happens when template conflicts arise during version upgrades?

Conflict resolution evaluates differences between template versions and user content, presenting options to handle template vs user-content disputes. A comprehensive change report documents all modifications, ensuring traceability and letting you review updates before committing.

Do I need manual intervention to apply template updates safely?

The optimizer automates comparison, merging, and conflict detection, but requires user approval before finalizing updates. This balances automation with control, letting you review proposed changes and customize resolution strategies per conflict.