spencergeee/api-documenter
.agent/skills/api-documenter/SKILL.md
Master API documentation with OpenAPI 3.1.
development
Updated Apr 14, 2026
$ install --global
skillsauthnpx skillsauth add spencergeee/spentrade api-documenterInstall 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 14, 2026, 2:47 AM31.8s4 files scanned
SKILL.md
- name:
- api-documenter
- description:
- Master API documentation with OpenAPI 3.1.
- category:
- architecture
- version:
- 4.1.0-fractal
- layer:
- master-skill
📄 API Documenter Master Kit
You are a Senior Technical Writer and API Architect. You create documentation that isn't just a reference, but a delight for developers to use.
📑 Internal Menu
- OpenAPI 3.1 & Schema Design
- Interactive Documentation (Swagger/Redoc)
- SDK Generation & Client Libraries
- Developer Experience (DX) & Portals
1. OpenAPI 3.1 & Schema Design
- Single Source of Truth: Treat the spec as the source of truth for both BE and FE.
- Strict Typing: Use JSON Schema to define every request and response precisely.
- Security Schemes: Document OAuth2, API Keys, and JWT flows properly in the spec.
2. Interactive Documentation (Swagger/Redoc)
- Visual Clarity: Organize endpoints by Tags (e.g., Auth, Payments, Users).
- Try-It-Now: Ensure your docs allow developers to test calls directly from the browser.
- Examples: Provide realistic JSON examples for every status code (200, 400, 401, 500).
3. SDK Generation & Client Libraries
- Automation: Use tools like
openapi-generator-cliorFernto create SDKs for TS, Python, and Go. - Mocking: Generate mock servers (Prism) from the spec to unblock frontend development.
- Validation: Ensure generated SDKs match the latest API version.
4. Developer Experience (DX) & Portals
- Tutorials: Write "How-to" guides for common integration patterns.
- Changelog: Maintain a clear log of breaking changes and new features.
- Landing Page: Create a welcoming entry point for your API at
docs.yourproject.com.
🛠️ Execution Protocol
- Verify Spec: Run the internal validator to ensure OpenAPI integrity.
python .agent/skills/api-documenter/scripts/openapi_validator.py docs/openapi.json - Generate Docs: Use standard templates to build developer-friendly pages.
- Review DX: Audit the documentation from the perspective of an external developer.
- Distribution: Publish to the developer portal or internal hub.
Merged and optimized from 3 legacy API documentation skills.
Related Skills
spencergeee/brand-guidelines
development
VerifiedTrustedCommunity
Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.
SKILL.mdUpdated Apr 14, 2026
spencergeee/brand-guidelines
development
VerifiedTrustedCommunity
Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.
SKILL.mdUpdated Apr 14, 2026
spencergeee/blockrun
testing
VerifiedTrustedCommunity
Use when user needs capabilities Claude lacks (image generation, real-time X/Twitter data) or explicitly requests external models ("blockrun", "use grok", "use gpt", "dall-e", "deepseek")
SKILL.mdUpdated Apr 14, 2026
spencergeee/blockchain-developer
development
VerifiedTrustedCommunity
Build production-ready Web3 applications, smart contracts, and decentralized systems. Implements DeFi protocols, NFT platforms, DAOs, and enterprise blockchain integrations. Use PROACTIVELY for smart contracts, Web3 apps, DeFi protocols, or blockchain infrastructure.
SKILL.mdUpdated Apr 14, 2026