umbraco-shared

Authenticates Umbraco CLI commands and manages safe API interactions with schema-driven validation.

4|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/albanistrefi/umbraco_CLI --skill umbraco-shared
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-shared
Source: https://github.com/albanistrefi/umbraco_CLI/tree/main/skills/cli/umbraco-shared
Command: npx skills add https://github.com/albanistrefi/umbraco_CLI --skill umbraco-shared

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill standardizes how to authenticate, configure, and safely operate the Umbraco CLI so you can avoid mistakes while interacting with the Umbraco Management API.

Core Features & Use Cases

  • Authentication options: Use persistent login or environment variables to reliably target your Umbraco instance.
  • Predictable configuration precedence: Ensure the CLI reads the right base URL and credentials from the correct source.
  • Operational guardrails: Enforce safety patterns like dry-runs for mutations, limited fields for reads, and schema introspection before calling endpoints.
  • Schema-driven execution: Use schema listing to build correct --json and --params payloads for update operations.

Quick Start

Ask an AI to help you run an authenticated, safe read by first checking your schema and then issuing a dry-run mutating command using the recommended umbraco global flags and --json payloads.

Frequently Asked Questions about umbraco-shared

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

FAQPage Schema
How do I safely run Umbraco CLI commands against the Management API?

To safely run Umbraco CLI commands, you should enforce operational guardrails like dry-run validation for mutations, limit response fields for reads, and use schema introspection to build correct JSON payloads before calling Management API endpoints.

What is the best way to authenticate with the Umbraco Management API using CLI?

Authenticating with the Umbraco Management API can be done using persistent login or environment variables, ensuring the CLI reliably targets your Umbraco instance by reading credentials from the correct configuration precedence.

How do I build correct JSON payloads for Umbraco CLI update operations?

You can build correct JSON and parameters for Umbraco CLI updates by using schema introspection or schema listing to understand the exact structure required before executing your mutating commands.

Can I use environment variables to configure the Umbraco CLI?

Yes, you can use environment variables to configure the Umbraco CLI. This method provides predictable configuration precedence, ensuring the CLI reads the correct base URL and credentials to target your Umbraco instance.

Why should I use dry-run validation when updating Umbraco schemas?

Dry-run validation is an enforced safety requirement for mutating operations to prevent mistakes. It allows you to verify untrusted input handling and command parameters before actually applying updates to the Umbraco Management API.