Dart-ci assists in monitoring, viewing, and rerunning failed DART CI/CD jobs on GitHub Actions.

Install

mkdir -p .claude/skills/dart-ci && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/6926" && unzip -o skill.zip -d .claude/skills/dart-ci && rm skill.zip

Installs to .claude/skills/dart-ci

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

DART CI: GitHub Actions, cache debugging, and platform-specific failures
72 charsno explicit “when” trigger
Intermediate

Key capabilities

  • →Monitor PR checks
  • →Debug failed CI runs
  • →Rerun failed GitHub Actions jobs
  • →Analyze platform-specific failures

How it works

The skill interacts with GitHub Actions to inspect logs, analyze failures, and manage job reruns.

Inputs & outputs

You give it
CI run ID or PR number
You get back
CI failure analysis or rerun status

When to use dart-ci

  • →Monitor PR check status
  • →Debug failed CI runs
  • →Rerun failed GitHub Actions jobs
  • →Analyze platform-specific CI failures

About this skill

DART CI/CD Troubleshooting

Load this skill when debugging CI failures or working with GitHub Actions.

When the failing claim depends on model/scene structure, physics behavior, or OSG output, also load dart-verify-sim and reproduce it with a text oracle plus assessed visual evidence. Document a visual exception when OSG/Xvfb is unavailable or not applicable in the failing environment.

Quick Commands

# Monitor PR checks
gh pr checks <PR_NUMBER>
gh pr view <PR_NUMBER> --json headRefOid,mergeStateStatus,statusCheckRollup

# View run details
gh run list --branch <BRANCH> -e pull_request -L 20
gh run view <RUN_ID> --json status,conclusion,url

# Debug failures
gh run view <RUN_ID> --job <JOB_ID> --log-failed
gh run view <RUN_ID> --json jobs --jq '.jobs[] | {name, databaseId}'

# Rerun failed jobs only after explicit maintainer/user approval
gh run rerun <RUN_ID> --failed
gh run rerun <RUN_ID> --job <DATABASE_ID>

Full Documentation

For complete CI/CD guide: docs/onboarding/ci-cd.md

Common Failure Modes

Failure TypeSolution
Formatting failspixi run lint; push only after approval
Codecov patch failsAdd tests for uncovered lines
FreeBSD RTTI failsUse type enums + static_cast instead of dynamic_cast
macOS ARM64 SEGFAULTReplace alloca()/VLAs with std::vector<T>
RTD build failsUse defensive .get(key, default) patterns
gz-physics failsReproduce with pixi run -e gazebo test-gz

Workflow Architecture

The CI workflows that a failing PR check belongs to (full 12-workflow index: docs/onboarding/ci-cd.md § "Workflow Index"):

WorkflowPurposePlatforms
ci_ubuntu.ymlAI checks, lint, build, test, coverageUbuntu
ci_macos.ymlLint, build, testmacOS
ci_windows.ymlLint, build, testWindows
ci_freebsd.ymlBuild + test (VM)FreeBSD
ci_simd.ymlSIMD x86 instruction-level matrixUbuntu x86_64
ci_toolchain.ymlAlternate toolchain build + testUbuntu
ci_gz_physics.ymlGazebo integrationUbuntu
api_doc.ymlDoxygen API docs buildUbuntu

Downstream Compatibility Policy

Package, exported-target, collision, constraint, and dependency changes can affect Gazebo/gz-physics even when local unit tests pass. Reproduce those failures with the Gazebo Pixi environment when practical: pixi run -e gazebo test-gz.

Fast Iteration Loop

  1. Identify failing step from job logs
  2. Reproduce locally with same build toggles
  3. Fix the smallest failing test
  4. Push only after explicit maintainer/user approval, then monitor: gh run view <RUN_ID> --json status,conclusion,url

Caching And Duration

Treat the current run and job logs as authoritative. Inspect cache restore/save steps and job timestamps before changing a key; do not rely on fixed duration or cache-speed estimates in this skill.

When not to use it

  • →Untrusted fork-PR code on GPU runners

Prerequisites

GitHub CLI access

Limitations

  • →GPU runner must never run untrusted fork-PR code
  • →Requires explicit approval for reruns

How it compares

It provides specialized troubleshooting commands for DART CI/CD workflows rather than generic CI commands.

Compared to similar skills

dart-ci side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
dart-ci (this skill)14moReviewIntermediate
e2e-testing-patterns84moNo flagsIntermediate
testing-workflow1611moReviewIntermediate
perf-lighthouse137moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

Search skills

Search the agent skills registry