awaitly-patterns

Build typed async workflows with automatic error inference using run and createWorkflow patterns.

1|Updated Jan 17, 2026
One-click install
npx skills add https://github.com/jagreehal/awaitly --skill awaitly-patterns
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: awaitly-patterns
Source: https://github.com/jagreehal/awaitly/tree/main/.claude/skills/awaitly-patterns
Command: npx skills add https://github.com/jagreehal/awaitly --skill awaitly-patterns

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Patterns for building typed async workflows with automatic error inference in awaitly, replacing brittle try/catch logic.

Core Features & Use Cases

  • Step-based workflow composition with run() and createWorkflow(deps) for dependency injection.
  • Automatic error inference and normalization across steps, support for retries, timeouts, and boundary handling.
  • Guidance for per-item steps, loops, concurrency, and testing patterns.

Quick Start

Create a small workflow using step helpers and a DI container to see typed errors.

Frequently Asked Questions about awaitly-patterns

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

FAQPage Schema
How do I build typed async workflows with automatic error inference?

Typed async workflows use step-based composition with run() and createWorkflow(deps) to automatically infer and normalize errors across multi-step processes. This replaces brittle try/catch logic by requiring dependencies to return AsyncResult values for static analysis.

What is the best way to handle errors across multi-step async processes without try/catch?

Automatic error inference normalizes errors across workflow steps by requiring dependencies to return AsyncResult values. Using run and createWorkflow patterns ensures errors propagate predictably across multi-step async processes without manual try/catch blocks.

How do I add retries and timeouts to async workflows using dependency injection?

Async workflows support retries, timeouts, and boundary error handling through dependency injection. Pass dependencies returning AsyncResult values into createWorkflow(deps), then configure retry and timeout logic within the step composition using the run pattern.

Does awaitly-patterns work for testing async workflows with concurrency and loops?

Testing async workflows supports per-item steps, loops, and concurrency patterns. Static analysis tooling validates typed errors during testing, ensuring your async workflow logic handles concurrent operations and boundary errors correctly across multi-step processes.

Can I use createWorkflow for dependency injection in endpoint boundary error handling?

createWorkflow(deps) applies dependency injection to endpoint boundary error handling by passing dependencies that return AsyncResult values. This pattern ensures automatic error inference and normalization across endpoint boundaries in DI-heavy applications.