← Back to Skills Marketplace
Source To Architecture
by
vincentlau2046-sudo
· GitHub ↗
· v1.0.0
· MIT-0
96
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install source-to-architecture
Description
实现从源码解析到五层架构的全链路可视化,支持版本控制、自动同步和多格式架构图生成。
Usage Guidance
This skill largely does what it says (analyze code and generate DrawIO diagrams), but there are mismatches between its claims and the delivered code. Before installing or running:
- Review the install script (scripts/install-tools.sh). It performs global npm installs and uses apt/yum/brew (may call sudo). Prefer running these steps inside a disposable container/VM rather than on your workstation. The Dockerfile provided is a safer option.
- Don’t run the analyzer against sensitive or production repositories until you inspect the code—the analyzer reads all files under the given project path and there is no exclusion configuration shown.
- The README/SKILL.md promise automated features (weekly sync, PR/commit integration, sensitive-change alerts). These features are not present in the shipped scripts; treat them as planned features rather than working automation.
- Validate the external packages (drawio-desktop from npm, ripgrep .deb URL) and consider installing them via your distribution’s package manager where possible to reduce supply-chain risk.
- Run the tool first in an isolated environment (container) and test on a non-sensitive sample project. If you need the promised automation (hooks/scheduling/alerts), request the author for the specific implementations or source for the CI/git hooks before trusting auto-sync behavior.
If you want higher confidence, provide the full, untruncated drawio-generator.py (the copy in the package appears truncated/buggy) and confirm whether any post-install scripts or network calls are made by npm packages used.
Capability Analysis
Type: OpenClaw Skill
Name: source-to-architecture
Version: 1.0.0
The skill bundle is designed to automate the generation of architecture diagrams from source code. It includes scripts for environment setup (install-tools.sh), source code analysis (source-analyzer.py), and DrawIO diagram generation (drawio-generator.py). The behavior is consistent with the stated purpose, using standard system utilities like ripgrep and tree to map code structures to a five-layer architecture. No evidence of data exfiltration, unauthorized remote execution, or malicious prompt injection was found.
Capability Assessment
Purpose & Capability
The name/description (source → five-layer architectures, diagram generation, versioning) align with the provided scripts (source-analyzer.py and drawio-generator.py) and README. However SKILL.md and README claim additional automated capabilities (weekly auto-sync, PR/commit integration, sensitive-module alerting, CI hooks) that are not implemented in the shipped scripts. The code reasonably needs ripgrep/tree/drawio/etc — so requested tools are generally proportionate to the stated goal.
Instruction Scope
Runtime instructions require scanning an entire project directory (expected) and saving analysis artifacts. Concern: SKILL.md promises automatic weekly sync, PR integration, and sensitive-module change alerts, but there is no code or configuration in the package implementing scheduled jobs, Git hooks, or alerting. The install script (install-tools.sh) instructs system-wide installs (npm -g drawio-desktop, apt/yum/brew, sudo) which elevates scope to system package management and requires user privilege. The analyzer reads project files (expected) but there is no explicit handling of secrets or exclusion lists — user should avoid running against sensitive repos without inspection.
Install Mechanism
There is no platform install spec in the registry, but the repository includes an install script and a generated Dockerfile. install-tools.sh performs package installs via package managers and npm -g; Dockerfile downloads a ripgrep .deb from a GitHub release (a known host). These are reasonable for this use case but carry the usual supply-chain risks (global npm installs, postinstall scripts, running apt installs with sudo). No obscure shortened URLs were used.
Credentials
The skill declares no required environment variables, no credentials, and no config paths. The scripts operate on local filesystem input (project path) only, which is proportionate to the stated purpose.
Persistence & Privilege
Skill is not always-enabled and does not request elevated persistent privileges in the skill metadata. The included install script may require sudo when run by the user, but the skill itself does not declare persistent system modifications or cross-skill configuration changes.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install source-to-architecture - After installation, invoke the skill by name or use
/source-to-architecture - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release – provides full-lifecycle, versionable code-to-architecture visualization using an optimized five-layer DrawIO template.
- Supports module-to-architecture mapping from source code, through module relations, to deployment.
- Enforces strict five-layered architecture (access, routing/control, logic, data access, storage/external) with standardized layout, colors, and shapes.
- Integrates automated source code scanning, diagram generation, and Git workflow (including change reports and consistency checks).
- Outputs architecture diagrams and analysis lists in multiple formats (DrawIO, PNG, SVG, PDF).
- Provides CI/CD integration, toolchain requirements, and clear sample usage commands.
Metadata
Frequently Asked Questions
What is Source To Architecture?
实现从源码解析到五层架构的全链路可视化,支持版本控制、自动同步和多格式架构图生成。 It is an AI Agent Skill for Claude Code / OpenClaw, with 96 downloads so far.
How do I install Source To Architecture?
Run "/install source-to-architecture" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Source To Architecture free?
Yes, Source To Architecture is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Source To Architecture support?
Source To Architecture is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Source To Architecture?
It is built and maintained by vincentlau2046-sudo (@vincentlau2046-sudo); the current version is v1.0.0.
More Skills