Skip to content
cccskills
FreePublished on GitHub

csharp-file-based-app

Build, run, and publish .NET applications from a single C# file without a .csproj, using .NET 10 SDK file-based apps. USE FOR: dotnet run file.cs; dotnet run --file; shebang/shell-executable C# scripts; colon-prefixed directives (sdk, package, project, property, include); converting a file-based app to a project with dotnet project convert; publishing file-based apps with native AOT; packaging a file-based app as a .NET tool (PackAsTool); user secrets for file-based apps; flat *.run.json launch profiles; dotnet build/clean/publish/pack/restore on a .cs file; build caching behavior and dotnet clean file-based-apps; folder layout to avoid project-file cone conflicts. DO NOT USE FOR: traditional .csproj solution scaffolding (use dotnet-solution-setup); C# language idioms unrelated to the SDK/CLI (use csharp-best-practices); benchmarking (use dotnet-benchmarking).

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36 stars(GitHub 36 + cccskills 0)

Run score Not tested

See how to install

Files included (3)

  • SKILL.md4.1 KB
  • references/directives-reference.md2.1 KB
  • references/runtime-behavior.md4.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

C# File-Based Apps

Requires .NET 10 SDK+. Run a single .cs file directly — the SDK generates a virtual project from #: directives, no .csproj needed.

Run, Build, Publish

CommandEffect
dotnet run file.cs / dotnet run --file file.cs / dotnet file.csRun the file-based app
dotnet run file.cs -- arg1 arg2Pass args to the app
echo 'Console.WriteLine(1);' | dotnet run -Run C# piped from stdin
dotnet build file.csBuild; output under <temp>/dotnet/runfile/<name>-<hash>/bin/<config>/
dotnet publish file.csPublish; native AOT by default → artifacts/<name>/ next to the file
dotnet pack file.csPack as a .NET tool; PackAsTool=true by default
dotnet project convert file.csMaterialize a .csproj + copy of the file in a new folder; original untouched
dotnet restore file.csRestore packages (implicit on build/run; skip with --no-restore)
dotnet clean file.csRemove build artifacts for this file
dotnet clean file-based-apps [--days N]Purge stale cached build folders (default 30 days)

Disable AOT: #:property PublishAot=false. Disable tool packaging: #:property PackAsTool=false.

#: Directives

Place at the top of the .cs file, one per line.

DirectivePurposeExample
#:sdkChoose SDK (default Microsoft.NET.Sdk)#:sdk Microsoft.NET.Sdk.Web
#:packageAdd a NuGet package#:package Serilog@3.1.1
#:projectReference another project#:project ../Shared/Shared.csproj
#:propertySet an MSBuild property#:property TargetFramework=net10.0
#:includeAdd extra source/resource files (.NET 11 Preview 3+ / SDK 10.0.300+)#:include helpers.cs

Full syntax, glob patterns, conditional property expressions, item-type mapping → references/directives-reference.md.

Key Behaviors

  • Shell execution: shebang #!/usr/bin/env -S dotnet -- + chmod +x runs the file directly on Unix (LF endings, no BOM).
  • User secrets: stable ID hashed from file path; dotnet user-secrets set "K" "V" --file file.cs.
  • Launch profiles: flat <name>.run.json next to the .cs file; traditional Properties/launchSettings.json wins if both exist.
  • Build caching: keyed on file content, directives, SDK version, implicit build files; concurrent runs of the same app can race on output — dotnet build first, then run with --no-build.
  • Folder layout: never nest a file-based app inside a .csproj's directory cone, and isolate it from ambient Directory.Build.props/Directory.Packages.props when different settings are needed.

Shebang details, secrets/launch-profile examples, caching pitfalls, folder-layout dos/don'ts → references/runtime-behavior.md.

Reference Files

FileLoad When
references/directives-reference.mdWriting/debugging #: directives, glob #:include patterns, conditional #:property expressions
references/runtime-behavior.mdShell execution, user secrets, launch profiles, build caching, folder layout guidance

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Abstract math for 3D rotation representations and conversions. USE FOR: understanding axis-angle representation; Euler angles (yaw/pitch/roll, convention choices); rotation matrices (SO(3)); quaternion-based rotation; converting between representations; identifying and avoiding gimbal lock; composing rotations; half-angle formula; right-hand rule. DO NOT USE FOR: quaternion arithmetic details (use quaternion-algebra); slerp/lerp interpolation (use interpolation-on-manifolds); coordinate system definitions (use coordinate-system-conversions).

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36Updated Aug 10, 2026

