Add OCI Image Spec reference and image manifest/image support to regshape-dev skill#67
Open
toddysm wants to merge 1 commit into
Open
Add OCI Image Spec reference and image manifest/image support to regshape-dev skill#67toddysm wants to merge 1 commit into
toddysm wants to merge 1 commit into
Conversation
- Add condensed references/oci-image-spec.md summary - Mirror upstream OCI image-spec docs under references/oci-image-spec-source/ - Update SKILL.md workflow, domain areas, labels, and key references Fixes #66
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the regshape-dev skill documentation to cover OCI Image Format concepts (image manifests, indexes, configs, and filesystem layers) by adding a local condensed reference plus mirroring upstream OCI image-spec docs for deeper lookup.
Changes:
- Add a condensed OCI image-spec reference at
references/oci-image-spec.md. - Mirror upstream OCI image-spec documentation under
references/oci-image-spec-source/. - Update
SKILL.mdworkflow guidance, domain areas, labels, and key references to include the image spec.
Reviewed changes
Copilot reviewed 14 out of 14 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| .github/skills/regshape-dev/SKILL.md | Updates skill workflow/domain/labels to include OCI image-spec guidance (but currently has Markdown formatting issues). |
| .github/skills/regshape-dev/references/oci-image-spec.md | Adds condensed OCI image-spec reference (but currently includes an invalid/misleading Image Index JSON example). |
| .github/skills/regshape-dev/references/oci-image-spec-source/spec.md | Mirrored upstream OCI image-spec overview. |
| .github/skills/regshape-dev/references/oci-image-spec-source/media-types.md | Mirrored upstream OCI media types reference. |
| .github/skills/regshape-dev/references/oci-image-spec-source/manifest.md | Mirrored upstream image manifest specification. |
| .github/skills/regshape-dev/references/oci-image-spec-source/image-index.md | Mirrored upstream image index specification. |
| .github/skills/regshape-dev/references/oci-image-spec-source/config.md | Mirrored upstream image configuration specification. |
| .github/skills/regshape-dev/references/oci-image-spec-source/layer.md | Mirrored upstream filesystem layer specification. |
| .github/skills/regshape-dev/references/oci-image-spec-source/descriptor.md | Mirrored upstream content descriptor specification. |
| .github/skills/regshape-dev/references/oci-image-spec-source/annotations.md | Mirrored upstream annotations specification. |
| .github/skills/regshape-dev/references/oci-image-spec-source/image-layout.md | Mirrored upstream OCI image layout specification. |
| .github/skills/regshape-dev/references/oci-image-spec-source/conversion.md | Mirrored upstream conversion guidance. |
| .github/skills/regshape-dev/references/oci-image-spec-source/considerations.md | Mirrored upstream considerations section. |
| .github/skills/regshape-dev/references/oci-image-spec-source/artifacts-guidance.md | Mirrored upstream artifacts guidance. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| 4. Create the spec as a Markdown file in `/specs/<domain>/<feature>.md` | ||
| 5. Present the spec to the user for review before proceeding | ||
|
|
||
| 4. Create the spec as a Markdown file in `/specs/<domain>/<feature>.md`5. Present the spec to the user for review before proceeding |
| | CLI | `cli/` | `specs/cli/` | `docs/cli/` | | ||
| | Models | `libs/models/` | `specs/models/` | `docs/library/models.md` | | ||
|
|
||
| | CLI | `cli/` | `specs/cli/` | `docs/cli/` || Models | `libs/models/` | `specs/models/` | `docs/library/models.md` | |
Comment on lines
+118
to
+120
| ], | ||
| "subject": {}, | ||
| "annotations": {} |
| ## Key References | ||
|
|
||
| - **OCI Distribution Spec**: [references/oci-distribution-spec.md](references/oci-distribution-spec.md) — API endpoints, schemas, error codes | ||
| - **OCI Image Spec**: [references/oci-image-spec.md](references/oci-image-spec.md) — image manifests, image index, image config, filesystem layers, descriptors (full upstream spec mirrored in [references/oci-image-spec-source/](references/oci-image-spec-source/)) |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #66
Summary
Updates the
regshape-devskill to support designing/implementing OCI image manifests and images (config + filesystem layers), and adds an OCI Image Format Specification reference.Changes
references/oci-image-spec.md(descriptors, image manifest, image index, image config, filesystem layers, media types, annotations, assemble/pull workflow, RegShape implementation + break-mode notes).references/oci-image-spec-source/(from github.com/opencontainers/image-spec).SKILL.md: Phase 1 references both distribution and image specs; Domain Areas addImage Manifests & IndexandImages; addimage-spec/imageslabels; add image spec to Key References.Acceptance Criteria
references/oci-image-spec.mdexists and is linked fromSKILL.mdreferences/oci-image-spec-source/SKILL.mdreferences the image spec in workflow, domain areas, and key references