generateservicemap

Crawl repositories to generate a machine-readable servicemap.json of components and connections.

1|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/cyrus-is/vibecheck --skill generateservicemap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: generateservicemap
Source: https://github.com/cyrus-is/vibecheck/tree/main/generate-servicemap
Command: npx skills add https://github.com/cyrus-is/vibecheck --skill generateservicemap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manual mapping of large codebases into a current, queryable topology is error-prone and hard to keep up to date. This skill automates a deep crawl to produce a machine-readable servicemap.json that captures services, apps, libraries, infrastructure, data stores, external dependencies, and their interconnections, along with confidence scores.

Core Features & Use Cases

  • Deep phased crawl identifies all components (services, apps, libraries, infrastructure, pipelines, datastores) and outputs a structured servicemap.
  • Output is a JSON map that downstream tools can consume for security reviews, architecture documentation, and policy enforcement.
  • Supports incremental updates and schema-driven validation to keep maps current with minimal manual intervention.

Quick Start

Run the skill against your repository to generate a machine-readable servicemap.json at the default path.

Frequently Asked Questions about generateservicemap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically generate a service map for a large monorepo?

To generate a service map for a monorepo, you can automate a deep crawl of the repository to identify services, apps, libraries, and data stores, outputting a structured servicemap.json file. This captures the complete topology and their interconnections.

What is the best way to keep architecture documentation updated as a codebase evolves?

The best way to keep architecture documentation updated is using incremental updates with schema-driven validation. This approach modifies the existing servicemap.json with minimal manual intervention, ensuring the machine-readable topology stays current with codebase changes.

How does dependency tracing work for mapping infrastructure and CI/CD pipelines?

Dependency tracing for mapping infrastructure works by performing a deep phased crawl across the repository. It identifies components like CI/CD pipelines and data stores, then extracts metadata and traces connections to assemble a structured map with confidence scores.

Can I use a generated service map for security audits and policy enforcement?

Yes, you can use a generated service map for security audits and policy enforcement. The output is a machine-readable JSON map that downstream tools can consume to analyze external dependencies and enforce architectural policies.

Does generating a machine-readable service map require manual topology mapping?

Generating a machine-readable service map does not require manual topology mapping. The skill automates the deep crawl process to produce a servicemap.json, eliminating the error-prone manual effort of tracking services, infrastructure, and data stores.

What limitations exist when mapping external dependencies in an evolving codebase?

A limitation when mapping external dependencies in an evolving codebase is potential topology drift between updates. Relying on incremental updates and schema validation mitigates this, but mapping accuracy depends on the confidence scores assigned during the deep crawl phases.