gaia-config-distribution

Edits and validates the distribution block of project-config.yaml.

2|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/gaiastudio-ai/gaia-framework --skill gaia-config-distribution
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gaia-config-distribution
Source: https://github.com/gaiastudio-ai/gaia-framework/tree/main/plugins/gaia/skills/gaia-config-distribution
Command: npx skills add https://github.com/gaiastudio-ai/gaia-framework --skill gaia-config-distribution

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill allows users to manage and edit the distribution configuration for their projects, ensuring that all necessary settings are correctly specified and validated.

Core Features & Use Cases

  • Distribution Configuration: Edit the distribution: block of project-config.yaml with operations like add, show, clear, and set.
  • Comment-Preserving: Modifies configurations without altering surrounding comments and formatting.
  • Schema Validation: Validates the configuration against the closed 10-channel registry schema.
  • Path Canonicalization: Ensures paths are correctly resolved and canonicalized.
  • URL Validation: Validates the registry URL format.
  • Force Option: Allows overriding deployment constraints when all environments are deployable.
  • CRUD Operations: Adds, shows, clears, and sets distribution configurations.

Quick Start

Use the gaia-config-distribution add --channel npm --registry https://npm.pkg.github.com --manifest package.json --release-workflow npm-release.

Frequently Asked Questions about gaia-config-distribution

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

FAQPage Schema
How do I edit the distribution block in project-config.yaml without losing comments?

To edit the distribution block in project-config.yaml without losing comments, use the CRUD operations provided. The Skill modifies configurations with comment-preserving logic, ensuring your surrounding formatting and annotations remain intact during updates.

How do I validate a registry URL when configuring project distribution settings?

Validating a registry URL when configuring project distribution settings is handled automatically. The Skill performs URL validation alongside schema validation against a closed 10-channel registry schema to ensure your distribution configuration is correctly specified.

Can I bypass deployment constraints in project configuration when all environments are deployable?

Yes, you can bypass deployment constraints in project configuration when all environments are deployable by using the optional force flag. This feature allows you to override standard deployment constraints during distribution configuration updates.

What is path canonicalization for distribution configuration in a YAML file?

Path canonicalization for distribution configuration in a YAML file is the process of ensuring paths are correctly resolved and absolute. The Skill automatically canonicalizes paths when you add or set distribution configurations in project-config.yaml.

Does this project configuration tool support adding a new release channel to an existing registry schema?

Yes, this project configuration tool supports adding a new release channel to an existing registry schema. You can use the add operation with parameters like channel, registry URL, manifest, and release-workflow to configure your distribution block.

Why are my distribution settings not updating when I edit project-config.yaml?

Your distribution settings might not update when editing project-config.yaml due to schema validation failures or deployment constraints. Ensure your registry URL passes validation and consider using the force flag if all environments are deployable to bypass constraints.