Name: FunnySharp.DocumentationSamples
Author: wxxb789

Imported from wxxb789/funnysharp (examples/FunnySharp.DocumentationSamples/AGENTS.md). Install upstream with npx skills add wxxb789/funnysharp --skill FunnySharp.DocumentationSamples. Copyright stays with the author.

FunnySharp.DocumentationSamples/ — docs snippet source of truth

Earned: score ~8 — distinct domain (docs-guide snippet parity, byte-exact).

OVERVIEW

The compiled source of every csharp code block in the 10 primary guides. Snippets are extracted from this project and byte-compared against docs/*.md — edit here, then the doc.

WHERE TO LOOK

Need	Location
Snippet verifier	`eng/harness/DocsSnippets.fs` via `dotnet fsi build.fsx -- -p verify-docs-snippets`
Sample files	one per guide area: `AnalyzerSamples`, `AspNetCoreSamples`, `CollectionsSamples`, `ConcurrencySamples`, `EffectSamples`, `FunctionCompositionSamples`, `ImmutableUpdateSamples`, `StateMachineSamples`, `UnitResultSamples`, `ValidationSamples`
Region markers	`// <snippet DocumentationSamples.<Area>.<Name>>` … `// </snippet>` — 44 regions total; the marker is the consumed interface
Docs counterpart	fenced `csharp` blocks tagged `<!-- documentation-sample: ... -->` in the 10 primary guides

CONVENTIONS

Snippets are extracted DEDENTED and compared byte-for-byte (every line) — whitespace and comment placement inside a region matter. A snippet must appear in exactly one guide; duplicate, unused, or missing regions all fail the verifier.
Samples are internal static classes with private static snippet methods — code exists to be quoted, not called; the project builds (net10.0, IsPackable=false) mainly so it compiles and analyzes clean.
Analyzer dogfooding applies: analyzer + code-fix projects referenced as analyzers, so the samples must build with zero FunnySharp diagnostics.

ANTI-PATTERNS

NEVER remove the #pragma warning disable FS100x blocks wrapping deliberate-misuse snippets in AnalyzerSamples.cs — each carries a "Deliberate misuse" comment; removing the pragma breaks the samples-clean invariant.
NEVER edit a guide's fenced block without updating the matching region here (or the verifier fails the parity check).

COMMANDS

dotnet build examples/FunnySharp.DocumentationSamples/FunnySharp.DocumentationSamples.csproj -c Release
dotnet fsi build.fsx -- -p verify-docs-snippets

Install FunnySharp.DocumentationSamples and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "wxxb789-funnysharp-funnysharp-documentationsamples", "kind": "skill", "name": "FunnySharp.DocumentationSamples", "description": "The compiled source of every `csharp` code block in the 10 primary guides. Snippets are extracted from this project and byte-compared against `docs/*.md` — edit here, then the doc.", "publisher": "wxxb789", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "The compiled source of every `csharp` code block in the 10 primary guides. Snippets are extracted from this project and byte-compared against `docs/*.md` — edit here, then the doc." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/wxxb789/funnysharp", "path": "examples/FunnySharp.DocumentationSamples/AGENTS.md", "ref": "894ff679929c180c296790849978c95683a52519", "url": "https://github.com/wxxb789/funnysharp/blob/894ff679929c180c296790849978c95683a52519/examples/FunnySharp.DocumentationSamples/AGENTS.md", "key": "wxxb789/funnysharp/examples/FunnySharp.DocumentationSamples/AGENTS.md" } }, "instructions": "# FunnySharp.DocumentationSamples/ — docs snippet source of truth\n\n**Earned:** score ~8 — distinct domain (docs-guide snippet parity, byte-exact).\n\n## OVERVIEW\n\nThe compiled source of every `csharp` code block in the 10 primary guides. Snippets are\nextracted from this project and byte-compared against `docs/*.md` — edit here, then the doc.\n\n## WHERE TO LOOK\n\n| Need | Location |\n| --- | --- |\n| Snippet verifier | `eng/harness/DocsSnippets.fs` via `dotnet fsi build.fsx -- -p verify-docs-snippets` |\n| Sample files | one per guide area: `AnalyzerSamples`, `AspNetCoreSamples`, `CollectionsSamples`,", "cost": { "context_tokens": 546 } }

FunnySharp.DocumentationSamples

About