screenshot-format

Document the .screenshot bundle format and serialization rules for ScreenShotComposer.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/luigiinred/screenshotcomposer-website --skill screenshot-format
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: screenshot-format
Source: https://github.com/luigiinred/screenshotcomposer-website/tree/main/skills/screenshot-format
Command: npx skills add https://github.com/luigiinred/screenshotcomposer-website --skill screenshot-format

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides a formal reference for the .screenshot document format used by ScreenShotComposer, including its bundle layout, JSON schema, and asset packaging rules.

Core Features & Use Cases

  • Defines the required top-level structure of a .screenshot bundle (info.json, per-platform JSON, and assets/) and the canonical field shapes for CompositionRecord, CompositionLayerRecord, and related types.
  • Serves as a source of truth for creating, validating, or debugging .screenshot files, templates, and tests in both the app repository and the website's skills hub.
  • Use case: hand-author a new test fixture or generate a compliant example that can be used by tooling to serialize or validate assets and layers.

Quick Start

Follow this reference to write or validate a .screenshot bundle that adheres to the official schema.

Frequently Asked Questions about screenshot-format

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

FAQPage Schema
What is the required structure for a .screenshot bundle file?

A .screenshot bundle requires a top-level structure containing an info.json file, per-platform JSON files, and an assets/ directory to define composition records and asset packaging conventions.

How do I validate a .screenshot bundle for Mac, iPhone, and iPad platforms?

Validate a .screenshot bundle by checking its nested structures against the field schemas for CompositionRecord and CompositionLayerRecord, ensuring required chunks like info.json and per-platform JSON files are present.

What JSON schemas are used for CompositionRecord and CompositionLayerRecord in screenshot serialization?

The screenshot serialization format specifies canonical field shapes for CompositionRecord and CompositionLayerRecord, defining how composition layers and assets are structured within per-platform JSON files.

Can I hand-author a test fixture using the .screenshot document format?

Yes, you can hand-author test fixtures or generate compliant examples using the .screenshot document format as a source of truth for creating, validating, and debugging files for the ScreenShotComposer tool.

What are the asset packaging conventions for the .screenshot bundle format?

The .screenshot bundle format specifies asset packaging conventions within the assets/ directory, dictating how images and related resources are organized alongside the info.json and per-platform JSON chunks.

Why does my .screenshot file fail serialization in ScreenShotComposer?

Serialization fails when the .screenshot bundle lacks required chunks, violates the CompositionRecord field schemas, or improperly structures the nested platform configurations and assets/ directory.