skills.rest
jysh1214
jysh1214COMMUNITY
Explore all skills by this author →
GitHub

inf

Generate hierarchical YAML diagrams of code repositories with Graphviz layout.

Updated Jan 14, 2026
Search Tags:#architecture#documentation#codebase#yaml#diagrams#graphviz#visualize
One-click install
npx skills add https://github.com/jysh1214/inf --skill inf
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: inf
Source: https://github.com/jysh1214/inf/tree/main
Command: npx skills add https://github.com/jysh1214/inf --skill inf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, pygraphviz, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of understanding and documenting complex code repositories by automatically generating hierarchical visual notes. It helps users quickly grasp system architecture, data flows, and module dependencies, making onboarding and knowledge transfer significantly easier.

Core Features & Use Cases

  • Hierarchical Diagram Generation: Creates multi-level Inf diagrams as YAML files, representing the codebase structure from a high-level overview to deep, nested subgraphs.
  • Incremental Expansion: Supports iterative documentation, allowing users to expand diagrams one level at a time, either breadth-first across the entire repository or focused on specific modules.
  • AI-Friendly YAML Format: Utilizes a structured YAML format where AI specifies diagram elements (nodes, connections, groups) and a Python script handles automatic layout and positioning using Graphviz.
  • Use Case: A software architect needs to document a microservices architecture. They can use this skill to generate a root diagram showing all services, then iteratively expand each service into its own subgraph detailing components, APIs, and data stores, creating a comprehensive, navigable visual guide.

Quick Start

To begin, generate the initial root diagram and its first level of subgraphs for the current repository.

Frequently Asked Questions about inf

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

FAQPage Schema
How do I generate hierarchical diagrams for a complex codebase?▼

To generate hierarchical diagrams for a codebase, you define diagram elements like nodes and groups in a YAML format, then a Python script uses Graphviz to automatically compute the layout and output visual architecture documentation.

What is the best way to visualize microservices architecture for onboarding?▼

Visualizing microservices architecture for onboarding is best handled by creating multi-level diagrams that show high-level overviews and iteratively expanding specific modules into nested subgraphs detailing components and data stores.

Can I use YAML to author codebase documentation for automatic layout computation?▼

Yes, you can use an AI-friendly YAML format to author codebase documentation where you specify diagram elements, and Graphviz handles the automatic layout and positioning to render the visual output.

Does this hierarchical diagram generation approach support incremental expansion?▼

Yes, hierarchical diagram generation supports incremental expansion, allowing you to iteratively expand diagrams one level at a time either breadth-first across the entire repository or focused on specific modules.

Do I need pygraphviz and pyyaml installed to generate codebase architecture diagrams?▼

Yes, you need pyyaml and pygraphviz installed, as the process relies on YAML files for defining diagram elements and Graphviz for computing the automatic layout of the codebase architecture visualizations.

Related Skills

Explore More Software Engineering Skills→
kngender5kngender5

excalidraw

Create architecture, flowchart, and sequence diagrams from Excalidraw JSON elements.

Community
Basic
scottconversescottconverse
1

doc-writer

Generate README, Markdown, HTML, and PDF documentation from source code.

Community
Advanced
sunLeeesunLeee

doc-sys

Generate system architecture documentation with Mermaid diagrams from a codebase.

Community
Advanced
trehansaliltrehansalil

pathfinder

Map codebase features into flowcharts and propose a unified architecture.

Community
Advanced