stub-generator - SKILL.md Agent Skill

name: stub-generator description: 'Generate code scaffolding based on a plan including function signatures, class structures, and interface definitions with docstrings and TODOs. Produces skeleton code for the Coder agent to implement.'

Stub Generator Skill

When given a design or task, use this skill to create skeleton code that outlines the structure without implementing logic. For each component or function:

Define Interfaces – Declare classes, modules, methods and functions with meaningful names that match the specification. Keep the public API clear.
Docstrings & Comments – Add docstrings or comments describing the purpose, parameters and return values. Specify any preconditions or postconditions.
TODO Markers – Leave TODOs or pass statements (or raise NotImplementedError() in Python) in place of implementation. Do not fill in business logic.
Type Hints – Include type hints or annotations where appropriate to clarify expected types and return values.
File Organisation – Organise code into files and modules according to the planned architecture. Create directories if needed.
Minimal Imports – Import only necessary packages for definitions (e.g. dataclasses, typing). Avoid pulling in heavy dependencies at this stage.

This scaffolding should make it easy for the Coder agent to complete the implementation. Do not implement actual logic or add tests here.