speckit-scaffold-module

Generate a Python module set with contracts, domain models, repository protocols, services, and unit tests.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/Satcomx00-x00/speckit-python --skill speckit-scaffold-module
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-scaffold-module
Source: https://github.com/Satcomx00-x00/speckit-python/tree/main/skills/speckit-scaffold-module
Command: npx skills add https://github.com/Satcomx00-x00/speckit-python --skill speckit-scaffold-module

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyproject-toml, mypy, ruff, pytest, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the need for generating a complete Python module set for a single entity, including contracts, domain models, repository protocols, services, and unit tests, without manual coding.

Core Features & Use Cases

  • Module Generation: Automatically generates contracts, domain models, repository protocols, services, and unit tests for a specified entity.
  • Type Safety: Ensures that all generated code is type-safe and follows strict type annotations.
  • Reproducibility: Ensures that the generated code is reproducible and can be verified with the same tools used during the CI process.

Quick Start

Run the following command to generate a module for the 'entity' entity:

/speckit-scaffold-module entity

Frequently Asked Questions about speckit-scaffold-module

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

FAQPage Schema
How do I generate a Python module set with domain models and unit tests for an entity?

You can generate a complete Python module set for a single entity by running a scaffold command. This automatically creates contracts, domain models, repository protocols, services, and unit tests without manual coding.

What's the best way to ensure type safety in generated Python domain models and services?

Generated Python modules ensure type safety by following strict type annotations throughout the code. The output is validated using mypy and ruff to guarantee type safety and reproducibility during the generation process.

Do I need pytest and mypy installed to generate reproducible Python module sets?

Yes, generating and validating reproducible Python module sets requires Python along with libraries like pytest and mypy. These dependencies verify the generated contracts, domain models, and services match CI process standards.

Can I automatically generate repository protocols and service layers for a single Python entity?

Yes, module generation automatically creates repository protocols and service layers for a specified entity. It outputs a comprehensive Python module set including contracts, domain models, and unit tests in one command.

How does generating unit tests alongside domain models improve Python code reproducibility?

Generating unit tests alongside domain models improves reproducibility by ensuring the Python module set can be verified with the same tools used during CI. This validates type safety and functional correctness automatically.