Menu
Manage Semaphore infrastructure — secrets, notifications, agent types, scheduled tasks, artifacts.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Deploy via Semaphore promotions. Manage deployment targets, promote pipelines, deploy-and-wait.
Diagnose sem-ai plugin issues when the sem-ai binary isn't installed yet, and guide the user through binary install. Use when the user reports sem-ai not working, MCP tools missing, slash command not found, `sem-ai connect` failing, or sees "command not found: sem-ai".
Triage and FIX flaky tests on a Semaphore project end-to-end — find the worst offenders, pull history, locate the test in the code, diagnose the root cause, write a fix or justified quarantine, and verify by re-running. Use whenever the user wants to fix/investigate flaky tests, de-flake CI, reduce intermittent failures, asks "why is CI randomly red", wants to quarantine a flake, or after `sem-ai flaky list` surfaces offenders. Goes BEYOND detection (test-intelligence) to root-cause + code change + verification.
Diagnose and fix CI pipeline failures. Step-by-step debugging with sem-ai.
Translate a repo's GitHub Actions workflows into an equivalent Semaphore pipeline. ONLY covers the GHA→Semaphore mapping and conversion procedure; for Semaphore-side depth (cache CLI, test-results, blocks structure, sharding, promotions) defer to the linked skills. Use when the user asks to convert/port/migrate GitHub Actions to Semaphore, says "translate this workflow" or "convert ci.yml", or the repo has `.github/workflows/` and the user wants Semaphore instead. Can be invoked directly as `/sem-ai:gha-to-semaphore` (or via the broader `/sem-ai:init` orchestrator).
Initialize Semaphore CI/CD for the current repository — bootstrap the Semaphore project, write a working `.semaphore/semaphore.yml` (translating from GitHub Actions if present, or from scratch), wire required secrets, validate, and watch the first workflow. Applies Semaphore-side defaults automatically — agent image, toolbox CLIs, `test-results` epilogue rule, sharding heuristics — by routing through the linked skills. Use when the user wants to set up CI on Semaphore, says "initialize", "bootstrap CI", "prepare CI/CD for this project", "create a workflow on Semaphore", "make a `.semaphore` config", or runs `/sem-ai:init`.
Based on SOC occupation classification
| name | manage-infra |
| description | Manage Semaphore infrastructure — secrets, notifications, agent types, scheduled tasks, artifacts. |
| user-invocable | false |
sem-ai secret list [--project <p>] # org or project level
sem-ai secret show <name> [--project <p>]
sem-ai secret create <name> --env KEY=VALUE [--project <p>]
sem-ai secret update <name> --env KEY=NEW [--project <p>]
sem-ai secret delete <name> [--project <p>]
sem-ai notification list
sem-ai notification show <name>
sem-ai notification delete <name>
sem-ai agent types # list agent types
sem-ai agent show <type-name> # type details
sem-ai agent list --type <name> # list agents of a type
sem-ai agent delete <type-name> # delete type
sem-ai task list --project <p>
sem-ai task show <id> # details + recent triggers
sem-ai task run <id> # trigger now
sem-ai task delete <id>
# Parameterized tasks: pass parameters, branch, and pipeline file.
# Parameters go to the task's run_now as a map; branch/pipeline-file pick
# the ref + YAML the task pipeline runs.
sem-ai task run <id> --param KEY=VALUE [--param ...] \
[--branch <ref>] [--pipeline-file <path>]
# Create with parameter definitions: bare NAME = required,
# NAME=DEFAULT = optional with a default value.
sem-ai task create <name> --branch main --file <path> [--cron "<expr>"] \
[--param-def NAME] [--param-def NAME=DEFAULT]
sem-ai artifact list --scope jobs --id <job-id>
sem-ai artifact list --scope workflows --id <wf-id>
sem-ai artifact get --scope jobs --id <job-id> --path <path> [--output file]
sem-ai yaml validate --file .semaphore/semaphore.yml