create-microservice

Scaffold a complete Firefly microservice Maven project with five modules.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/fireflyframework/fireflyframework-claude-skills --skill create-microservice-fireflyframework
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-microservice
Source: https://github.com/fireflyframework/fireflyframework-claude-skills/tree/main/skills/create-microservice
Command: npx skills add https://github.com/fireflyframework/fireflyframework-claude-skills --skill create-microservice-fireflyframework

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates scaffolding a complete Firefly Framework microservice project, generating the full five-module Maven structure with interfaces, models, core, web, and sdk modules, following framework conventions.

Core Features & Use Cases

  • Generates the five-module project layout (interfaces, models, core, sdk, web) with a parent POM and consistent naming.
  • Interactively gathers essential inputs (service name, tier, groupId, base Java package, and initial entity) and derives artifactId, package structure, and sample artifacts.
  • Provides starter templates for DTOs, entities, services, and controllers aligned with framework conventions.

Quick Start

Provide service name, tier, groupId, and initial entity name, then run the scaffolding to generate the full multi-module project.

Frequently Asked Questions about create-microservice

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

FAQPage Schema
How do I scaffold a multi-module Maven microservice project?

To scaffold a Maven microservice project, you provide a service name, tier, groupId, and initial entity. The tool then generates a complete five-module Maven structure with interfaces, models, core, web, and sdk modules following framework conventions.

What is the standard project structure for a Firefly Framework microservice?

A Firefly Framework microservice uses a five-module Maven structure: interfaces, models, core, sdk, and web. This layout includes a parent POM and consistent naming derived from your initial service inputs to maintain framework conventions.

How do I generate Java package structures and artifactId from a service name?

You generate package structures and artifactId by providing your service name, tier, and groupId during the interactive scaffolding process. The tool automatically derives the base Java package and artifactId from these inputs to populate the project templates.

Can I generate starter templates for DTOs and controllers in a new microservice?

Yes, you can generate starter templates for DTOs, entities, services, and controllers. By supplying an initial entity name during project creation, the scaffolding process provides sample artifacts aligned with standard framework conventions.

Do I need to manually configure Maven modules when creating a Firefly microservice?

No, you do not need to manually configure Maven modules. The scaffolding process automates the creation of the parent POM and the full five-module layout, ensuring consistent naming and structure across interfaces, models, core, sdk, and web modules.

What inputs are required to start generating a Firefly microservice project?

Required inputs include the service name, tier, groupId, base Java package, and an initial entity name. Providing these allows the scaffolding tool to derive the artifactId, package structure, and generate the necessary multi-module Maven project files.