stubs

Generate TypeScript/JavaScript types, interfaces, and stub implementations with NotImplemented errors.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/sofer/.agents --skill stubs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stubs
Source: https://github.com/sofer/.agents/tree/main/skills/stubs
Command: npx skills add https://github.com/sofer/.agents --skill stubs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create interfaces, type definitions, and stub implementations that compile but are not functional. Use after design-review approval to establish code structure before writing tests. Enables TDD red-green-refactor cycle.

Core Features & Use Cases

  • Establishes the code skeleton: types, interfaces, repositories, services, controllers, and routes that compile but lack business logic.
  • Enables parallel development and test-driven design by allowing teams to write tests against interfaces before implementations.
  • Provides clear NotImplemented placeholders to guide downstream development and ensure early validation of architecture.

Quick Start

Generate the full set of skeletons for a new feature from the design outputs and wire them for compilation.

Frequently Asked Questions about stubs

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

FAQPage Schema
How do I create compile-ready TypeScript skeletons for TDD?

To create compile-ready TypeScript skeletons for TDD, generate types, interfaces, and stub implementations with explicit NotImplemented errors. This scaffolding supports dependency injection and allows teams to write tests against interfaces before actual logic is implemented.

What are stub implementations and when do I need them for test-driven development?

Stub implementations are code structures like interfaces and repositories that compile but lack business logic. You need them after design-review approval to establish code structure before writing tests, enabling the TDD red-green-refactor cycle.

Can I generate stubs for JavaScript projects or is this only for TypeScript?

You can generate stubs for both JavaScript and TypeScript projects. The scaffolding applies to TypeScript and JavaScript environments where design outputs require mock components to drive tests before actual logic is implemented.

What's the best way to scaffold interfaces and mock components before writing tests?

The best way to scaffold interfaces and mock components is to generate type definitions, services, controllers, and routes with clear NotImplemented placeholders. This ensures early validation of architecture and enables parallel development across teams.

Why do my TypeScript stubs fail to compile when wiring up new features?

TypeScript stubs may fail to compile if dependency injection interfaces and explicit exports are not properly wired. Ensure the generated skeleton includes clean exports and type definitions that align with the project's compilation requirements.