# solutions-architect

This skill helps gather technical requirements, shape integration designs, assess security, and plan proof-of-concept work. Use it when a project needs a structured architecture document.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 365 installs · ★ 980
- Author: borghei
- License: LicenseRef-MIT-Commons-Clause · policy=link-only · description only; the file stays with the author
- Source: https://github.com/borghei/Claude-Skills/tree/HEAD/sales-success/solutions-architect/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/solutions-architect

## What it does

The skill guides work from documenting existing systems and requirements to outlining a proposed solution. It can organize component roles, data flows, API details, and security considerations, then define a proof of concept’s boundaries and success measures.

Start by establishing the current environment, key requirements, and deployment model. A late change to where the solution will run can invalidate the design, so settle that early. If asked to produce an answer immediately, the skill puts its assumptions at the top.

For Claude Code, install it with `npx skills add borghei/Claude-Skills --skill solutions-architect -a claude-code`. The skill file is located at `~/.claude/skills/solutions-architect/SKILL.md`. Its materials include a technical discovery template and a suggested structure for architecture documents.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill solutions-architect -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/solutions-architect/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/solutions-architect/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill solutions-architect -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/solutions-architect/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill solutions-architect -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/solutions-architect/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install borghei/Claude-Skills solutions-architect
```

2. **Manually: put the files in place**
- File: `.github/skills/solutions-architect/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill solutions-architect -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/borghei/Claude-Skills --path sales-success/solutions-architect
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/solutions-architect/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill solutions-architect -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/borghei/Claude-Skills/tree/HEAD/sales-success/solutions-architect/SKILL.md

## When to use it
- document existing systems, data, and integration points
- capture functional and non-functional requirements
- map solution components and data flows
- review security concerns and record remediation actions
- set proof-of-concept boundaries and success measures

## Example prompts
- Map our current systems and capture the technical requirements.
- Draft an integration architecture with data flows and security considerations.
- Scope a proof of concept and define how we will measure its results.

## Similar
- [mcp-builder](https://affpapa.org/en/nevibecode/skills/mcp-builder.md) — skill · 130949 installs
- [claude-api](https://affpapa.org/en/nevibecode/skills/claude-api.md) — skill · 74198 installs
- [lark-im](https://affpapa.org/en/nevibecode/skills/lark-im.md) — skill · 472900 installs
- [lark-event](https://affpapa.org/en/nevibecode/skills/lark-event.md) — skill · 466800 installs
- [caveman-discover](https://affpapa.org/en/nevibecode/skills/caveman-discover.md) — skill · 104400 installs
- [migration](https://affpapa.org/en/nevibecode/skills/migration.md) — skill · 103900 installs

From the same set: [borghei/claude-skills](https://affpapa.org/en/nevibecode/by/borghei/claude-skills.md) — 17 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md