oci-distribution-spec

Reference OCI Distribution Specification API endpoints, digests, and error codes.

1|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/pdylanross/barnacle --skill oci-distribution-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oci-distribution-spec
Source: https://github.com/pdylanross/barnacle/tree/main/.claude/skills/oci-distribution-spec
Command: npx skills add https://github.com/pdylanross/barnacle --skill oci-distribution-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a quick reference for the OCI Distribution Specification, enabling users to understand and interact with container registries effectively.

Core Features & Use Cases

  • API Endpoint Reference: Detailed information on endpoints for manifests, blobs, uploads, and catalog.
  • Error Code Guide: Comprehensive list of registry error codes and their meanings.
  • Use Case: When developing a custom container registry client or debugging an image pull issue, quickly look up the correct API calls and understand potential error responses.

Quick Start

Use the oci-distribution-spec skill to find the API endpoint for pushing a manifest.

Frequently Asked Questions about oci-distribution-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the correct OCI Distribution Spec endpoints for pushing container images?

The OCI Distribution Spec provides HTTP API V2 endpoints for manifests, blobs, and uploads to push container images. It details these endpoints to facilitate developing registry clients and interacting with container registries.

What is the OCI Distribution Specification used for?

The OCI Distribution Specification defines the HTTP API V2 for interacting with container registries. It covers API endpoints, content addressing, digests, and authentication to facilitate the development of registry clients, proxies, and debugging operations.

How do I interpret error codes when debugging a Docker registry HTTP API V2 connection?

When debugging a Docker registry HTTP API V2 connection, the OCI Distribution Spec provides a comprehensive list of registry error codes and their meanings. This helps you quickly identify issues during image pull or push operations.

Does the OCI Distribution Spec support resumable uploads for large container images?

Yes, the OCI Distribution Spec supports resumable uploads for large container images. It includes detailed guidelines on content addressing, digests, and upload endpoints to manage interrupted transfers effectively.

Can I use the OCI Distribution Spec reference to build a custom container registry proxy?

Yes, you can use the OCI Distribution Spec reference to build a custom container registry proxy. It provides the necessary API endpoint details, authentication methods, and content addressing rules required to develop registry clients and proxies.