An expert AI architect skill designed for evidence-based codebase analysis, complex bug root-cause diagnosis, and technical trade-off evaluations.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tvs-architect
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tvs-architect using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is tvs-architect?
The tvs-architect skill is a robust tool within Openclaw Skills designed to turn AI agents into sophisticated architecture and debugging consultants. Rather than relying on generic, abstract suggestions or theoretical assumptions, this skill enforces a strict code-first philosophy. It requires the agent to systematically analyze existing repositories, configuration files, project dependencies, and execution logs before rendering judgment or suggesting architectural modifications.
By leveraging this skill, developers gain an analytical partner that ensures every design recommendation, root-cause diagnosis, and technical trade-off is tied directly to concrete code evidence. It excels at maintaining long-term software maintainability while preventing premature refactoring or scope creep.
tvs-architect Use Cases
- Conducting structured architectural reviews and design pattern evaluations on existing repositories.
- Diagnosing the absolute root causes of complex, deep-seated bugs rather than just patching surface symptoms.
- Performing comparative trade-off analyses among multiple technical solutions or implementations.
- Providing prioritized, high-impact maintenance recommendations with clear cost-benefit metrics.
- Formulating targeted refactoring plans backed explicitly by codebase evidence and path-specific proof.
How tvs-architect Works
- Context Gathering: The skill initiates by exploring the project blueprint, identifying core directory structures, and inspecting relevant files, configurations, and dependencies.
- Evidence Synthesis: For bug tracking, it cross-references log outputs, stack traces, and recent git diffs against expected runtime paths to create an analytical hypothesis.
- Cross-Validation: It validates assumptions explicitly by tracing real codebase paths, matching code blocks, and gathering concrete evidence.
- Structured Compilation: The skill processes findings into an actionable report consisting of a summary, detailed analysis, root causes, prioritized actionable advice, and explicit file-path proofs.
- Gap Identification: If the code evidence is insufficient to confidently pinpoint a solution, the skill clearly details the ambiguities and explicitly prompts for the missing data.
tvs-architect Setup
To install and enable this skill within your Openclaw environment, run the following setup commands:
openclaw skill install tvs-architect
openclaw skill enable tvs-architect
tvs-architect Data Schema & Taxonomy
The tvs-architect skill enforces a structured data output when dealing with complex problems. It generates architectural insights adhering to the following metadata schema:
| Section | Description | Target Content |
|---|---|---|
| Summary | High-level synthesis | 2-3 sentences outlining the core discovery and primary recommended direction. |
| Analysis | Deep-dive code evaluation | Key structural and pattern discoveries based entirely on existing files. |
| Root Cause | Definitive issue source | Explanation of the systemic source of the error, moving past shallow symptoms. |
| Recommendations | Prioritized action steps | Ordered list formatted with priority tiers, estimated effort, and expected impact. |
| Trade-offs | Solution comparison | Pros, cons, and appropriate scenarios for alternate viable pathways. |
| Evidence | Code-backed verification | Concrete file paths (path/to/file.ts) paired with explanations of what they prove. |
Note: Simple queries bypass this schema for rapid, direct text responses.
tvs-architect Advanced Features
- Strict evidence-gating that forbids the agent from providing architectural advice without reading underlying code first.
- Proportional intervention barriers that block unnecessary or expansive refactoring recommendations unless justified by severe root causes.
- Clear data-insufficiency hooks that explicitly stop execution and request specific user inputs when verification assets are missing.
- Multivariable trade-off matrix generation comparing implementation velocity, performance cost, and maintenance impact across solutions.
SKILL.md
Loading
Related Openclaw Skills
tvs-deep-interview
An expert requirement analysis skill that guides users through a structured Socratic interview to turn ambiguous ideas into precise, ready-to-execute system specifications.
AIDSO Xiasou GEO Content Generator
An AI-powered Generative Engine Optimization (GEO) tool designed to optimize brand visibility and responses across major conversational AI platforms and search engines.
tvs-verify
A rigorous verification skill that translates user requests into concrete acceptance criteria to prove AI-generated changes actually resolved the root issue.
ClawSec Monitor
A local transparent proxy to intercept, audit, and secure outbound and inbound network traffic from your autonomous AI agents.
SFSymbolsKit
A high-fidelity grounding skill that prevents AI models from hallucinating Apple SF Symbol names, ensuring type-safe compilation for iOS, iPadOS, and macOS apps.
Medical Literature Search - PubMed
A powerful AI search skill that retrieves and synthesizes medical literature, clinical trials, and drug efficacy studies directly from NCBI PubMed.
Featured*
