architecture-designer SKILL.md skillA

This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.

architecture-designer from nicholyx/ai-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add nicholyx/ai-skills/architecture-designer@v1.1.1

Pins v1.1.1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
nicholyx/ai-skills
Path
.agents/skills/architecture-designer/SKILL.md
Versions recorded
2
Latest version
v1.1.1, committed May 16, 2026
First version recorded
May 16, 2026
Size
4,750 bytes
Repository stars
6
License
Apache-2.0

Use when designing new high-level system architecture, reviewing existing designs, or making architectural decisions. Invoke to create architecture diagrams, write Architecture Decision Records (ADRs), evaluate technology trade-offs, design component interactions, and plan for scalability. Use for system design, architecture review, microservices structuring, ADR authoring, scalability planning, and infrastructure pattern selection — distinct from code-level design patterns or database-only…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Architecture Designer

Senior software architect specializing in system design, design patterns, and architectural decision-making.

## Role Definition

You are a principal architect with 15+ years of experience designing scalable, distributed systems. You make pragmatic trade-offs, document decisions with ADRs, and prioritize long-term maintainability.

## When to Use This Skill

- Designing new system architecture
- Choosing between architectural patterns
- Reviewing existing architecture
- Creating Architecture Decision Records (ADRs)
- Planning for scalability
- Evaluating technology choices

## Core Workflow

1. **Understand requirements** — Gather functional, non-functional, and constraint requirements. _Verify full requirements coverage before proceeding._
2. **Identify patterns** — Match requirements to architectural patterns (see Reference Guide).
3. **Design** — Create architecture with trade-offs explicitly documented; produce a diagram.
4. **Document** — Write ADRs for all key decisions.
5. **Review** — Validate with stakeholders. _If review fails, return to step 3 with recorded feedback._

## Reference Guide

Load detailed guidance based on context:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nicholyx/ai-skills/architecture-designer@sha256:5235b031e8fadacf

The line at the top of this page pins the label v1.1.1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_vigsqs6jgjenc43x.svg)](https://markdownregistry.com/a/art_vigsqs6jgjenc43x)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, all committed on May 16, 2026.

versioncommittedcommitsizeaudit
v1.1.1 latest2026-05-16 dd241a9 4,750 BA view · diff
v1.1.12026-05-16 4d9ab13 4,644 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4750 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

nicholyx/ai-skills · 6 stars · license Apache-2.0 · pushed 2026-10-18 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_vigsqs6jgjenc43x
GET https://markdownregistry.com/api/v1/resolve?ref=nicholyx/ai-skills/architecture-designer
GET https://markdownregistry.com/api/v1/blob/5235b031e8fadacf01f39ad9db7b8d5ec9d6f83460ebcef78da95d31c9f36276

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from nicholyx/ai-skills

agent-browser SKILL.md skill
nicholyx/ai-skills · .agents/skills/agent-browser/SKILL.md · Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages…
git:20260516.dd241a9 · audit A · 6 stars
architecture-patterns SKILL.md skill
nicholyx/ai-skills · .agents/skills/architecture-patterns/SKILL.md · Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven…
git:20260516.dd241a9 · audit A · 6 stars
browser-use SKILL.md skill
nicholyx/ai-skills · .agents/skills/browser-use/SKILL.md · Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs…
git:20260516.dd241a9 · audit A · 6 stars
deep-research SKILL.md skill
nicholyx/ai-skills · .agents/skills/deep-research/SKILL.md · Use when the user needs multi-source research with citation tracking, evidence persistence, and structured report…
git:20260516.dd241a9 · audit A · 6 stars
docx SKILL.md skill
nicholyx/ai-skills · .agents/skills/docx/SKILL.md · Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers…
git:20260516.4d9ab13 · audit A · 6 stars
enhance-prompt SKILL.md skill
nicholyx/ai-skills · .agents/skills/enhance-prompt/SKILL.md · Transforms vague UI ideas into polished, Stitch-optimized prompts. Enhances specificity, adds UI/UX keywords, injects…
git:20260516.4d9ab13 · audit A · 6 stars
AGENTS.md@.agents/skills/extension-dev-skill AGENTS.md file
nicholyx/ai-skills · .agents/skills/extension-dev-skill/AGENTS.md
git:20260516.9c51e17 · audit A · 6 stars
extension-dev-skill SKILL.md skill
nicholyx/ai-skills · .agents/skills/extension-dev-skill/SKILL.md · AI Skill for building EasyEDA Pro extension plugins. Used when users need to create, modify, or debug EasyEDA Pro…
v2.0.0 · audit A · 6 stars
find-skills SKILL.md skill
nicholyx/ai-skills · .agents/skills/find-skills/SKILL.md · Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is…
git:20260516.4d9ab13 · audit A · 6 stars
frontend-design SKILL.md skill
nicholyx/ai-skills · .agents/skills/frontend-design/SKILL.md · Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to…
git:20260516.4d9ab13 · audit A · 6 stars
gh-cli SKILL.md skill
nicholyx/ai-skills · .agents/skills/gh-cli/SKILL.md · GitHub CLI (gh) comprehensive reference for repositories, issues, pull requests, Actions, projects, releases, gists…
git:20260516.4d9ab13 · audit A · 6 stars
humanizer-zh SKILL.md skill
nicholyx/ai-skills · .agents/skills/humanizer-zh/SKILL.md · 去除文本中的 AI 生成痕迹。适用于编辑或审阅文本,使其听起来更自然、更像人类书写。 基于维基百科的"AI 写作特征"综合指南。检测并修复以下模式:夸大的象征意义、 宣传性语言、以 -ing…
git:20260516.dd241a9 · audit A · 6 stars

Every file in nicholyx/ai-skills

Other files named architecture-designer

architecture-designer SKILL.md skill
jeffallan/claude-skills · skills/architecture-designer/SKILL.md · Use when designing new high-level system architecture, reviewing existing designs, or making architectural decisions…
v1.1.1 · audit A · 12,006 stars
architecture-designer SKILL.md skill
jahidulislamseo/antigravity-ai-skills · skills/architecture-designer/SKILL.md · Use when designing new high-level system architecture, reviewing existing designs, or making architectural decisions…
v1.1.1 · audit A · 4 stars
architecture-designer SKILL.md skill
zacklecon/claude-skills · skills/architecture-designer/SKILL.md · Use when designing new system architecture, reviewing existing designs, or making architectural decisions. Invoke for…
v1.0.0 · audit A · 3 stars

Browse by kind, by grade A, or by owner.