all publishers

zio

@zio source repo

52 published skills

  1. ▌
    Docs Ascii Diagram · zio
    How to produce an ASCII diagram that is actually aligned — generate it from a Python script with a width assertion, never by hand. Use when a page needs a box-and-arrow diagram, such as a module reference's "How They Work Together" section or a tutorial's data-flow picture.
    7 repo stars
  2. ▌
    Docs Markdown Table · zio
    How to produce a Markdown table that is aligned and structurally valid — generate it from a Python script with a cell-count and escaping check, never by hand. Use when a page compares things across three or more columns, such as a type roster, an edge-case table, or a variant comparison.
    7 repo stars
  3. ▌
    Docs Integrate · zio
    Shared integration checklist for new ZIO library documentation pages. Include after writing any new reference page or how-to guide to ensure it is wired into the site navigation.
    7 repo stars
  4. ▌
    Docs Module Ref · zio
    Write reference documentation for a module containing multiple related data types. Use when documenting a cohesive domain model (HTTP model, resource management) where types work together. Produces comprehensive type-level pages plus module-level narrative showing relationships, patterns, and composition.
    7 repo stars
  5. ▌
    Zio HTTP Knowledge · zio
    Stop and consult this skill whenever your response would involve any fact or code related to ZIO HTTP. Covers: installation and setup, routing (Routes, RoutePattern, PathCodec), handlers and HandlerAspect, the declarative Endpoint API and HttpCodec, client and server configuration, middleware, request/response/headers/cookies, WebSockets, Server-Sent Events, Body and binary codecs, form data, template DSL, OpenAPI documentation and code generation, authentication (basic, digest, bearer, JWT, OAuth, WebAuthn), TLS/SSL/mTLS, testing, ZIO Config integration, Datastar/HTMX integration, migration, and any ZIO HTTP library versions or dependencies. Trigger this even for coding tasks that import zio.http, content that mentions ZIO HTTP features or types, or comparisons involving ZIO HTTP. Any time you would otherwise rely on memory for ZIO HTTP details, verify here instead — your training data may be outdated or wrong.
    7 repo stars
  6. ▌
    Docs Document Pr · zio bundle
    Decide, from a bare PR number, whether it needs a full new page, a subsection on an existing page, or nothing at all — then name the right skill for the job, writing nothing itself. Use when the user asks to document a PR and it is not already clear whether that means a new page or an addition to one that exists.
    7 repo stars
  7. ▌
    Setup Skill Hook · zio
    Use this skill once to automatically install the ZIO skill attribution hook. After installation, all commits will automatically track which skills were used and include their versions.
    7 repo stars
  8. ▌
    Docs Cross Linker · zio bundle
    Make one or more existing ZIO documentation pages reachable by adding inbound prose links from pages that already discuss their subject. Use when a page is finished but nothing links to it, or the user asks to "cross-link", "make reachable", or "fix orphan pages".
    7 repo stars
  9. ▌
    Docs How To Guide · zio bundle
    Write a how-to guide on a specific topic in a ZIO library. Use when the user asks to write a guide or walkthrough that teaches how to accomplish a concrete goal using the library's data types and APIs.
    7 repo stars
  10. ▌
    Docs Data Type Ref · zio bundle
    Write a reference documentation page for a specific data type in a ZIO library. Use when the user asks to document a data type, write an API reference for a type, or create a reference page for a class/trait/object.
    7 repo stars
  11. ▌
    Docs Pr Subsection · zio
    Turn a GitHub pull request into one subsection appended to a page that already documents the area it touches — no new page, no sidebar edit. Use for a PR that only enhances or fixes something already documented, or when the docs-document-pr skill names this as the subsection case.
    7 repo stars
  12. ▌
    Docs Writing Style · zio bundle
    Prose style rules for documentation (reference pages, how-to guides, tutorials). Use this skill whenever writing or editing documentation to ensure consistency, clarity, and professionalism across all docs.
    7 repo stars
  13. ▌
    Docs Enrich Section · zio bundle
    Use when a documentation section exists but lacks motivation or use-cases — thin sections that show a signature and a toy example but never explain why a reader would choose this API over alternatives.
    7 repo stars
  14. ▌
    Docs Organize Types · zio
    Organize related data types into logical categories within sidebars.js. Use this skill to group data types by functionality (e.g., "Collections", "Type System", "Resource Management", "DI & Configuration"). Supports manual categorization (specify types and category) or automatic analysis (scan docs/reference/ and suggest intelligent groupings). The skill updates sidebars.js while preserving existing structure, maintains alphabetical order, and verifies syntax validity.
    7 repo stars
  15. ▌
    Docs Check Compliance · zio
    Audit a documentation file against a rule skill. Checks each rule, fixes violations with separate commits, then compiles with mdoc. Reusable across any rule skill and doc file.
    7 repo stars
  16. ▌
    Docs Mdoc Conventions · zio bundle
    Shared reference for mdoc code block modifiers and Docusaurus admonitions used across ZIO library documentation skills. Include when writing any documentation that contains Scala code blocks.
    7 repo stars
  17. ▌
    Docs Backfill Metadata · zio bundle
    Fill in the missing `description` and `keywords` frontmatter fields on one documentation page, without touching anything else on it. Use when a page has no description or keywords for Docusaurus to index it with, or the user asks to "backfill metadata" or "add frontmatter".
    7 repo stars
  18. ▌
    Docs Reduce Redundancy · zio
    Remove redundant content from documentation. Use when sections repeat information unnecessarily, type definitions appear multiple times, concepts are introduced more than once, or transition words clutter meaning. Reduces cognitive load through deduplication and strategic cross-referencing.
    7 repo stars
  19. ▌
    Docs Verify Compliance · zio
    Fix compliance issues in a documentation file against writing style and mdoc conventions.
    7 repo stars
  20. ▌
    Docs Companion Examples · zio
    How to commission and verify a page's companion example files — the standalone runnable Scala a page pulls in with mdoc:embed or SourceFile.print. Use when a documentation page embeds example files rather than relying only on inline mdoc blocks, to delegate the build and check what came back.
    7 repo stars
  21. ▌
    Docs Add Missing Section · zio bundle
    Add a missing section to an existing data type reference page. Use when a required section (such as "Construction", "Predefined Instances", "Comparison", or "Advanced Usage") is entirely absent from an existing docs/reference/*.md file. The user provides the doc path and a description of what section is needed and why.
    7 repo stars
  22. ▌
    Docs Skill Retrospection · zio
    Analyze a recent docs-* skill execution to close the feedback loop. Identifies deviations from documented workflow, unclear instructions, missing edge cases, and better approaches. Applies targeted improvements to the skill file based on what was learned. Run after any docs-* skill to capture retrospective insights.
    7 repo stars
  23. ▌
    Docs List Undocumented Prs · zio bundle
    Scans merged GitHub PRs (from latest commit back to an upstream base ref) and produces a documentation-coverage audit report. Processes 20 PRs per batch and asks before continuing to the next batch. Skips PRs already checked in previous runs using a persistent state file. For each new PR, determines whether documentation is required based on labels, changed files, and content signals, then checks whether docs exist and grades coverage using four rubric levels: Well Documented, Partially Documented, Stub, or Not Documented. Outputs a focused report showing only PRs that require docs, sorted by coverage gap severity. Use this skill whenever the user wants to know which merged PRs are missing documentation, wants a documentation debt audit, or asks "what needs to be documented?", "which PRs have no docs?", or similar coverage questions. Invoke it even if the user just says "doc audit" or "show me undocumented changes."
    7 repo stars
  24. ▌
    Docs Data Type List Members · zio bundle
    Use when extracting and categorizing public members from a Scala data type for documentation completeness checks.
    7 repo stars
  25. ▌
    Docs Report Method Coverage · zio bundle
    Use when checking if documentation covers all public members of a Scala data type.
    7 repo stars
  26. ▌
    Docs Find Documentation Gaps · zio bundle
    Find and report undocumented areas of a ZIO library project that need documentation coverage in the docs directory. Generates a TODO-style report.
    7 repo stars
  27. ▌
    Docs Organize Reference Docs · zio bundle
    Group an existing reference section into categories — propose the grouping from what the pages document, write each category's index page, and update sidebars.js without moving any file. Use when reorganizing an already-written reference section (any set of pages, not only single-type reference pages), rather than writing a new page.
    7 repo stars
  28. ▌
    Critique · zio bundle
    A coordinator-only critique-fix loop for driving an existing documentation page to approval — a fresh critic delegate reports severity-tagged findings, a fresh fixer delegate resolves them, capped at three rounds with HIGH findings iterating longest and MEDIUM getting one chance. Load when reviewing an already-written page against source, siblings, and consistency, not when writing new content.
    7 repo stars
  29. ▌
    Cross Linker · zio bundle
    Make an orphan documentation page reachable — find the existing pages that should mention it, and add one prose link from each, without touching code, headings or frontmatter. Load when retro-fitting links into a docs tree rather than writing a new page.
    7 repo stars
  30. ▌
    Ascii Diagram · zio
    How to produce an ASCII diagram that is actually aligned — generate it from a Python script with a width assertion, never by hand. Use when a page needs a box-and-arrow diagram, such as a module reference's "How They Work Together" section or a tutorial's data-flow picture.
    7 repo stars
  31. ▌
    Writing Style · zio bundle
    Prose and code style rules for ZIO documentation (reference pages, how-to guides, tutorials). Load whenever writing or editing docs to keep prose consistent, clear, and professional.
    7 repo stars
  32. ▌
    Enrich Section · zio bundle
    Expand a thin documentation section — one with a signature and a toy example but no motivation — into one that explains why a reader would choose this API, using the five-part expansion pattern (opening sentence, motivation, contrast, signature, realistic example). Load when a section exists but reads as reference-only, not when it is entirely absent.
    7 repo stars
  33. ▌
    Markdown Table · zio
    How to produce a Markdown table that is aligned and structurally valid — generate it from a Python script with a cell-count and escaping check, never by hand. Use when a page compares things across three or more columns, such as a type roster, an edge-case table, or a variant comparison.
    7 repo stars
  34. ▌
    Module Subpages · zio
    How to write the per-type subpages of a hierarchical module reference — the per-type loop, sub-domain nesting, and the sub-domain index page. Use when a module's design plan chose the hierarchical layout (core-family or multi-domain shapes); a flat module page has no subpages.
    7 repo stars
  35. ▌
    How To Checklist · zio bundle
    The review checklist a ZIO how-to guide must pass before it is considered done. Load when reviewing a finished how-to guide for content, technical accuracy, examples, and integration.
    7 repo stars
  36. ▌
    How To Structure · zio bundle
    The section template, section-design rules, and drafting rules for goal-oriented ZIO how-to guides — including the mandatory Problem section and how its "before" example is fenced. Load when designing a how-to guide's structure before writing.
    7 repo stars
  37. ▌
    Mdoc Conventions · zio
    Reference for mdoc code-block modifiers and Docusaurus admonitions used across ZIO documentation. Load when writing any documentation that contains Scala code blocks.
    7 repo stars
  38. ▌
    Backfill Metadata · zio bundle
    Write a Docusaurus page's `description` and `keywords` frontmatter from the page's own content — length and form rules, and what makes a keyword worth indexing. Load when filling metadata on an existing page rather than authoring a new one.
    7 repo stars
  39. ▌
    Reduce Redundancy · zio bundle
    Remove lexical, structural, and semantic redundancy from a finished documentation page — repeated definitions, decorative transitions, motivations argued twice — without cutting meaning. Load when editing an existing page for repetition rather than writing a new one.
    7 repo stars
  40. ▌
    Companion Examples · zio
    How to commission and verify a page's companion example files — the standalone runnable Scala a page pulls in with mdoc:embed. Use when a documentation page embeds example files rather than relying only on inline mdoc blocks.
    7 repo stars
  41. ▌
    Tutorial Checklist · zio bundle
    The review checklist a ZIO tutorial must pass before it is considered done. Load when reviewing a finished tutorial for content, technical accuracy, examples, and integration.
    7 repo stars
  42. ▌
    Tutorial Structure · zio bundle
    The section template, section-design rules, and narrative-planning method for learning-oriented ZIO tutorials. Load when designing a tutorial's structure before writing.
    7 repo stars
  43. ▌
    Add Missing Section · zio bundle
    Insert one missing section — Construction, Predefined Instances, Comparison, Advanced Usage, or Motivation — into an existing data-type reference page, at its canonical position, fully written and mdoc-verified. Load when a required section is entirely absent from a reference page (not when it exists but is thin).
    7 repo stars
  44. ▌
    Zio Knowledge · zio
    Stop and consult this skill whenever your response would involve any fact or code related to ZIO core or the ZIO ecosystem. Covers: ZIO effects and type aliases (ZIO, Task, UIO, UEffect), fibers and fiber management, concurrency primitives (Hub, Queue, Ref, Semaphore), Software Transactional Memory (STM), ZIO Streams (ZStream, ZSink, ZPipeline, ZChannel), ZIO Test framework and test utilities, ZLayer and dependency injection patterns, error management and error types, scheduling and retries, resource management and scoping, ZIO Config, ZIO Schema, ZIO JSON, ZIO Kafka, and all official ZIO libraries and integrations. Trigger this for any ZIO coding task, type signatures, library features, architectural patterns, or comparisons involving ZIO. Any time you would otherwise rely on memory for ZIO details, verify here instead — your training data may be outdated or wrong.
    7 repo stars
  45. ▌
    Module Ref Checklist · zio bundle
    The review checklist a ZIO module reference must pass before it is considered done. Load when reviewing a finished module reference for the module narrative, layout correctness, type coverage, and examples.
    7 repo stars
  46. ▌
    Module Ref Structure · zio bundle
    The section template and drafting rules for a ZIO module reference — documentation of a cohesive domain model of several related types (e.g. an HTTP model, resource management), flat single-page or hierarchical index+subpages. Load when planning or writing a module reference.
    7 repo stars
  47. ▌
    Docs Examples · zio
    Shared procedure for creating and documenting companion examples. Covers directory structure, file templates, example creation, compilation, linting, and embedding with SourceFile. Used by docs-data-type-ref, docs-module-ref, docs-how-to-guide, and docs-tutorial.
    7 repo stars
  48. ▌
    Docs Research · zio
    Shared research procedure for documentation skills. Find source files, tests, examples, patterns, and GitHub history when researching a topic. Used by docs-how-to-guide, docs-tutorial, and docs-data-type-ref.
    7 repo stars
  49. ▌
    Docs Tutorial · zio bundle
    Write a tutorial for newcomers learning a topic in a ZIO library. Use when the user asks to write a tutorial or learning guide that teaches concepts step-by-step in a linear path. Tutorials are learning-oriented (for newcomers with no prior knowledge) unlike how-to guides which are task-oriented.
    7 repo stars
  50. ▌
    Data Type Ref Checklist · zio bundle
    The review checklist a ZIO data type reference page must pass before it is considered done. Load when reviewing a finished reference page for structure, API coverage, technical accuracy, and examples.
    7 repo stars
  51. ▌
    Data Type Ref Structure · zio bundle
    The section template and drafting rules for a ZIO data type reference page (docs/reference/<type>.md). Load when planning or writing an API reference page for a single data type.
    7 repo stars
  52. ▌
    Organize Reference Docs · zio bundle
    Group an existing reference section into categories — propose the grouping from what the pages document, write each category's index page, and update sidebars.js without moving any file. Load when reorganizing reference docs rather than writing a new page.
    7 repo stars