Agent skill

Triage Canary

by marin-community in marin-community/marin

Triage a failed canary ferry run only when invoked by CI with the required CANARY context.

Apache-2.0Auto-check passedDevOps & Cloud

Install Triage Canary

skills CLI
$ npx skills add marin-community/marin --skill triage-canary -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install marin-community/marin triage-canary --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/marin-community/marin.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/triage-canary .claude/skills/triage-canary && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
triage-canary
GitHub stars
3.9k
Token cost
~751 tokens
SKILL.md length
389 words
Files
1
Skills in repo
41
Repo updated
First seen
Licence
Apache-2.0

At a glance

Triage a failed canary ferry run only when invoked by CI with the required CANARY context.

  • Works in 4 steps: Gather diagnostics → Identify root cause → File a GitHub issue → …
  • Tasks that involve Deployment
  • SKILL.md covers CI invocation context and Steps
  • Calls kubectl

What it does

Triage Canary is an agent skill from marin-community/marin. Triage a failed canary ferry run only when invoked by CI with the required CANARY context.

Its SKILL.md is about 750 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Deployment. It works with Kubernetes. The repository describes itself as: Open-source framework for the research and development of foundation models. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Deployment

Example prompts

  • “/triage-canary”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Gather diagnostics
  2. Identify root cause
  3. File a GitHub issue
  4. Publish the result

What it can do on your machine

Read from SKILL.md and the folder at commit c468793. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • kubectl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use kubectl, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Triage Canary loads about 751 tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 389 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~26
When it runs · the whole SKILL.md, loaded when a task matches
~751

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from marin-community/marin at commit c468793, republished under its Apache-2.0 licence (© marin-community). 389 words, ~751 tokens.

