agentsclimarketplace

Architecture map builder

Skill sisodiabhumca/agent-skills/skills/architecture-map-builder

Production-Ready Agent Skills : product analytics, growth experiments, CRM, research synthesis, postmortems, data contracts, SaaS spend, compliance, architecture maps, and LLM eval and many more.

Install
npx -y skills add sisodiabhumca/agent-skills --skill architecture-map-builder

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use to build a service / component map from a GitHub or GitLab monorepo or set of repos. Detects services, languages, internal dependencies (HTTP/SDK/import), and emits a Mermaid diagram + a service catalog YAML.

SKILL.md

1.6 KB, as published. Nobody here has run it

Architecture Map Builder

When to invoke

  • "Map our microservices architecture from the GitHub org."
  • "Generate a service catalog from these repos."
  • "Show internal dependencies between services."

Inputs needed

  1. Path — local path to a monorepo or directory of cloned repos.
  2. Org / repo list (optional) — for GitHub mode.
  3. Heuristics — patterns that identify a service (Dockerfile, package.json, pyproject.toml, etc).

Workflow

  1. Discover services — walk for service markers (Dockerfile / k8s manifest / package manifest).
  2. Classify language and framework.
  3. Detect dependencies — scan source for known service hostnames, package imports, OpenAPI clients.
  4. Emit:
    • services.yml — catalog with name, path, language, owners, deps.
    • architecture.mmd — Mermaid graph of services + dependencies.
    • Markdown summary with risks (orphan services, cyclic deps, missing owners).

Output format

  • architecture.mmd (Mermaid)
  • services.yml (catalog)
  • report.md (summary + risks)

Guardrails

  • Never claim a dep without a literal source reference.
  • Flag services without owners (CODEOWNERS or OWNERS file) as risk.
  • Detect cycles and report; do not silently render them.

Reference code

map.py walks a path, detects services, infers deps, and writes outputs.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.