Agent Docs Api Openapi
This agent generates and maintains OpenAPI 3.0 specifications for your REST APIs. It scans your route files and controllers, then creates comprehensive YAML documentation with endpoints, schemas, request/response examples, and security definitions. The setup restricts it to docs and API directories, blocks it from executing bash commands, and keeps it focused on YAML/JSON files under 2MB. The pre-execution hook automatically hunts for route files to speed things up. Honestly, this is more useful for bootstrapping API docs from existing code than ongoing maintenance, since keeping OpenAPI specs in sync with actual implementations is always a manual battle. Works well if you need structured API documentation quickly.
- skills.sh installs
- 1.2K
- GitHub stars
- 81.4K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add ruvnet/ruflo --skill agent-docs-api-openapi --agent claude-codeInstalls into .claude/skills of the current project.
Files
name: "api-docs"
description: "Expert agent for creating and maintaining OpenAPI/Swagger documentation"
color: "indigo"
type: "documentation"
version: "1.0.0"
created: "2025-07-25"
author: "Claude Code"
metadata:
specialization: "OpenAPI 3.0 specification, API documentation, interactive docs"
complexity: "moderate"
autonomous: true
triggers:
keywords:
- "api documentation"
- "openapi"
- "swagger"
- "api docs"
- "endpoint documentation"
file_patterns:
- "**$openapi.yaml"
- "**$swagger.yaml"
- "**$api-docs/**"
- "**$api.yaml"
task_patterns:
- "document * api"
- "create openapi spec"
- "update api documentation"
domains:
- "documentation"
- "api"
capabilities:
allowed_tools:
- Read
- Write
- Edit
- MultiEdit
- Grep
- Glob
restricted_tools:
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/ruvnet/ruflo
- Categories
- Backend & APIs, Documentation, AI & Agent Building
- First seen
- Jun 3, 2026
More from ruvnet/ruflo
All 236- Flow Nexus Swarm1.2K
- Agent Tester1.2K
- Stream Chain1.2K
- Agent Data Ml Model1.2K
- Agent Agentic Payments1.2K
- Agent Performance Monitor1.2K
- Agent Memory Coordinator1.1K
- Agent Safla Neural1.1K
- Agent Dev Backend Api1.1K
- Hive Mind Advanced1.1K
- Agent Neural Network1.1K
- Agent Coder1.1K
- Flow Nexus Neural1.1K
- Agent Code Review Swarm1.1K
- Agent Agent1.1K
- Agent Tdd London Swarm1.1K
- Neural Training1.1K
- Agent Automation Smart Agent1.1K
- Agent Consensus Coordinator1.1K
- Agent Github Modes1.1K
- Agent Goal Planner1.1K
- Agent Issue Tracker1.1K
- Agent Reviewer1.1K
- Agent Topology Optimizer1.1K
Recommended
More Backend & APIs
rust-backendwindmill-labs/windmillRust coding guidelines for the Windmill backend. MUST use when writing or modifying Rust code in the backend directory.1.1Kskills.sh installs
lambda-labs-gpu-cloudorchestra-research/ai-research-skillsReserved and on-demand GPU cloud instances for ML training and inference. Use when you need dedicated GPU instances with simple SSH access, persistent filesyste1Kskills.sh installs
compose-slot-api-patternchrisbanes/skillsUse when designing or reviewing a reusable Jetpack Compose component whose visual regions vary by caller, or when primitive content parameters and boolean shape970skills.sh installs
api-developmentmindrally/skillsGuidelines for building clean, scalable APIs with Go standard library and NestJS TypeScript, covering security, validation, and modular architecture.856skills.sh installs
tg-ws-proxy-telegram-socks5aradotso/trending-skillstg ws proxy telegram socks5837skills.sh installs