Skip to content
Purview Dev logo

This repository authors agent skills so AI agents working with Purview.Results get the guidance automatically. They are authored at skills/<name>/SKILL.md and installed with the skills CLI, which clones this git repository — no package ships them. Purview.BuildSdk 1.0.6 removed skill packaging and the build-time .agents/ mirror, so the CLI is the only delivery route.

Skill Covers
skills/purview-results-core The result type, its three states, combinators and the throw-on-misuse contract
skills/purview-results-union-errors Union modelling, the generated helpers, the diagnostics table, and the language rules that make the helper necessary
skills/purview-results-http-mapping Result-to-HTTP mapping, the failure resolution order, and unmapped-failure 500s
skills/purview-results-zodsharp-validation ZodSharp validation flowing through results
skills/purview-results-zodsharp-problems Rendering validation-carrying failures as ProblemDetails

Task-shaped detail lives in a skill’s own references/ folder — migrating existing code onto error unions is skills/purview-results-union-errors/references/migrating-error-returns.md.

  • Modelling or migrating to result error unions → purview-results-union-errors
  • The result type, its states or its combinators → purview-results-core
  • Result-to-HTTP mapping or unmapped-failure 500s → purview-results-http-mapping
  • ZodSharp validation flowing through results → purview-results-zodsharp-validation, then purview-results-zodsharp-problems

The Purview engineering playbook, Purview.BuildSdk, the source-generator framework, ZodSharp and Purview.ValueObjects publish their own skills (engineering conventions, SDK configuration and project layout, generator authoring and testing, ZodSharp integration, value-object composition) through the same CLI. Those are owned by the repository that publishes them — changes belong there, not here. This repository installs them into the universal .agents/skills/ folder only (-a universal) and commits that folder together with the CLI’s skills-lock.json, so a clone has them without running anything; nothing is installed into .claude/ or any other per-agent folder. This repository’s own skills are never installed into .agents/skills/, because two copies would drift apart.