- Home
- Skills
- Agents & Orchestration
- Codebase Map
More screenshots
Works with the AI Agents you already use
Codebase Map
An agent skill that turns a repository into an interactive factory-floor map: services as factories, calls as belts, events as drones, etc.
Free
Codebase Map
Example session with this skill installed
Scan the current repository and map the interactions between the 'orders' and 'shipping' services, including the Kafka topics used for communication. Output to docs/viz-code.
- Read your context and instructions
- Compiled the codebase map
- Generated the document
I have completed the architectural scan of the repository at the current HEAD. The process identified two primary services and their message-based communication patterns.
Codebase Map: Orders & Shipping
The extraction identified svc:orders (Python/FastAPI) and svc:shipping (Go), connected via the order-placed Kafka topic.
| Detail | Value |
|---|---|
| Commit Scanned | a1b2c3d4e5f6g7h8i9j0 |
| Services | 2 (svc:orders, svc:shipping) |
| Modules | 4 (pkg/orders, pkg/shipping, lib/shared, api/proto) |
| Relations | 12 (1 event, 8 calls, 3 db-write) |
| Audit Status | clean (12 floors checked) |
| Viewer Path | docs/viz-code/index.html |
Service Interaction Analysis
- Confirmed Event:
svc:orderspublishes totopic:kafka:order-placedviaOrderService.submit. - Confirmed Consumer:
svc:shippingsubscribes totopic:kafka:order-placedinshipping_worker.go. - Infrastructure: Inferred
db:postgres:orders_dbanddb:mongodb:shipping_logsfrom environment variables.
Problems & Findings
ext.missing:SHIPMENT_API_KEYfound in.envbut target endpoint is not configured instack.yaml.example.missing:POST /v1/ordershandler requires an example payload.
Next steps
- Open
docs/viz-code/index.htmlto inspect the visual graph and trace theorder-placedevent. - Update
docs/viz-code/stack.yamlto define the external shipping provider endpoint. - Commit the
docs/viz-code/code-map.jsonandstack.yamlfiles to persist the map.
Field guide: https://si1verwind17.github.io/codebase-map/
index.html
PDF · document
Example file from a real run - the skill writes it into your workspace.
Connects securely to your tools. The creator never sees your data.
About this skill
Turn a repository into a map you can walk through: its services, the calls between them, events, streams and database reads and writes, drawn as a factory floor of buildings and belts.
Demo - https://si1verwind17.github.io/codebase-map/demo/
Field guide - https://si1verwind17.github.io/codebase-map/
codebase-map is an agent skill. You ask your coding agent to map a repository, it reads the code, and you get an interactive page you can open in any browser.
Usage
In the repository you want mapped, run the skill by name: /codebase-map:visualizing-codebases
More information
Scans committed code only. Cannot read credentials or secrets. Large repos require sub-agent orchestration. Node 18+ needed for drawing-check audits.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
1 use
Times used to date
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 21 days ago
- Free with an Agensi account
Requires
Permissions
Allowed Hosts