Menu
Debug failing GitHub Actions CI runs for DotSerial. Use when a CI build or test is failing on GitHub Actions and you need to understand why and fix it.
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.
Based on SOC occupation classification
Verify and add the required copyright header to DotSerial C# source files. Use when creating a new .cs file or when a file is missing the header.
Format a Conventional Commits message for DotSerial changes. Use when asked to write a commit message, format a commit, or check if a message follows the project's commit conventions.
Build and test the DotSerial project. Use when asked to build, run tests, check CI status, or verify that changes don't break the build or test suite.
Step-by-step guide for adding a new platform implementation to DotSerial. Use when asked to add support for a new OS, transport, or connection type.
Pack and verify the DotSerial NuGet package. Use when asked to pack, publish, or verify the NuGet output for the DotSerial library.
| name | ci-debug |
| description | Debug failing GitHub Actions CI runs for DotSerial. Use when a CI build or test is failing on GitHub Actions and you need to understand why and fix it. |
| allowed-tools | shell |
When a CI run fails, follow this systematic process using the GitHub MCP tools.
Use GitHub MCP tools to list recent workflow runs:
list_workflow_runs for the pvagnozzi/DotSerial repositoryci.yml and publish.ymlUse: summarize_job_log_failures for the failing run ID to get a concise AI summary of what failed.
If more detail is needed: get_job_logs or get_workflow_run_logs.
| Symptom | Likely cause | Fix |
|---|---|---|
| Build warns treated as errors | New warning in code | Fix the warning; don't suppress it |
CS1591 missing XML doc | New public member without doc comment | Add <summary> |
CS8600/CS8601 nullable | Nullable reference not handled | Fix nullability properly |
dotnet test fails on Linux/macOS | Platform-specific code path | Check RuntimeInformation guards |
| NuGet restore fails | Version constraint conflict | Check *.csproj PackageReference versions |
publish.yml fails | Tag format wrong or NuGet key missing | Tag must start with v; check NUGET_API_KEY secret |
# Match what CI does:
dotnet restore
dotnet build --no-restore -c Release
dotnet test tests/DotSerial.Tests.Unit --no-build -c Release
CI runs on three OS: ubuntu-latest, windows-latest, macos-latest.
A failure on one OS but not others usually indicates:
Path.Combine, never string concatenation with /)RuntimeInformation.IsOSPlatform() check missing.github/workflows/ci.yml.github/workflows/publish.yml