moai-workflow-templates

Generates code boilerplates, GitHub issue templates, and smart template merges for project scaffolding.

2|Updated May 27, 2026
One-click install
npx skills add https://github.com/yekinya/moai-novel --skill moai-workflow-templates-yekinya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: moai-workflow-templates
Source: https://github.com/yekinya/moai-novel/tree/main/moai-novel/.claude/skills/moai-workflow-templates
Command: npx skills add https://github.com/yekinya/moai-novel --skill moai-workflow-templates-yekinya

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Starting new projects, writing consistent GitHub issues, and updating shared templates without losing customizations are repetitive and error-prone tasks. This Skill centralizes code boilerplates, feedback templates, and template optimization into one managed workflow. ## Core Features & Use Cases - Code Template Scaffolding: Generate production-ready project structures for FastAPI, Django, React, Next.js, Vue, Docker, and CI/CD with configurable template variables. - GitHub Feedback Templates: Create structured issues across 6 types (bug, feature, improvement, refactor, docs, question), auto-triggered by the /moai:9-feedback command. - Smart Template Merge: Apply template updates with a three-way merge that preserves user customizations, creates backups, and tracks version history. - Use Case: When MoAI-ADK releases an update, run the template optimizer to back up your project, merge the new template defaults, and retain your language, team, and domain settings automatically. ## Quick Start Ask the AI to scaffold a new FastAPI project named my-api with authentication, database, and Celery features using the backend template.

Frequently Asked Questions about moai-workflow-templates

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

FAQPage Schema
How do I scaffold a FastAPI project with a template?

Load the backend/fastapi template and call scaffold with a project name, feature list such as auth, database, and celery, and customizations like database type. The template generates the full project structure including tests, Docker, and CI/CD configuration.

How do I create a GitHub issue from a feedback template?

Run the /moai:9-feedback command with a description, and the skill classifies the input into one of 6 template types such as bug or feature. It then populates the template fields and generates a structured GitHub issue automatically.

What frameworks do the code templates support?

The library includes FastAPI, Django, and Express.js for backend, React, Next.js 15, and Vue 3 for frontend, plus Docker, GitHub Actions CI/CD, and Kubernetes for infrastructure. Testing templates cover Pytest, Vitest, and Playwright.

Does template updating preserve my custom settings?

Yes, the smart merge uses a three-way algorithm that extracts user customizations from a backup before applying template updates. Settings like language, team configuration, and domains are preserved while template structure is updated.

Why does a template merge fail or create conflicts?

Conflicts occur when both the template and user customizations changed the same sections significantly. Always create a backup before merging, review conflicts in the merge output, and restore from the backup if the merge fails.

When should I not edit template files directly?

Never edit files under .claude/ or .moai/ directly, because MoAI updates overwrite local copies. Edit the template source in internal/template/templates/ and run make build so changes persist across updates.