Design and scaffold multi-agent squads/swarms using the graph orchestration pattern (nodes = agents, edges = dependencies/data flow). USE FOR: designing a coordination topology for a multi-agent squad (sequential pipeline, parallel fan-out/aggregation, branching, feedback loop, cyclic); building an orchestrator agent that delegates to specialist agents; setting up an adversarial/tribunal code or document review with independent reviewers; scaffolding a squad's agent files for a target coding-agent harness (e.g. Copilot CLI or Claude Code custom agents). DO NOT USE FOR: authoring a single agent's frontmatter/prompt body (use copilot-cli-custom-agents, claude-code-custom-agents, or the target harness's own skill); SKILL.md authoring (use create-skill); ad-hoc multi-agent chat with no explicit topology.

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36Updated Aug 10, 2026

Find, inspect, query, redact, and troubleshoot logs, transcripts, sessions, and OpenTelemetry data from coding-agent harnesses on Windows, macOS, Linux, and WSL. USE FOR: GitHub Copilot in VS Code; Copilot CLI; Claude Code; OpenAI Codex; Gemini CLI; OpenCode; Cursor, Windsurf, Kiro, or other VS Code-family editors; locating log files; diagnosing tool or model failures; correlating turns, subagents, and tool calls; querying JSONL, plaintext, or SQLite without spending model tokens; preparing sanitized diagnostics. DO NOT USE FOR: application logs unrelated to coding agents; uploading raw logs; treating unstable transcript schemas as public APIs.

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36Updated Aug 10, 2026

Author and maintain AGENTS.md files — the open, tool-agnostic format for giving coding agents project context. Use when: creating AGENTS.md; writing an agent instructions file; root or nested AGENTS.md for monorepos; migrating CLAUDE.md, AGENT.md, .cursor/rules, or copilot-instructions.md to AGENTS.md; greenfield project setup before code exists; brownfield onboarding for an existing codebase; documenting build/test/lint commands, code style, PR/commit conventions, and security considerations for agents; AGENTS.md discovery and precedence rules. Works for any language, framework, or project size. DO NOT USE FOR: authoring SKILL.md skill files (use create-skill); APM package/plugin authoring (use apm-producer); language-specific style rules (use language skills e.g. csharp-best-practices).

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36Updated Aug 10, 2026

Abstract math for angle measurement, unit systems, and circular arithmetic. USE FOR: implementing angle types; converting between degrees/radians/gradians/revolutions; reducing angles to canonical range [0, Full); computing reference angles and quadrants; implementing safe modular arithmetic with negative inputs; angle addition and subtraction; classifying angles by sign and size. DO NOT USE FOR: trigonometric functions (use trigonometric-functions); coordinate conversions (use coordinate-system-conversions); interpolation (use interpolation-on-manifolds).

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36Updated Aug 10, 2026

Create and maintain Claude Code custom subagents (.claude/agents/*.md files). USE FOR: authoring project (.claude/agents/) or user (~/.claude/agents/) subagent files; frontmatter fields (name, description, tools, disallowedTools, model, permissionMode, maxTurns, skills, mcpServers, hooks, memory, background, effort, isolation, color, initialPrompt); writing descriptions that drive automatic delegation and 'use proactively' phrasing; invoking subagents via natural language, @-mention, session-wide --agent, or the Agent tool; restricting which subagent types a coordinator can spawn with Agent(name1, name2); nested subagents and depth limits; built-in subagents (Explore, Plan, general-purpose, claude); troubleshooting a subagent that won't load or isn't invoked. DO NOT USE FOR: GitHub Copilot CLI custom agents (use copilot-cli-custom-agents); agent teams/teammates (a different, session-spanning feature); MCP server authoring; SKILL.md authoring (use create-skill).

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36Updated Aug 10, 2026

See all skills by NetFabric

Report a problem with this skill