wellcrafted-devOfficial·24 Agent Skills Included

wellcrafted

Type-safe error handling, Result types, and query factories

Defines typed, serializable error variants and Result types for TypeScript applications. Replaces fragile try-catch blocks with linear guard clauses that keep full type information across logs, workers, and network boundaries. Includes patterns for service layers, TanStack Query integration, branded types, and factory composition to ship reliable code faster.

35|4

↗

npx skills add wellcrafted-dev/wellcrafted --all -g -y

Available:

Tells your AI agent how the repository is structured, which build and test commands to run with bun, and where the internal contributor skills versus the distributable user skills live.

All Skills in This Repository (24)

Pure Emerald Level Indicators

📦 In Repo

wellcrafted-dev

incremental-commits

Break multi-file code changes into atomic, dependency-ordered commits.

documentation

Generate folder READMEs, JSDoc comments, and code comments.

error-handling

Replace try-catch blocks with wellcrafted's trySync and tryAsync functions.

writing-voice

Refine written content to eliminate AI-generated patterns and enhance natural prose.

specification-writing

Generate structured technical specification documents for software features.

honesty

Enforce direct, critical feedback in code reviews and technical discussions.

factory-function-composition

Compose clients and services using factory functions with dependency injection.

method-shorthand-jsdoc

Refactor factory functions to preserve JSDoc comments using method shorthand.

technical-articles

Guide technical article creation with structure, style, and content principles.

typescript

Enforces TypeScript style, naming conventions, Arktype patterns, and test organization for coding tasks.

define-errors

Define typed, serializable error variants in TypeScript with defineErrors.

testing

Enforce unit and integration test best practices for TypeScript projects.

Official

Basic

Frequently Asked Questions

FAQPage Schema

How to install wellcrafted?▼

Run `npx skills add wellcrafted-dev/wellcrafted --all -g -y` in your terminal to install all skills in this suite globally.

What problem does wellcrafted solve?▼

It replaces try-catch with typed Result objects so your errors keep their type and survive JSON serialization, Web Workers, and IPC boundaries. You define every failure mode once and handle each one explicitly.

How do I define typed errors in TypeScript?▼

Use the define-errors skill: group all failure modes for a domain in one defineErrors call, and each variant factory returns a ready-to-use Err with a typed name field you can switch on.

Does wellcrafted work with TanStack Query?▼

Yes. The query-factories skill shows how to build queries and mutations that return Result types, with reactive options for components and imperative helpers for event handlers.

Can I use these skills without knowing the library?▼

Yes. Each skill teaches your agent the exact patterns—error definitions, Result handling, service layers—so it writes correct wellcrafted code from plain-English requests.