nanobrain-step-authoring

Define structural requirements for authoring BaseStep subclasses in the nanobrain framework.

3|Updated Apr 27, 2026
One-click install
npx skills add https://github.com/AlexandrNP/apecx-mcp-integration --skill nanobrain-step-authoring
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nanobrain-step-authoring
Source: https://github.com/AlexandrNP/apecx-mcp-integration/tree/main/.claude/skills/nanobrain-step-authoring
Command: npx skills add https://github.com/AlexandrNP/apecx-mcp-integration --skill nanobrain-step-authoring

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents common architectural errors when creating processing steps in the nanobrain framework, such as silent failures, incorrect method overrides, and improper data unit wiring.

Core Features & Use Cases

  • Contract Enforcement: Provides the exact specifications for the execute/process/_execute_process triad to ensure framework compatibility.
  • FAIL-FAST Validation: Details the specific error messages and requirements for step initialization, including async requirements and logger usage.
  • Use Case: When building a new custom processing step, use this guide to verify your class structure, YAML configuration, and trigger logic to ensure the step executes reliably within a workflow.

Quick Start

Consult the nanobrain step authoring skill to validate your new step class implementation and ensure your process method follows the required async contract.

Frequently Asked Questions about nanobrain-step-authoring

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

FAQPage Schema
How do I implement a custom workflow step in nanobrain?

To implement a custom workflow step, you must author a BaseStep subclass with a strict async process method signature and configure data units using YAML to ensure reliable framework execution.

What is the required method signature for nanobrain step authoring?

Nanobrain step authoring requires strict adherence to an async process method signature, utilizing the execute/process/_execute_process triad to enforce framework compatibility and prevent silent failures.

Why does my nanobrain workflow step fail silently during execution?

Silent failures in nanobrain workflow steps usually stem from improper data unit wiring or incorrect method overrides, which this step authoring guide prevents through fail-fast validation and contract enforcement.

Do I need YAML configuration to build a validation pipeline in nanobrain?

Yes, YAML-based configuration of data units is required when building validation pipelines and custom workflow steps in nanobrain to properly wire data and triggers.

When should I not use BaseStep subclasses for async processing logic?

You should not use BaseStep subclasses if you cannot adhere to the strict async process method contract, as bypassing framework-provided primitives causes initialization errors and improper step execution.