Agent skill

Solution Architect

by staruhub in staruhub/ClaudeSkills

解决方案架构师助手。当用户要设计新系统架构、评审现有架构、做技术选型决策、诊断性能/可扩展性/可用性问题、规划架构演进或重构时使用。覆盖微服务、事件驱动、云原生等架构模式,技术趋势通过实时搜索获取而非依赖内置知识。不用于:具体功能的代码实现、安全漏洞审计(用security-audit)、产品需求分析(用product-manager)、只需一句话回答的技术常识问题。

MITAuto-check passedSecurity

Install Solution Architect

skills CLI
$ npx skills add staruhub/ClaudeSkills --skill solution-architect -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install staruhub/ClaudeSkills solution-architect --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/staruhub/ClaudeSkills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/Geek-skills-solution-architect .claude/skills/solution-architect && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
solution-architect
GitHub stars
727
Token cost
~670 tokens
SKILL.md length
148 words
Files
7 (incl. references)
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

解决方案架构师助手。当用户要设计新系统架构、评审现有架构、做技术选型决策、诊断性能/可扩展性/可用性问题、规划架构演进或重构时使用。覆盖微服务、事件驱动、云原生等架构模式,技术趋势通过实时搜索获取而非依赖内置知识。不用于:具体功能的代码实现、安全漏洞审计(用security-audit)、产品需求分析(用product-manager)、只需一句话回答的技术常识问题。

  • Works in 4 steps: 业务需求: 要解决什么问题?支持什么业务场景? → 非功能需求: 性能、可用性、安全性、可扩展性要求 → 约束条件: 预算、时间、团队技能、技术栈限制 → …
  • Tasks that involve Security review
  • SKILL.md covers 验收标准(交付前逐条自查), 不做什么, 工作流程 and 时效性规则, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Solution Architect is an agent skill from staruhub/ClaudeSkills. 解决方案架构师助手。当用户要设计新系统架构、评审现有架构、做技术选型决策、诊断性能/可扩展性/可用性问题、规划架构演进或重构时使用。覆盖微服务、事件驱动、云原生等架构模式,技术趋势通过实时搜索获取而非依赖内置知识。不用于:具体功能的代码实现、安全漏洞审计(用security-audit)、产品需求分析(用product-manager)、只需一句话回答的技术常识问题。

Its SKILL.md is about 670 tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `evals/routing-evals.json`, `references/场景与输出模板.md` and `references/技术选型指南.md`).

It sits in Security, covering Security review. The repository describes itself as: 13 curated Agent Skills for research, product decisions, decks, publishing, audits, and more — portable across skills-compatible agents. The licence is MIT.

When your agent uses it

  • Tasks that involve Security review

Example prompts

  • “/solution-architect”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. 业务需求: 要解决什么问题?支持什么业务场景?
  2. 非功能需求: 性能、可用性、安全性、可扩展性要求
  3. 约束条件: 预算、时间、团队技能、技术栈限制
  4. 目标指标: SLA要求、用户规模、数据量

What it can do on your machine

Read from SKILL.md and the folder at commit 66e02d2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Solution Architect loads about 670 tokens when it runs, and up to ~12k if it reads all its reference files. Until then it costs about 51 tokens; SKILL.md has 148 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~51
When it runs · the whole SKILL.md, loaded when a task matches
~670
With references · SKILL.md plus every file in references/, read only if the agent opens them
~12k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from staruhub/ClaudeSkills at commit 66e02d2, republished under its MIT licence (© staruhub). 148 words, ~670 tokens.

Download SKILL.mdSave it as .claude/skills/solution-architect/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
solution-architect
description
解决方案架构师助手。当用户要设计新系统架构、评审现有架构、做技术选型决策、诊断性能/可扩展性/可用性问题、规划架构演进或重构时使用。覆盖微服务、事件驱动、云原生等架构模式,技术趋势通过实时搜索获取而非依赖内置知识。不用于:具体功能的代码实现、安全漏洞审计(用security-audit)、产品需求分析(用product-manager)、只需一句话回答的技术常识问题。
version
1.1.0

解决方案架构师

帮助设计高质量的软件系统架构,做出明智的技术选型决策,提供架构评审和优化建议。

验收标准(交付前逐条自查)

  • 需求先行:输出前已确认业务需求、非功能需求(性能/可用性/安全/扩展性指标)和约束条件(预算/团队/技术栈)
  • 每个关键技术选择都有明确理由和被否掉的替代方案
  • 权衡透明:说清方案的代价和风险,没有"银弹"式推荐
  • 涉及"最新/流行/趋势"的论断有本次搜索的依据,不是训练数据里的旧闻
  • 建议与团队能力匹配(不给 5 人小团队推 30 个微服务)
  • 重要决策以 ADR 形式可记录,给出下一步行动(POC/预研/评审项)

不做什么

  • 不写业务功能代码——架构建议落到实现层时移交给编码任务
  • 不做安全漏洞扫描与渗透评估——用 security-audit skill
  • 不替用户做最终决策——给评估矩阵和推荐,决策权在团队
  • 用户只问一个技术常识("Kafka 是什么")时,直接回答,不启动完整流程

工作流程

第一步:明确需求和目标
  1. 业务需求: 要解决什么问题?支持什么业务场景?
  2. 非功能需求: 性能、可用性、安全性、可扩展性要求
  3. 约束条件: 预算、时间、团队技能、技术栈限制
  4. 目标指标: SLA要求、用户规模、数据量

信息不全时先问,不要在假设上盖楼。

第二步:按任务类型路由
任务类型关键动作主要参考
架构设计分析需求约束 → 选架构模式 → 设计组件交互 → 技术选型 → 风险权衡 → 输出架构文档+ADRreferences/架构模式.md
技术选型列候选 → 多维评估矩阵(功能/性能/成本/生态/团队) → POC 验证点 → 推荐+理由references/技术选型指南.md
架构评审按清单逐维度评审(功能/质量属性/设计/选型/运维/成本/风险) → 分级问题+改进建议+行动项references/架构评审清单.md
架构优化定位瓶颈 → 搜索同类问题解法 → 短期/中期/长期分层方案references/架构设计原则.md
趋势咨询以实时搜索为准,参考文档的趋势章节仅作背景见下方时效性规则

各任务的交付文档结构和典型场景示例见 references/场景与输出模板.md。

第三步:搜索验证

关键决策点必须用实时搜索校准:

web_search: [类似系统] 架构设计最佳实践
web_search: [技术A] vs [技术B] [当前年份] comparison
web_search: [技术] production lessons learned
web_fetch: [官方文档/权威技术博客 URL]

时效性规则

本 skill 和 references 中的"趋势"内容有记录时点,会过时。 凡回答"当前趋势/最新实践/哪个更流行"类问题:先搜索当年信息,references 里的趋势章节只作为分析框架,不作为事实来源。

核心原则:架构设计的"黄金法则"

  1. 简单优于复杂 - KISS原则,避免过度设计
  2. 演进优于完美 - 渐进式设计,持续改进
  3. 权衡无处不在 - 没有完美方案,只有最合适的
  4. 质量属性优先 - 明确性能、可用性等非功能需求
  5. 团队能力匹配 - 选择团队能驾驭的技术
  6. 记录决策 - 使用ADR记录重要决策
  7. 持续验证 - 通过POC和实践验证假设

已知陷阱

陷阱具体表现应对
过度设计小规模业务上来就分布式全家桶从模块化单体起步,量化触发条件后再拆
盲目跟风因为"新"而选技术,不考虑适用性每个选型必须回答"解决我们的什么问题"
忽视团队推荐团队无人掌握的技术栈选型矩阵中团队熟悉度是硬权重
缺少文档只有架构图没有决策记录关键决策写 ADR,图和文字配套
忽视运维设计时不考虑部署、监控、排障可观测性和部署架构是设计的一部分,不是事后补
一步到位期望第一版就是终态架构给演进路径:现在做什么、什么信号触发下一步
趋势旧闻把训练数据里的"趋势"当成当前状态见时效性规则,先搜再说

参考文档(按需加载)

文件何时读
references/架构设计原则.md首次使用必读;核心原则、质量属性、架构决策框架
references/架构模式.md架构设计任务时读;分层/微服务/事件驱动等模式详解
references/技术选型指南.md技术选型任务时读;评估方法论与矩阵模板
references/架构评审清单.md架构评审任务时读;逐项评审标准
references/场景与输出模板.md组织交付文档时读;四类场景示例+三套输出模板

evals/routing-evals.json — 触发边界回归用例,改 description 后用仓库根 scripts/run_routing_evals.py 校验。

© staruhub, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (references) in skills/Geek-skills-solution-architect of staruhub/ClaudeSkills.

  • SKILL.md
  • evals/routing-evals.json
  • references/场景与输出模板.md
  • references/技术选型指南.md
  • references/架构模式.md
  • references/架构设计原则.md
  • references/架构评审清单.md

Open the folder on GitHubat commit 66e02d2

Compare with similar skills

Solution Architect next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Solution Architect compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Solution Architect this skillstaruhub/ClaudeSkills727—~670Automated safety check: PassMIT
Deepsec Documentation Guidevercel-labs/deepsec8.1k—~956Automated safety check: PassApache-2.0
Kubernetes Network Security Auditkubeshark/kubeshark12k—~7.3kAutomated safety check: NotesApache-2.0
Agentlas Security Scanagentlas-ai/Agentlas-OS1.6k1 repos~822Automated safety check: PassApache-2.0
Native Dependency Updatemono/SkiaSharp5.6k—~4.1kAutomated safety check: PassMIT
Semgrep Security Scantrailofbits/skills7.4k—~3.7kAutomated safety check: NotesCC-BY-SA-4.0

Similar skills

  • Deepsec Documentation Guide

    vercel-labs/deepsec

    Official

    Points the agent at deepsec's own docs to answer questions about initializing, configuring, resuming, scanning with and extending the vulnerability scanner.

    8.1k GitHub stars~956 tokensUpdated 8 days ago
    SecurityAuto-check passed
  • Hunts for compromised workloads and malicious traffic in a Kubernetes cluster by sweeping network data through Kubeshark MCP, mapped to MITRE ATT&CK.

    12k GitHub stars~7.3k tokensUpdated today
    SecurityAuto-check: notes
  • Agentlas Security Scan

    agentlas-ai/Agentlas-OS

    A skill your agent uses when an agent folder must pass the Agentlas Cloud 2-stage security scan (static rules + BYOK LLM judgment) before private sync or public publish, or when asked to…

    1.6k GitHub starsUsed in 1 repo~822 tokens
    SecurityAuto-check passed
  • Update native dependencies (libpng, libexpat, zlib, libwebp, harfbuzz, freetype, libjpeg-turbo, etc.) in SkiaSharp's Skia fork.

    5.6k GitHub stars~4.1k tokensUpdated today
    SecurityAuto-check passed
  • Semgrep Security Scan

    trailofbits/skills

    Official

    Detects languages, proposes rulesets for approval, then runs the approved Semgrep scan across a codebase and merges the output into one SARIF file.

    7.4k GitHub stars~3.7k tokensUpdated today
    SecurityAuto-check: notes
  • Skillward Audit

    Fangcun-AI/SkillWard

    Security-audit a third-party skill bundle (folder with SKILL.md, or .zip / .tar.gz archive) before installing it, using the SkillWard cloud scanner.

    143 GitHub stars~2.9k tokensUpdated 2 mo ago
    SecurityAuto-check passed

More from staruhub/ClaudeSkills

All 20 skills in this repo
  • Deep Research

    staruhub/ClaudeSkills

    A skill your agent uses when the user wants an evidence-based research memo, literature review, market/policy/technical landscape, or a multi-source decision brief with citations, trade-offs, and a…

    727 GitHub stars~2.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Podcast Generator

    staruhub/ClaudeSkills

    用火山引擎 Podcast AI 模型生成中文双人对话播客。当用户要把文章、报告、话题文本转成播客音频、生成对话式音频内容时使用,需要环境具备火山引擎 APPID 和 ACCESSKEY。支持 mp3/oggopus/pcm/aac、语速调节、自定义音色、断点续传。不用于:单人朗读式 TTS(用普通语音合成)、英文播客(模型主要优化中文)、播客文稿本身的撰写(先用写作类 skill…

    727 GitHub starsUsed in 1 repo~475 tokens
    Auto-check passed
  • Wechat Article Writer

    staruhub/ClaudeSkills

    专业微信公众号文章助手,支持四个独立且可组合模式:article 写正文;image-prompts 从文章生成版本化、provider-neutral 的图片提示词 manifest 与稳定占位符,但不调用生图;layout 把文章和 manifest 确定性转换为微信安全的内联 HTML;full-pipeline…

    727 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • A Share Analyst

    staruhub/ClaudeSkills

    A股分析研究助手,提供行情数据获取与技术面/基本面分析框架(仅供研究参考,不构成投资建议)。适用于:(1) 获取A股行情和历史数据,(2) 技术面分析(K线形态、MACD、KDJ、RSI、布林带等),(3) 基本面分析(财务指标、估值分析),(4) 板块热点追踪,(5) 选股策略筛选与量化因子分析,(6)…

    727 GitHub stars~871 tokensUpdated 1 mo ago
    Auto-check passed
  • C Drive Cleaner

    staruhub/ClaudeSkills

    Windows C盘清理和磁盘空间管理。当用户说C盘满了、磁盘空间不足、清理临时文件/缓存/回收站/系统日志、查找大文件、分析磁盘占用时使用。仅适用于 Windows 环境。不用于:macOS/Linux 磁盘清理、卸载软件(引导用户走系统卸载)、清理用户个人文件(只报告位置,删除决定权在用户)。

    727 GitHub stars~518 tokensUpdated 1 mo ago
    Auto-check passed
  • Gaokao Expert

    staruhub/ClaudeSkills

    资深高考命题专家助手,提供专业的命题指导和评审服务。适用于创作高考试题、评审试题质量、分析试卷结构、了解命题趋势等场景。结合文档工具提取解压文件,使用网络搜索了解当年最新命题趋势,使用分析工具评估题目质量和试卷结构。涵盖"一核四层四翼"评价体系、题型规范、评分标准、命题流程等多个维度。不用于:大学/考研/中考命题(体系不同,仅可借鉴)、日常作业题编写、直接替考生解题。

    727 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Solution Architect

What does Solution Architect do?

解决方案架构师助手。当用户要设计新系统架构、评审现有架构、做技术选型决策、诊断性能/可扩展性/可用性问题、规划架构演进或重构时使用。覆盖微服务、事件驱动、云原生等架构模式,技术趋势通过实时搜索获取而非依赖内置知识。不用于:具体功能的代码实现、安全漏洞审计(用security-audit)、产品需求分析(用product-manager)、只需一句话回答的技术常识问题。. Solution Architect is an agent skill from staruhub/ClaudeSkills.

When should I use Solution Architect?

Solution Architect fits situations like: tasks that involve Security review.

How do I install Solution Architect in Claude Code?

Run `npx skills add staruhub/ClaudeSkills --skill solution-architect -a claude-code`. Or copy the skill folder (skills/Geek-skills-solution-architect in staruhub/ClaudeSkills) into .claude/skills/solution-architect in your project. Claude Code loads it when a task matches its description.

How do I install Solution Architect in Codex?

Run `npx skills add staruhub/ClaudeSkills --skill solution-architect -a codex`. Or copy the skill folder (skills/Geek-skills-solution-architect in staruhub/ClaudeSkills) into .agents/skills/solution-architect in your project. Codex loads it when a task matches its description.

Can I use Solution Architect in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add staruhub/ClaudeSkills --skill solution-architect -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/solution-architect, .gemini/skills/solution-architect, .github/skills/solution-architect and .opencode/skills/solution-architect in your project.

What does Solution Architect need to run?

SKILL.md names no scripts, command-line tools or credentials: Solution Architect is instructions for the agent only.

Does Solution Architect access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Solution Architect safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Solution Architect use?

Solution Architect is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Solution Architect use?

About 670 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 11k tokens, read only when the agent opens those files.

What are the alternatives to Solution Architect?

Skills that share tags, products or a category with Solution Architect: Deepsec Documentation Guide (vercel-labs/deepsec, 8.1k stars), Kubernetes Network Security Audit (kubeshark/kubeshark, 12k stars), Agentlas Security Scan (agentlas-ai/Agentlas-OS, 1.6k stars) and Native Dependency Update (mono/SkiaSharp, 5.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Solution Architect?

staruhub (a GitHub user) maintains it in staruhub/ClaudeSkills, which has 727 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on August 13, 2026.

Source: staruhub/ClaudeSkills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.