OpenAPI.NET
AGENTS.md1.6k starsChanged 9 months agoMITView on GitHub
Trending
More talk lately.about the whole repository
Who's talking about microsoft/OpenAPI.NET
- dotnet/aspnetcore“Add built-in support for generating OpenAPI document from APIs”GitHub · Mar 18, 2024 · 80 reactions
- dotnet/aspnetcore“Introduce Microsoft.AspNetCore.OpenApi package”GitHub · Mar 12, 2022 · 43 reactions
- swagger-api/swagger-ui“fix: adds version 3.0.4 and 3.1.1 to supported versions”GitHub · Dec 27, 2024 · 12 reactions
- dotnet/aspnetcore“Microsoft.AspNetCore.OpenApi should support annotated enumerations.”GitHub · Mar 29, 2026 · 11 reactions
- xunit/xunit“documentation - Fluent Assertion migration guidance”GitHub · Jan 15, 2025 · 7 reactions
The biggest 5 of 55 mentions linking to the repository that our crawl found. Each line is their own headline.
See all 55
Talked about on GitHub, Stack Overflow and Bluesky (55 times).
On GitHub · 50
- Mar 18, 2024Add built-in support for generating OpenAPI document from APIs — dotnet/aspnetcore80 reactions · 73 comments
- Mar 12, 2022Introduce Microsoft.AspNetCore.OpenApi package — dotnet/aspnetcore43 reactions · 12 comments
- Dec 27, 2024fix: adds version 3.0.4 and 3.1.1 to supported versions — swagger-api/swagger-ui12 reactions · 31 comments
- Mar 29, 2026Microsoft.AspNetCore.OpenApi should support annotated enumerations. — dotnet/aspnetcore11 reactions · 3 comments
- Jan 15, 2025documentation - Fluent Assertion migration guidance — xunit/xunit7 reactions · 16 comments
45 more on GitHub
- Nov 25, 2025OpenAPI: OpenApiSecuritySchemeReference is not resolved — dotnet/aspnetcore6 reactions · 5 comments
- Dec 23, 2024adds support for OpenAPI 3.1 descriptions — microsoft/kiota6 reactions · 7 comments
- Dec 14, 2024Upgrade to Microsoft.OpenApi 2.x and support OpenAPI v3.1 — dotnet/aspnetcore5 reactions · 4 comments
- Jul 1, 2018"Guidelines for Naming Projects, Tools, or Organizations" section in the readme — OAI/OpenAPI-Style-Guide5 reactions · 25 comments
- Jan 21, 2026Support for AsyncAPI — dotnet/aspnetcore4 reactions · 1 comment
- Sep 23, 2025.NET 10 Support, breaking changes — SteveDunn/Vogen3 reactions · 1 comment
- Oct 20, 2022Identify long-term strategy for JSON schema generation — domaindrivendev/Swashbuckle.AspNetCore2 reactions · 1 comment
- Mar 10, 2026What's New 11 P2 follow up suggestions — dotnet/AspNetCore.Docs1 reaction
- Feb 19, 2026[release/11.0-preview2] feat: adds support for OpenAPI 3.2.0 — dotnet/aspnetcore1 reaction · 3 comments
- Jan 19, 2026Bump Microsoft.OpenApi.OData from 1.7.5 to 3.1.0 — christianhelle/curlgenerator-dotnet1 reaction · 2 comments
- Dec 23, 2025Upgrade Swashbuckle.AspNetCore to v10 with Microsoft.OpenApi v2.x compatibility — MakeBoldSolutions/RequestSpark1 reaction
- Nov 18, 2025Bump Microsoft.OpenApi.OData from 1.7.5 to 3.0.0 — christianhelle/curlgenerator-dotnet1 reaction · 2 comments
- Nov 13, 2025Bump Microsoft.OpenApi.OData from 1.7.5 to 3.0.0 — christianhelle/curlgenerator1 reaction · 3 comments
- Nov 11, 2025TypeError: option.match is not a function — googleapis/release-please1 reaction
- Nov 1, 2025Bump Microsoft.OpenApi.OData from 1.7.5 to 2.0.0 — christianhelle/curlgenerator-dotnet1 reaction · 2 comments
- Sep 16, 2025Bump Microsoft.OpenApi.OData from 1.7.5 to 2.0.0 — christianhelle/curlgenerator1 reaction · 5 comments
- Sep 8, 2025Bump Microsoft.OpenApi.OData from 1.7.5 to 2.0.0 — christianhelle/curlgenerator1 reaction · 3 comments
- Sep 3, 2025Bump Microsoft.OpenApi.OData from 1.7.5 to 2.0.0 — christianhelle/curlgenerator1 reaction · 3 comments
- Sep 1, 2025Bump Microsoft.OpenApi.OData from 1.7.5 to 2.0.0 — christianhelle/curlgenerator1 reaction · 3 comments
- Sep 1, 2025Bump Microsoft.OpenApi.OData from 1.7.5 to 2.0.0 — christianhelle/curlgenerator1 reaction · 3 comments
- Aug 15, 2025Bump Microsoft.OpenApi.OData from 1.7.5 to 2.0.0 — christianhelle/curlgenerator1 reaction · 3 comments
- Aug 7, 2025Bump Microsoft.OpenApi.OData from 1.7.5 to 2.0.0 — christianhelle/curlgenerator1 reaction · 3 comments
- Aug 4, 2025Bump Microsoft.OpenApi.OData and 2 others — christianhelle/curlgenerator1 reaction · 4 comments
- Jun 2, 2025Direct and transitive dependencies cannot be distinguished based on result — aboutcode-org/nuget-inspector1 reaction · 1 comment
- Apr 2, 2025Bump Microsoft.OpenApi.Readers from 1.6.23 to 1.6.24 — christianhelle/curlgenerator1 reaction · 2 comments
- Dec 23, 2024Bump Microsoft.OpenApi.Readers from 1.6.22 to 1.6.23 — christianhelle/curlgenerator1 reaction · 2 comments
- Nov 26, 2024.Net: Migrate to OpenAPI.Net v2 SDK — microsoft/semantic-kernel1 reaction · 2 comments
- Oct 1, 2024Bump Microsoft.OpenApi.Readers from 1.6.21 to 1.6.22 — christianhelle/curlgenerator1 reaction · 3 comments
- Sep 6, 2024Bump Microsoft.OpenApi.Readers from 1.6.18 to 1.6.21 — christianhelle/curlgenerator1 reaction · 2 comments
- Sep 2, 2024Bump Microsoft.OpenApi.Readers from 1.6.18 to 1.6.19 — christianhelle/curlgenerator1 reaction · 2 comments
- Aug 7, 2024Bump Microsoft.OpenApi.Readers from 1.6.16 to 1.6.17 — christianhelle/curlgenerator1 reaction · 2 comments
- Nov 23, 2023Bump Microsoft.OpenApi.Readers from 1.6.10 to 1.6.11 — christianhelle/httpgenerator1 reaction · 2 comments
- Nov 23, 2023Bump Microsoft.OpenApi.Readers from 1.6.9 to 1.6.11 — christianhelle/refitter1 reaction · 3 comments
- Nov 13, 2023Bump Microsoft.OpenApi.Readers from 1.6.9 to 1.6.10 — christianhelle/httpgenerator1 reaction · 1 comment
- Oct 31, 2023Bump Microsoft.OpenApi.Readers from 1.6.9 to 1.6.10 — christianhelle/refitter1 reaction · 3 comments
- Sep 26, 2022Support configuring document-level parts of OpenAPI schema — dotnet/aspnetcore1 reaction · 2 comments
- Sep 2, 2022API response details are not shown in swagger when using WithOpenApi() method with OpenApiOperation copy constructor — dotnet/aspnetcore1 reaction · 1 comment
- Aug 1, 2022Add Package Icon — AzureAD/microsoft-authentication-library-for-dotnet1 reaction · 7 comments
- May 19, 2022Basic connector support — microsoft/Power-Fx1 reaction · 2 comments
- Nov 6, 2026Bump Azure.Core and 15 others — bcgov/pssg-cscp-restitution0 reactions
- Oct 19, 2026fix(deps): update dependency microsoft.openapi.readers to 1.6.31 [security] — IvanJosipovic/KubeCRDStore0 reactions · 2 comments
- Apr 28, 2026Bump Microsoft.OpenApi from 1.6.22 to 3.5.3 — mdesantis1984/ThisCloud.Framework0 reactions
- Apr 15, 2026Bump Microsoft.OpenApi.OData from 1.7.5 to 3.2.1 — christianhelle/curlgenerator-dotnet0 reactions
- Apr 9, 2026Bump Microsoft.OpenApi.OData from 1.7.5 to 3.2.0 — christianhelle/curlgenerator-dotnet0 reactions · 1 comment
- Jan 22, 2026Bump Microsoft.OpenApi from 1.6.24 to 3.3.1 — microsoftgraph/kibali0 reactions
On Stack Overflow · 4
- Oct 8, 2022Dynamically generate OpenApiSchema in C# from Dynamic Json Object2 votes · 1 answer
- Dec 22, 2025Downgrading OpenAPI 3.1 generated by FastAPI to 3.0 for Azure API Management1 vote
- Oct 24, 2022Specify Multipart File Upload with Swashbuckle .NET1 vote
- Jan 29, 2020How to parse extensions of yaml in OpenApi.NET into .NET classes?1 vote
On Bluesky · 1
- Nov 24, 2024I have tried the autocompletion and linting/tooling route. Perhaps the higher level language route that expresses exactly the same thing… — @bjartnes.bsky.social1 likes and repost · 2 replies
Where files are headingNew AGENTS.md files have more rules about keeping secrets out of the code, and fewer about code style.
Of the AGENTS.md files we read, the 31,542 first seen in the last six months, against the older ones: the kind of rule that gained most share, and the kind that lost most. About files like this in general, not this one, and an estimate, since a kind is a pattern in the words.
In this repositoryOne other file it gives its agents.
- .github/copilot-instructions.mdCopilot instructions
The file
We split this agents.md into the rules it gives an agent
2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 5
Use conditional compilation to provide a regular Regex with the same pattern and an explicit match timeout for older targets.
- Distinctive: line 7
Keep shared patterns in constants and reference those constants in validation diagnostics and tests.
≈ “Common” is an estimate: at least 1 in 5 of the 40,246 AGENTS.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Regex handling
- Analyze regex patterns for matching complexity and excessive backtracking, including on long and near-matching inputs. Prefer equivalent patterns with less backtracking when available, while preserving matching semantics and target-framework compatibility.
- For fixed patterns on modern targets, use source-generated regexes with explicit match timeouts (
GeneratedRegexunderNET8_0_OR_GREATER). - Use conditional compilation to provide a regular
Regexwith the same pattern and an explicit match timeout for older targets. Do not duplicate regex validation with a manually maintained character scanner. - Older-runtime regex matching may still time out under load because timeouts use wall-clock time. If consumers encounter this limitation, recommend upgrading to a modern runtime that uses the source-generated implementation.
- Keep shared patterns in constants and reference those constants in validation diagnostics and tests.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

