Route Scanning

huangjia2019/claude-code-engineering

Automatically crawls your Express.js codebase and builds a complete inventory of every API endpoint with methods, paths, file locations, and line numbers. Runs a Python scanner script and enriches the output with middleware detection and route type classification. Useful when you inherit a sprawling API, need to audit what endpoints exist before a refactor, or want to feed route data into documentation generators. The JSON manifest output is designed to pipe directly into other tools, which is smart. Won't catch dynamically constructed routes, but handles the standard router patterns that cover most real world Express apps.

GitHub stars: 826
last updated: May 30, 2026

View on GitHub

Install

$ npx -y skills add huangjia2019/claude-code-engineering --skill route-scanning --agent claude-code

Installs into .claude/skills of the current project.

Files

Route Scanning Skill

Discover all API route definitions in Express.js source files.

Process

Step 1: Run Route Scanner

Execute the scanning script:

python3 scripts/scan-routes.py <source_directory>

The script outputs a structured route list with method, path, file, and line number.

Step 2: Enrich Route Data

For each discovered route, also identify:

Middleware applied (auth, validation, etc.)
Whether it's a standard route or chained route (router.route())

Output Format

Return a JSON-compatible route manifest:

[
  {
    "method": "GET",
    "path": "/api/products",
    "file": "src/routes/products.js",
    "line": 8,
    "middleware": ["requireAuth"],
    "type": "standard"
  }
]

This manifest will be consumed by the next pipeline stage (doc-writing).

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly