schema-compatibility SKILL.md skillA

schema-compatibility from jvoliveiran/constellation-harness is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jvoliveiran/constellation-harness/schema-compatibility@git:20260610.47ec162

Pins git:20260610.47ec162 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
jvoliveiran/constellation-harness
Path
plugins/constellation-stack-node/skills/schema-compatibility/SKILL.md
Versions recorded
1
Latest version
git:20260610.47ec162, committed Jun 10, 2026
Size
4,049 bytes
Repository stars
10
License
MIT

Detect breaking vs safe changes in the auto-generated GraphQL schema to prevent downstream consumer breakage.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Schema Compatibility Skill

## Scope

Apply this skill after the Software Engineer completes implementation and before the review gate. It detects whether the GraphQL schema changes introduced by the current work are safe (additive) or breaking (destructive).

---

## How It Works

The generated schema artifact (path configured as `schemaPath` in `.constellation/config.json`, e.g. `src/schema.gql`) is the public API contract. Changes to this file fall into two categories:

### Safe Changes (Additive)

These can be shipped without coordination with consumers:

- New types added
- New fields added to existing types
- New enum values added
- New queries or mutations added
- New input types added
- Description changes on existing fields
- Deprecation annotations added (`@deprecated`)

### Breaking Changes (Destructive)

These require consumer coordination and must be flagged as blockers:

- Fields removed from existing types
- Fields renamed (appears as remove + add)
- Field types changed (e.g., `String` to `Int`, nullable to non-nullable)
- Enum values removed
- Queries or mutations removed
- Input fields added as required (non-nullable) to existing input types
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jvoliveiran/constellation-harness/schema-compatibility@sha256:9a8d6ba532477ee4

The line at the top of this page pins the label git:20260610.47ec162, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_z63xdggk36f75awe.svg)](https://markdownregistry.com/a/art_z63xdggk36f75awe)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Jun 10, 2026.

versioncommittedcommitsizeaudit
git:20260610.47ec162 latest2026-06-10 47ec162 4,049 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4049 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

jvoliveiran/constellation-harness · 10 stars · license MIT · pushed 2026-10-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_z63xdggk36f75awe
GET https://markdownregistry.com/api/v1/resolve?ref=jvoliveiran/constellation-harness/schema-compatibility
GET https://markdownregistry.com/api/v1/blob/9a8d6ba532477ee400eac896b2b0b0f6f339f13ae205c7a9835468889759a014

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from jvoliveiran/constellation-harness

AGENTS.md@docs/spikes/opencode-port AGENTS.md file
jvoliveiran/constellation-harness · docs/spikes/opencode-port/AGENTS.md
git:20260921.d132908 · audit A · 10 stars
frontend-design SKILL.md skill
jvoliveiran/constellation-harness · plugins/constellation-stack-frontend/skills/frontend-design/SKILL.md · Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to…
git:20260611.d17d9ad · audit A · 10 stars
cloud-accessory-services SKILL.md skill
jvoliveiran/constellation-harness · plugins/constellation-stack-infra/skills/cloud-accessory-services/SKILL.md · The services around the app — secrets (OCI Vault / AWS Secrets Manager), TLS certificates, DNS, container registries…
git:20260708.0e0f20a · audit A · 10 stars
oci-container-platform SKILL.md skill
jvoliveiran/constellation-harness · plugins/constellation-stack-infra/skills/oci-container-platform/SKILL.md · Running Docker containers and databases on OCI inside the Always Free tier — the AWS Lightsail equivalent built from…
git:20260708.0e0f20a · audit A · 10 stars
terraform-environments SKILL.md skill
jvoliveiran/constellation-harness · plugins/constellation-stack-infra/skills/terraform-environments/SKILL.md · Multi-environment Terraform — remote state backends (OCI Object Storage or S3), directory-per-environment layout…
git:20260708.0e0f20a · audit A · 10 stars
terraform-module-design SKILL.md skill
jvoliveiran/constellation-harness · plugins/constellation-stack-infra/skills/terraform-module-design/SKILL.md · Designing reusable Terraform modules as composable building blocks — interface conventions, file layout, versioning…
git:20260708.0e0f20a · audit A · 10 stars
error-handling SKILL.md skill
jvoliveiran/constellation-harness · plugins/constellation-stack-node/skills/error-handling/SKILL.md · Domain exception hierarchy, error codes, GraphQL error formatting, and error logging standards for a NestJS + GraphQL…
git:20260610.47ec162 · audit A · 10 stars
graphql-federation SKILL.md skill
jvoliveiran/constellation-harness · plugins/constellation-stack-node/skills/graphql-federation/SKILL.md · How to build a graphql federated API approach, composing a supergraph based on subgraph graphql servers
git:20260610.47ec162 · audit A · 10 stars
graphql SKILL.md skill
jvoliveiran/constellation-harness · plugins/constellation-stack-node/skills/graphql/SKILL.md · How to use graphql with Nestjs and Typescript on a code-first approach
git:20260610.47ec162 · audit A · 10 stars
nestjs SKILL.md skill
jvoliveiran/constellation-harness · plugins/constellation-stack-node/skills/nestjs/SKILL.md · Most recommended practices and modules to use alongside with NestJS framework for backend development
git:20260610.47ec162 · audit A · 10 stars
observability SKILL.md skill
jvoliveiran/constellation-harness · plugins/constellation-stack-node/skills/observability/SKILL.md · Logging, tracing, and monitoring standards using Winston and OpenTelemetry in a NestJS + TypeScript backend
git:20260610.47ec162 · audit A · 10 stars
prisma-migrations SKILL.md skill
jvoliveiran/constellation-harness · plugins/constellation-stack-node/skills/prisma-migrations/SKILL.md · Best practices for Prisma schema changes, migrations, seeding, and rollback in a NestJS + TypeScript backend
git:20260610.47ec162 · audit A · 10 stars

Every file in jvoliveiran/constellation-harness

Browse by kind, by grade A, or by owner.