Skip to content

a5c-ai/babysitter / library/specializations/code-migration-modernization/skills/api-inventory-scanner

api-inventory-scanner

Verified

Discover and document existing API endpoints from code, logs, and traffic analysis

FileKindSize
README.mdmarkdown1.4 KB
SKILL.mdskill md2.7 KB
# API Inventory Scanner Skill

## Overview

The API Inventory Scanner skill discovers and documents API endpoints. It extracts endpoint information from code, logs, and traffic to create comprehensive API inventories.

## Quick Start

### Prerequisites

- Access to codebase
- Optional: API logs/traffic
- Framework knowledge

### Basic Usage

1. **Scan code**
   - Parse route definitions
   - Extract controllers
   - Find annotations

2. **Analyze traffic**
   - Review access logs
   - Capture live traffic
   - Identify patterns

3. **Document APIs**
   - Create endpoint inventory
   - Document schemas
   - Map consumers

## Features

### Discovery Methods

| Method | Source | Coverage |
|--------|--------|----------|
| Code parsing | Source code | High |
| Traffic analysis | Logs | Real usage |
| Framework introspection | Runtime | Complete |
| Manual capture | Postman | Targeted |

### Output Formats

- OpenAPI 3.0 specification
- JSON inventory
- Markdown documentation
- Postman collection

## Configuration

```json
{
  "discovery": {
    "codeAnalysis": true,
    "logAnalysis": true,
    "trafficCapture": false
  },
  "sources": {
    "codePaths": ["./src/routes", "./src/controllers"],
    "logFiles": ["./logs/access.log"],
    "framework": "express"
  },
  "output": {
    "format": "openapi",
    "path": "./api-inventory.yaml"
  }
}
```

## Related Documentation

- [SKILL.md](./SKILL.md) - Full skill specification
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 implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall