← Back to Skills Marketplace
Agent Architecture Designer
by
Nguyễn Ngọc Trí Vĩ
· GitHub ↗
· v1.0.0
· MIT-0
514
Downloads
1
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install agent-architecture-designer
Description
Imported specialist agent skill for architecture designer. Use when requests match this domain or role.
README (SKILL.md)
architecture-designer (Imported Agent Skill)
Overview
|
When to Use
Use this skill when work matches the architecture-designer specialist role.
Imported Agent Spec
- Source file:
/home/nguyenngoctrivi.claude/agents/architecture-designer.md - Original preferred model:
opus - Original tools:
Read, Write, Edit, Bash, Grep, Glob, TodoWrite, WebSearch, WebFetch, Task, mcp__sequential-thinking__sequentialthinking, mcp__context7__resolve-library-id, mcp__context7__get-library-docs
Instructions
Architecture Designer Agent
Identity
WHO: Architecture specialist who proves designs work before recommending them. PRINCIPLE: No recommendation without validation. Untested architecture = technical debt. DIFFERENTIATOR: I build prototypes, run load tests, and measure real metrics.
Skill Invocation
For pattern selection and API design: ~/.claude/skills/architecture-patterns/SKILL.md
Skill provides:
- Application patterns (Monolith, Modular Monolith, Microservices) + decision trees
- API patterns (REST, GraphQL, gRPC) + decision matrix
- Data patterns (Repository, CQRS, Event Sourcing)
- Anti-patterns to avoid
Validation Protocol (Core Value)
Before Recommending ANY Pattern
- Built working prototype?
- Tested integration between components?
- Measured actual performance?
- Would deploy this to production?
Minimum Validation by Type
| Element | Validation |
|---|---|
| API | Create endpoints, test with curl |
| Microservices | Build containers, test communication |
| Database | Create tables, run EXPLAIN ANALYZE |
| Message Queue | Send messages, verify delivery |
| Caching | Implement, measure hit rates |
Workflow
- Requirements Analysis - Use
mcp__sequential-thinking__sequentialthinking - Pattern Selection - Invoke skill for decision framework
- Validation - Load tests, security scans, integration tests
- ADR Creation - Document with validation evidence
ADR Template
# ADR-001: [Title]
## Status: Accepted (After Validation)
## Validation: [prototype, throughput, latency metrics]
## Consequences (VERIFIED): [benefits with test evidence]
Output Requirements
- Working Prototype - Runnable code, Docker manifests
- Validation Report - Load tests, security scans, metrics
- ADR - Decision with validation evidence
- Operational Readiness - Monitoring, alerts, runbooks
Integration
- Upstream: feature-analyst provides requirements
- Downstream: dev-coder implements proven architecture
Red Flags (STOP)
- "Should scale" -> PROVE IT with load tests
- "Will integrate nicely" -> BUILD the integration
- "Based on best practices" -> TEST in THIS context
Agent = WHO (identity + validation) | Skill = HOW (patterns + frameworks)
Usage Guidance
This skill's content expects broad system and network activity (running curl, building containers, reading other skill files under ~/.claude, referencing an absolute home path) but the package declares no required tools or file access. That mismatch means the agent may attempt operations your environment may or may not permit — and it could try to read files from your home if granted. Before installing or enabling: (1) confirm the skill's source/trustworthiness (no homepage, unknown owner), (2) inspect the original referenced source file if available, (3) run it in a restricted/sandboxed agent environment or with tool access disabled, and (4) ensure the agent's runtime enforces least-privilege for tools like Bash, Docker, and network access. If you need this capability, prefer a skill that explicitly declares required binaries, env vars, and config paths and originates from a known publisher.
Capability Analysis
Type: OpenClaw Skill
Name: agent-architecture-designer
Version: 1.0.0
The skill bundle defines a legitimate 'Architecture Designer' persona for an AI agent, focusing on technical validation, prototyping, and performance testing. While it references high-risk tools like Bash and Docker, these are used within the context of its stated purpose (e.g., running load tests and verifying integrations), and there is no evidence of malicious intent, data exfiltration, or prompt injection attacks in SKILL.md.
Capability Assessment
Purpose & Capability
SKILL.md describes an imported specialist agent that expects to build/run prototypes, run curl/load tests, build containers, and use tools like Bash, WebFetch, Grep, etc., but the skill package declares no required binaries, tools, environment variables, or config paths. The exported metadata also points to an absolute source path in a home directory (/home/nguyenngoctrivi.claude/...), which does not align with the declared zero-access footprint.
Instruction Scope
Instructions explicitly instruct actions that would read local files/skill manifests (e.g., ~/.claude/skills/... and the absolute source path) and to run network and system-level operations (curl, build containers, run EXPLAIN ANALYZE). Because this instruction-only skill does not declare required tools or config paths, it creates ambiguity about what the agent will try to access or execute at runtime.
Install Mechanism
No install spec and no code files — the skill is instruction-only which minimizes direct disk writes or bundled binaries. This is the lower-risk installation pattern, but behavior at runtime depends on the agent's tool permissions.
Credentials
The skill requests no environment variables or credentials, which matches a conservative distribution. However, the imported-agent spec inside SKILL.md implies use of external tools and possibly credentials (e.g., for webfetch or container registries) without declaring them; that mismatch is noteworthy.
Persistence & Privilege
always is false and there is no install behavior that writes to system config. The skill does not request persistent privileges in its metadata. Autonomous invocation is allowed (platform default) but not by itself a flag.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install agent-architecture-designer - After installation, invoke the skill by name or use
/agent-architecture-designer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
agent-architecture-designer v1.0.0
- Initial release of the architecture designer specialist agent skill.
- Provides validated architecture pattern selection and decision workflow.
- Enforces prototype-building and load-tested evidence before any recommendation.
- Outputs include working prototypes, validation reports, and ADRs with real metrics.
- Highlights anti-patterns and red flags to avoid unvalidated technical choices.
Metadata
Frequently Asked Questions
What is Agent Architecture Designer?
Imported specialist agent skill for architecture designer. Use when requests match this domain or role. It is an AI Agent Skill for Claude Code / OpenClaw, with 514 downloads so far.
How do I install Agent Architecture Designer?
Run "/install agent-architecture-designer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Agent Architecture Designer free?
Yes, Agent Architecture Designer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Agent Architecture Designer support?
Agent Architecture Designer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Agent Architecture Designer?
It is built and maintained by Nguyễn Ngọc Trí Vĩ (@nntrivi2001); the current version is v1.0.0.
More Skills