a5c-ai/babysitter / library/specializations/code-migration-modernization/skills/api-inventory-scanner
api-inventory-scanner
VerifiedDiscover and document existing API endpoints from code, logs, and traffic analysis
SKILL.md
View on GitHub---
name: api-inventory-scanner
description: Discover and document existing API endpoints from code, logs, and traffic analysis
allowed-tools: ["Bash", "Read", "Write", "Grep", "Glob", "Edit"]
graph:
domains: [domain:software-engineering]
specializations: [specialization:code-migration-modernization]
skillAreas: [skill-area:api-design, skill-area:api-doc-generation]
roles: [role:architect, role:tech-lead]
workflows: [workflow:technical-debt-reduction]
topics: [topic:refactoring]
---
# API Inventory Scanner Skill
Discovers and documents existing API endpoints through code analysis, log inspection, and traffic analysis.
## Purpose
Enable API discovery for:
- Endpoint discovery
- Request/response format extraction
- Authentication method detection
- Rate limit identification
- Consumer mapping
## Capabilities
### 1. Endpoint Discovery
- Parse route definitions
- Analyze controller code
- Inspect API frameworks
- Find undocumented endpoints
### 2. Request/Response Format Extraction
- Extract request schemas
- Document response formats
- Identify query parameters
- Map headers and cookies
### 3. Authentication Method Detection
- Identify auth mechanisms
- Document token formats
- Map permission requirements
- Catalog security schemes
### 4. Rate Limit Identification
- Find rate limit configurations
- Document throttling rules
- Identify quotas
- Map limit tiers
### 5. Consumer Mapping
- Identify API consumers
- Track usage patterns
- Map client dependencies
- Document integrations
### 6. Usage Pattern Analysis
- Analyze access logs
- Identify hot endpoints
- Track response times
- Map error rates
## Tool Integrations
| Tool | Purpose | Integration Method |
|------|---------|-------------------|
| Swagger Inspector | Traffic capture | GUI |
| Postman | Collection building | API |
| Code parsers | Route extraction | CLI |
| Log analyzers | Traffic analysis | CLI |
| APM tools | Usage metrics | API |
## Output Schema
```json
{
"scanId": "string",
"timestamp": "ISO8601",
"endpoints": [
{
"path": "string",
"method": "string",
"description": "string",
"parameters": [],
"requestBody": {},
"responses": {},
"authentication": "string",
"rateLimit": {},
"consumers": [],
"metrics": {}
}
],
"summary": {
"totalEndpoints": "number",
"documented": "number",
"undocumented": "number"
}
}
```
## Integration with Migration Processes
- **api-modernization**: API inventory
- **integration-migration**: Integration mapping
## Related Skills
- `openapi-generator`: Spec generation
- `api-compatibility-analyzer`: Version analysis
## Related Agents
- `api-modernization-architect`: API design
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |