congiuluc/api-documentation
skills/api-documentation/SKILL.md
Configure Swagger/OpenAPI documentation for .NET Minimal API endpoints. Use when: adding endpoint metadata, configuring Swagger UI, documenting API schemas, adding response types, or setting up OpenAPI generation.
development
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add congiuluc/my-awesome-copilot api-documentationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 1:22 PM18.1s2 files scanned
SKILL.md
- name:
- api-documentation
- description:
- Configure Swagger/OpenAPI documentation for .NET Minimal API endpoints. Use when: adding endpoint metadata, configuring Swagger UI, documenting API schemas, adding response types, or setting up OpenAPI generation.
- argument-hint:
- Describe the endpoint or schema to document with OpenAPI.
API Documentation (Swagger/OpenAPI)
When to Use
- Adding or modifying API endpoint metadata
- Configuring Swagger UI or OpenAPI document generation
- Documenting request/response schemas
- Setting up environment-specific API docs behavior
Official Documentation
- OpenAPI in ASP.NET Core
- Swagger UI
- OpenAPI Specification
- Scalar API Reference
Procedure
- Register OpenAPI in
Program.cs— see setup guide - Review sample endpoint documentation
- Annotate every endpoint with
WithName,WithSummary,Produces<T> - Group endpoints with
.WithTags("Feature") - Ensure all DTOs have XML doc comments for schema descriptions
- Configure environment-specific behavior (dev: enabled, prod: disabled)
- Verify API docs render correctly at
/swagger
Related Skills
congiuluc/vscode-extension
tools
VerifiedTrustedCommunity
Build VS Code extensions with TypeScript. Covers extension anatomy, activation events, commands, tree views, webview panels, language features, testing, and publishing. Use when: creating a new VS Code extension, adding commands/views/providers, building webview UIs, implementing language server features, testing extensions, or packaging for the marketplace.
SKILL.mdUpdated Apr 16, 2026
congiuluc/version-tracking
development
VerifiedTrustedCommunity
Track implementations, features, bugs, and releases in a versioning document. Use when: adding a commit, completing a feature, fixing a bug, or preparing a release. Automatically updates CHANGELOG.md following Keep a Changelog format and Semantic Versioning.
SKILL.mdUpdated Apr 16, 2026
congiuluc/testing-frontend
development
VerifiedTrustedCommunity
Write frontend tests using Vitest and React Testing Library. Use when: testing React components, hooks, user interactions, form submissions, accessibility assertions, or mocking API services.
SKILL.mdUpdated Apr 16, 2026
congiuluc/testing-frontend-angular
development
VerifiedTrustedCommunity
Write Angular frontend tests using Jasmine, Karma, and Angular TestBed. Use when: testing Angular components, services, pipes, directives, user interactions, form submissions, accessibility assertions, or mocking HTTP services.
SKILL.mdUpdated Apr 16, 2026