Download SKILL.mdSave it as .claude/skills/triage-canary/SKILL.md (or your agent's skills folder).
name
triage-canary
description
Triage a failed canary ferry run only when invoked by CI with the required CANARY context.

Skill: Triage Canary

Triage a failed canary ferry run. Diagnose root cause and file a GitHub issue. The workflow sends the immediate Slack failure notice. Diagnosis and reporting only — no code changes, no PRs.

CI invocation context

The Loom launch includes these non-secret values in its goal. Use those values directly instead of inspecting the process environment.

VariableDescription
CANARY_LANEgpu (CoreWeave) or tpu (GCP)
CANARY_JOB_IDIris job ID
CANARY_RUN_IDW&B run ID
IRIS_CONFIGPath to Iris cluster config
IRIS_NAMESPACEKubernetes namespace (CW only)
WANDB_ENTITYW&B entity
WANDB_PROJECTW&B project
GHA_RUN_URLFull URL to the GitHub Actions run

Steps

1. Gather diagnostics

The Actions runner may have exited. Start with the diagnostics artifact linked from GHA_RUN_URL and durable Iris and Finelog logs. Use live cluster commands only when the relevant cluster is still running.

  • Iris job state via iris --config=$IRIS_CONFIG job list when accessible.
  • GPU lane: you have kubectl at ~/.kube/coreweave-iris, namespace $IRIS_NAMESPACE (defaults to iris-ci — the canary shares this namespace with PR CI). Get pod status, controller logs, task pod logs, warning events, pod describe. Filter by iris.job_id=<CANARY_JOB_ID with '/' replaced by '.'> so you only see this canary's pods, not co-tenant CI pods. Example: kubectl -n iris-ci get pods -l iris.job_id=runner.iris-run-job-abc123.
  • TPU lane: use iris process logs and iris job list.
  • Re-run scripts/ci/validate_canary_metrics.py if you need the validation output.
Show full SKILL.md (170 more words)Show less
2. Identify root cause

Classify into one of: infra/scheduling, training crash, metric regression, controller bug, data/storage.

Use hypothesis-driven diagnosis: state hypothesis, gather evidence, narrow. Attempt to reproduce the issue locally and minimally. Triple check that you're narrowing down on the same issue as the one that actually broke the canary.

3. File a GitHub issue

Follow the file-issue skill. Use the bug-report template.

  • Title: [canary-{lane}] {short failure description}
  • Labels: bug, agent-generated, canary
  • Body must include a "Canary run context" section with: lane, job ID, GHA run URL, W&B run URL, date.
  • Support your claims using supporting data (e.g. runtime logs)
  • Keep the issue concise and maximally readable for humans.
  • Use GFM to make the details (e.g. log traces, code to reproduce issue) optional and declutter the issue.
  • Use --body-file with a temp file (see file-issue skill for the pattern).
4. Publish the result

Append a typed result in the Loom channel with the issue URL, diagnosis, and GHA_RUN_URL. If root cause is unclear, state that and the best available signal.

© marin-community, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/triage-canary of marin-community/marin.

Open the folder on GitHubat commit c468793

Compare with similar skills

Triage Canary next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Triage Canary compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Triage Canary this skillmarin-community/marin3.9k—~751Automated safety check: PassApache-2.0
Kubeshark Installerkubeshark/kubeshark12k—~3.6kAutomated safety check: NotesApache-2.0
Mirrord Operatormetalbear-co/mirrord5.4k1 repos~4.6kAutomated safety check: PassMIT
KubeSphere ServiceMesh Managerkubesphere/kubesphere17k—~2.4kAutomated safety check: PassCustom licence
Senior DevOps Toolkitmaslennikov-ig/claude-code-orchestrator-kit2606 repos~1.1kAutomated safety check: NotesCustom licence
LangBot Deployment Guidelangbot-app/LangBot18k—~1.5kAutomated safety check: NotesApache-2.0

Similar skills

  • Kubeshark Installer

    kubeshark/kubeshark

    Installs and configures Kubeshark on a Kubernetes cluster, choosing between the quick CLI path and a Helm install with custom values.

    12k GitHub stars~3.6k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes
  • Mirrord Operator

    metalbear-co/mirrord

    Help users install and configure the mirrord Operator for team/enterprise environments.

    5.4k GitHub starsUsed in 1 repo~4.6k tokens
    DevOps & CloudAuto-check passed
  • KubeSphere ServiceMesh Manager

    kubesphere/kubesphere

    Installs, checks and troubleshoots the KubeSphere ServiceMesh extension (Istio, Kiali, Jaeger), including grayscale release, sidecar injection, topology and tracing issues.

    17k GitHub stars~2.4k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Senior DevOps Toolkit

    maslennikov-ig/claude-code-orchestrator-kit

    Comprehensive DevOps skill for CI/CD, infrastructure automation, containerization, and cloud platforms (AWS, GCP, Azure). Includes pipeline setup…

    260 GitHub starsUsed in 6 repos~1.1k tokens
    DevOps & CloudAuto-check: notes
  • LangBot Deployment Guide

    langbot-app/LangBot

    Deploys and configures a LangBot instance with Docker Compose or Kubernetes, covering config.yaml, the Box sandbox runtime, the plugin runtime and the global API key.

    18k GitHub stars~1.5k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Openbkn Deploy

    openbkn-ai/bkn-foundry

    Deploy or upgrade OpenBKN on a customer-authorized Linux server through the repository's deploy scripts, with preflight checks, explicit confirmation, secret handling, and post-deployment…

    661 GitHub stars~1.9k tokensUpdated today
    DevOps & CloudAuto-check: notes

More from marin-community/marin

All 41 skills in this repo
  • Noslop

    marin-community/marin

    Deslop, simplify, or review low-value tests and prose only when explicitly requested for a branch or diff.

    3.9k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Use Iris

    marin-community/marin

    Use Iris to submit, inspect, debug, monitor, or recover jobs and tasks; diagnose scheduling and federation; deploy controllers; or reserve dev GPUs and TPUs.

    3.9k GitHub stars~745 tokensUpdated today
    Auto-check passed
  • Launch Rl

    marin-community/marin

    Define, validate, submit, or restart a Marin SkyRL experiment through its artifact main.

    3.9k GitHub stars~894 tokensUpdated today
    Auto-check passed
  • Marina Applet

    marin-community/marin

    Build, validate, publish, update, inspect, query, roll back, or archive a dynamic Marina applet.

    3.9k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Query Finelog

    marin-community/marin

    Query Finelog logs and telemetry for Iris tasks, workers, profiles, training, vLLM, and cross-cluster forwarding.

    3.9k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Trace Pulumi Diff

    marin-community/marin

    Run a read-only preview for a specified Marin infra/pulumi stack and trace each pending resource change to merged pull requests since its latest successful update when that update records a clean…

    3.9k GitHub stars~663 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Triage Canary

What does Triage Canary do?

Triage a failed canary ferry run only when invoked by CI with the required CANARY context. Triage Canary is an agent skill from marin-community/marin. Triage a failed canary ferry run only when invoked by CI with the required CANARY context.

When should I use Triage Canary?

Triage Canary fits situations like: tasks that involve Deployment.

How do I install Triage Canary in Claude Code?

Run `npx skills add marin-community/marin --skill triage-canary -a claude-code`. Or copy the skill folder (.agents/skills/triage-canary in marin-community/marin) into .claude/skills/triage-canary in your project. Claude Code loads it when a task matches its description.

How do I install Triage Canary in Codex?

Run `npx skills add marin-community/marin --skill triage-canary -a codex`. Or copy the skill folder (.agents/skills/triage-canary in marin-community/marin) into .agents/skills/triage-canary in your project. Codex loads it when a task matches its description.

Can I use Triage Canary in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add marin-community/marin --skill triage-canary -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/triage-canary, .gemini/skills/triage-canary, .github/skills/triage-canary and .opencode/skills/triage-canary in your project.

What does Triage Canary need to run?

Going by SKILL.md and its folder, Triage Canary needs the command-line tools its instructions call (kubectl).

Does Triage Canary access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Triage Canary safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Triage Canary use?

Triage Canary is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Triage Canary use?

About 751 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Triage Canary?

Skills that share tags, products or a category with Triage Canary: Kubeshark Installer (kubeshark/kubeshark, 12k stars), Mirrord Operator (metalbear-co/mirrord, 5.4k stars), KubeSphere ServiceMesh Manager (kubesphere/kubesphere, 17k stars) and Senior DevOps Toolkit (maslennikov-ig/claude-code-orchestrator-kit, 260 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Triage Canary?

marin-community (a GitHub organization) maintains it in marin-community/marin, which has 3,921 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on October 10, 2026.

Source: marin-community/marin on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.