solutions-architect — Claude Code skill: architecture and setup
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.
npx skills add borghei/Claude-Skills --skill solutions-architect -a claude-codeWhat solutions-architect 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.
What it helps with
- 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 for the agent
- 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.
How to install solutions-architect
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill solutions-architect -a claude-code2Manually: put the files in place
~/.claude/skills/solutions-architect/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/solutions-architect/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill solutions-architect -a codex2Manually: put the files in place
.agents/skills/solutions-architect/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill solutions-architect -a cursor2Manually: put the files in place
.cursor/skills/solutions-architect/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install borghei/Claude-Skills solutions-architect2Manually: put the files in place
.github/skills/solutions-architect/SKILL.md1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill solutions-architect -a gemini-cli2Platform CLI
gemini skills install https://github.com/borghei/Claude-Skills --path sales-success/solutions-architectManually: put the files in place
.devin/skills/solutions-architect/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill solutions-architect -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about solutions-architect
How do I install solutions-architect in Claude Code?
Run npx skills add borghei/Claude-Skills --skill solutions-architect -a claude-code. The skill file is at ~/.claude/skills/solutions-architect/SKILL.md.
What does solutions-architect do?
It helps with technical discovery, integration design, security assessment, and proof-of-concept planning. It can also organize the final architecture document.
What should be clarified before designing a solution?
Establish the existing systems, the requirements that shape the design, and the deployment model. A late deployment-model change can invalidate the architecture.