promote

Promote a SHA to preview or production via operator API calls.

4|5|Updated Nov 5, 2025
One-click install
npx skills add https://github.com/cogni-dao/cogni --skill promote-cogni-dao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: promote
Source: https://github.com/cogni-dao/cogni/tree/main/.claude/skills/promote
Command: npx skills add https://github.com/cogni-dao/cogni --skill promote-cogni-dao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Promotes a sha to preview or production and diagnoses why a promotion failed, ensuring safe, auditable release flow.

Core Features & Use Cases

  • Operator-driven promotions: call the operator API to promote builds without using personal credentials.
  • Per-node awareness and diagnostics: track which nodes advance and surface root-cause failures like missing images or admin-merge gaps.
  • Monitoring and diagnosis playbook: arm the Monitor to surface state changes and actionable conclusions during promotion.

Quick Start

Provide the node ID and target environment to start a promote-and-deploy action and monitor progress.

Frequently Asked Questions about promote

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

FAQPage Schema
How do I automate production deployment for a specific version SHA?

To automate production deployment for a version SHA, you provide a node ID and target environment to initiate a promote-and-deploy action. The system uses lease semantics and a monitoring loop to verify progress across preview and production scenarios safely.

Why does my production promotion fail to advance on certain nodes?

Production promotion failures on specific nodes are diagnosed by tracking per-node awareness and surfacing root causes. Common failures include missing images or admin-merge gaps, which the monitoring playbook identifies to enable operator-driven recovery.

Can I trigger preview environment promotions without using personal credentials?

Yes, you can trigger preview environment promotions without personal credentials by using operator-driven API calls. The system applies operator API calls to flight and promote builds securely, ensuring an auditable release flow without exposing individual user credentials.

What is the best way to monitor CI-CD deployment progress across preview environments?

The best way to monitor CI-CD deployment progress is by using an integrated monitoring loop with lease semantics. This approach surfaces state changes and actionable conclusions during promotion, verifying that each node advances correctly across preview environments.

How do I handle admin-merge edge cases during a production release?

To handle admin-merge edge cases during a production release, the deployment process includes specific detection and recovery logic. The operator-driven recovery system diagnoses these gaps and applies infra-skip behavior to ensure the release pipeline continues safely.

Does this deployment operator support per-node diagnostics for failed promotions?

Yes, the deployment operator supports per-node diagnostics for failed promotions. It tracks which nodes advance during the release pipeline and surfaces root-cause failures like missing images, providing actionable data for operator-driven recovery across production scenarios.