What makes this different from a standard tutorial?

While tutorials teach basic concepts, this skill focuses on how-to guides which are goal-oriented, helping users solve a concrete, realistic problem using ZIO Blocks.

How does it handle the research phase?

The skill utilizes a systematic research procedure (often involving the docs-research tool) to analyze source files, tests, and repository history before writing.

Is the output compatible with Docusaurus?

Absolutely. It generates the necessary frontmatter, file structures, and Docusaurus-specific admonitions (tips, warnings) used in modern documentation sites.

Does it ensure the Scala code examples actually work?

Yes, the skill follows mdoc conventions and specific ZIO Blocks patterns to ensure examples are compile-ready and technically accurate.

ZIO Blocks How-To Guide Architect

Name: ZIO Blocks How-To Guide Architect
Author: zio

byzio

•

119

•

学习与文档

Generates professional, goal-oriented how-to guides for ZIO Blocks that bridge the gap between API references and basic tutorials.

This skill provides a structured methodology for creating high-quality documentation specifically for the ZIO Blocks ecosystem. It guides the AI through a deep research phase to understand data types and patterns, designs a progressive narrative arc, and produces Docusaurus-ready Markdown. By focusing on realistic problem-solving rather than abstract theory, it ensures that developers receive practical, compile-checked walkthroughs for building cloud-native applications.

主要功能

01Docusaurus-compatible Markdown and admonition formatting

02Deep research integration using source code and GitHub history

03119 GitHub stars

04Automated creation of companion runnable examples

05Problem-first framing to establish developer motivation

06Incremental narrative structure with verified mdoc code blocks

使用场景

01Creating step-by-step guides for new ZIO Blocks data types

02Documenting complex cloud-native implementation patterns

03Standardizing documentation workflows for Scala library maintainers

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add zio/zio-blocks docs-how-to-guide

For use in Claude.ai and ChatGPT