Overview
Executable C# Evidence with csrun builds and runs standalone C# console programs and genuine xUnit v3 tests through C# Example & Test Runner (csrun) and its schema version 1 manifest contract. It covers four workflows — create, verify, repair, and audit — so documentation snippets, library examples, and minimal reproductions are backed by real runtime observations rather than assumed correctness.
Every compatible deliverable is generated from one canonical manifest into two self-contained PowerShell 7 execution blocks: one for a native .NET environment and one for a disposable Linux Docker container. Both resolve and SHA-256-verify the latest stable csrun release at runtime, keep exact package pins and target frameworks intact, and report each transport's verification status independently.
Concepts
- Feasibility before execution: inspects source, imports, entry points, dependencies, and host assumptions first — classifying each sample as
Compatible,Adaptable,Unsupported, orUndeterminedbefore constructing a manifest so multi-project or entrypoint-owned application topologies are separated from standalone execution. - One manifest, two transports: derives independent Native and disposable Docker PowerShell 7 blocks from a single canonical manifest with exact
PackageId@Versionpins, never promoting one transport's outcome as proof for the other. - Honest evidence classification: separates
Verified,Compiled only,Unverified, andFailedoutcomes using captured stdout, stderr, exit status, and positive xUnit v3 / Microsoft Testing Platform discovery counts instead of treating exit zero or zero discovered tests as a pass. - Semantics-preserving repair and audit: keeps
verifystrictly read-only, preserves original failure evidence during authorized repairs, never weakens assertions or alters intent to force a pass, and leaves intentionally partial documentation excerpts intact during scoped audits.
Installation
npx skills add https://github.com/codebeltnet/agentic --skill dotnet-csrun
Usage guidance
Invoke this skill when creating a new runnable C# example or isolated xUnit v3 test, verifying whether existing code or documentation snippets still run, repairing broken examples without changing their intent, or auditing documentation fences across a scope. It composes with .NET DocFX Digest Steward for standalone documentation examples while keeping repository-backed integration examples, repository test suites (.NET Test, .NET Remote Testing), and performance experiments (.NET Benchmark) in their own workflows.
Native and Docker prerequisites are probed independently so a missing host SDK does not block Docker execution and an unavailable Docker daemon does not block native execution. When neither transport is available for the requested framework, the skill preserves the target framework, names the missing prerequisites, and delivers both runnable blocks explicitly marked Unverified.