{"id":50564402,"url":"https://github.com/zio/zio-skills","last_synced_at":"2026-06-04T13:30:27.346Z","repository":{"id":355393804,"uuid":"1226710097","full_name":"zio/zio-skills","owner":"zio","description":"Teach Your Agent to Build ZIO Applications","archived":false,"fork":false,"pushed_at":"2026-05-19T17:46:18.000Z","size":529,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-19T21:08:12.036Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Scala","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-01T18:35:53.000Z","updated_at":"2026-05-19T17:46:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zio/zio-skills","commit_stats":null,"previous_names":["zio/zio-skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zio/zio-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zio%2Fzio-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zio%2Fzio-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zio%2Fzio-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zio%2Fzio-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zio","download_url":"https://codeload.github.com/zio/zio-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zio%2Fzio-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33907693,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-04T02:00:06.755Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-04T13:30:26.043Z","updated_at":"2026-06-04T13:30:27.340Z","avatar_url":"https://github.com/zio.png","language":"Scala","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ZIO Skills — Teach Your Agent to Build ZIO Applications\n\nTeaching coding agents (Claude Code, Cursor, Codex, Gemini, OpenCode) how to build and document ZIO applications.\n\nThis marketplace currently ships three plugins:\n\n- **`zio-skills`** — Build ZIO and ZIO HTTP applications (server scaffolding, OpenAPI code generation, endpoint API, …).\n- **`documentation`** — Write high-quality documentation for ZIO libraries (reference pages, how-to guides, tutorials, mdoc conventions, writing-style enforcement).\n- **`docs-write`** — Guided documentation authoring workflow (research, generation, and quality review for existing code).\n\n## Installation\n\n### Claude Code\n\nFirst, add the marketplace, then install one or both plugins:\n\n```bash\nclaude plugin marketplace add zio/zio-skills\n\n# build apps with ZIO / ZIO HTTP\nclaude plugin install zio-skills@ziogenetics\n\n# write documentation for ZIO libraries\nclaude plugin install documentation@ziogenetics\n\n# guided documentation authoring workflow\nclaude plugin install docs-write@ziogenetics\n```\n\nThen invoke a skill in Claude Code:\n```\n/zio-http-scaffold\n/zio-http-openapi-to-endpoint\n/zio-http-endpoint-to-openapi\n/zio-http-imperative-to-declarative\n/docs-write\n/docs-data-type-ref\n/docs-how-to-guide\n/docs-tutorial\n/docs-writing-style\n```\n\n### Cursor\n\n```bash\n/add-plugin zio-skills\n```\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/zio/zio-skills\n```\n\nTo update:\n\n```bash\ngemini extensions update zio-skills\n```\n\n### Codex\n\nClone the repo and symlink:\n\n```bash\ngit clone https://github.com/zio/zio-skills.git ~/.agents/skills/zio-skills\n```\n\nor user Skill Installer inside codex cli:\n\n```bash\n$skill-installer zio/zio-skills\n```\n\n### OpenCode\n\nAdd to `opencode.json`:\n```json\n{\n  \"plugin\": [\"zio-skills@git://github.com/zio/zio-skills.git\"]\n}\n```\n\n## Skills\n\n### ZIO HTTP (`zio-skills` plugin)\n\n- **`zio-http-scaffold`** — Scaffold a minimal ZIO HTTP server and client\n- **`zio-http-openapi-to-endpoint`** — Generate Endpoint declarations from an OpenAPI spec\n- **`zio-http-endpoint-to-openapi`** — Generate OpenAPI documentation from Endpoint declarations + serve Swagger UI\n- **`zio-http-imperative-to-declarative`** — Convert imperative routes to typed Endpoint API\n\n### Documentation (`documentation` plugin)\n\nOrchestration:\n- **`docs-write`** — Guided 5-phase workflow for writing documentation (research, generation, quality review)\n\nAuthoring skills:\n- **`docs-data-type-ref`** — Write a reference page for a single data type\n- **`docs-module-ref`** — Write a reference page for a module (multiple related types)\n- **`docs-how-to-guide`** — Write a goal-oriented how-to guide\n- **`docs-tutorial`** — Write a learning-oriented tutorial for newcomers\n- **`docs-document-pr`** — Generate documentation from a GitHub PR\n- **`docs-add-missing-section`** — Add a missing section to an existing reference page\n- **`docs-enrich-section`** — Add motivation and use-cases to a thin section\n\nAuthoring helpers:\n- **`docs-examples`** — Shared procedure for creating runnable companion examples\n- **`docs-research`** — Shared research procedure (find source, tests, examples, history)\n- **`docs-integrate`** — Wire a new doc page into Docusaurus navigation\n- **`docs-organize-types`** — Group types into logical sidebar categories\n\nQuality checks:\n- **`docs-writing-style`** — Prose style rules with mechanical validation script\n- **`docs-mdoc-conventions`** — mdoc code-block modifiers and Docusaurus admonitions\n- **`docs-check-compliance`** — Audit a doc file against a rule skill\n- **`docs-verify-compliance`** — Fix compliance issues in a doc file\n- **`docs-critique`** — Review and fix an existing documentation file using a maker-critic loop\n- **`docs-find-documentation-gaps`** — Scan project for undocumented types/modules\n- **`docs-report-method-coverage`** — Check that all public members are documented\n- **`docs-data-type-list-members`** — Extract public members from a Scala type\n- **`docs-skill-retrospection`** — Improve a docs-* skill from execution feedback\n\n## Planned Skills\n\n- Typed path \u0026 query parameters\n- Custom middleware with context injection\n- Type-safe HTTP client with EndpointExecutor\n- Server-Sent Events (SSE) streaming\n- WebSocket handlers\n- Datastar reactive UI integration\n- HTML templates with template2 DSL\n- Multipart form uploads\n- Testing with zio-http-testkit\n- Metrics \u0026 Prometheus integration\n- ZIO Streams patterns\n- ZIO Config patterns\n- And more…\n\n## Contributing\n\nSkills are curated learning resources. See [CLAUDE.md](CLAUDE.md) for contribution guidelines.\n\n## License\n\n[License](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzio%2Fzio-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzio%2Fzio-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzio%2Fzio-skills/lists"}