architect SKILL.md skillA

architect from uze-sh/uze is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add uze-sh/uze/architect@git:20261007.3aa314d

Pins git:20261007.3aa314d in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
uze-sh/uze
Path
plugins/uze/skills/architect/SKILL.md
Versions recorded
5
Latest version
git:20261007.3aa314d, committed Oct 7, 2026
First version recorded
Sep 29, 2026
Size
6,642 bytes
Repository stars
3
License
Apache-2.0

Writing and changing the Mermaid diagrams a project keeps under `workspace.artifacts` — choosing which diagram and which level a change belongs in, naming it so it reads where a reader expects, and proving it still draws with `uze agent artifacts check`, which needs no workspace. Use when adding or editing a `.mmd`/`.mermaid` file, when asked to diagram or document an architecture, when a diagram does not draw, or when setting up where a project keeps its architecture.

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

# UZE — a project's architecture, as files somebody wrote

A project tells UZE where its architecture lives:

```yaml
# agents.yaml
workspace:
  artifacts: docs/architecture   # or a list: [docs, design]
```

Every `.mmd` or `.mermaid` file under those directories is one **artifact**;
anything else there is ignored, so diagrams can live beside other docs. The
same places are where the workspace's spec surface finds decision records
(ADRs), by their shape, so a decision a diagram depends on can sit beside it
in `docs/adr/` without anything else declared.
`uze agent artifacts check` draws each one the way the workspace would and
fails on one that does not draw, with or without the workspace running;
the workspace's architect surface, when it is used, draws them in terminal
cells to read and walk. Nothing
lists the files and nothing registers them: adding a file is the whole act
of adding a diagram, and an index beside them would be the one document
that is wrong the moment somebody adds the next one.

That is also the boundary of what belongs here. These diagrams are what
somebody **wrote down**. What a project *is* — where its lines are, which
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add uze-sh/uze/architect@sha256:652c451aa3a07a0d

The line at the top of this page pins the label git:20261007.3aa314d, 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_bk4fg2j5ikszbw2w.svg)](https://markdownregistry.com/a/art_bk4fg2j5ikszbw2w)

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

Versions

The registry has recorded 5 versions of this file, between Sep 29, 2026 and Oct 7, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20261007.3aa314d latest2026-10-07 3aa314d 6,642 BA view · diff
git:20261005.3bf25bc2026-10-05 3bf25bc 6,694 BA view · diff
git:20261005.7965baf2026-10-05 7965baf 6,492 BA view · diff
git:20260930.ae58e9f2026-09-30 ae58e9f 6,351 BA view · diff
git:20260929.10e58782026-09-29 10e5878 6,190 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 (6642 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

uze-sh/uze · 3 stars · license Apache-2.0 · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_bk4fg2j5ikszbw2w
GET https://markdownregistry.com/api/v1/resolve?ref=uze-sh/uze/architect
GET https://markdownregistry.com/api/v1/blob/652c451aa3a07a0d0609f04a4ddeb3971ab64a0866672729b998cef402c1f7f3

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 uze-sh/uze

conformance-debug SKILL.md skill
uze-sh/uze · .agents/skills/conformance-debug/SKILL.md · Fast, targeted debugging of the Harness Conformance Lab (conformance/) — use whenever a conformance check fails…
git:20261017.1d0b3a6 · audit A · 3 stars
design-system SKILL.md skill
uze-sh/uze · .agents/skills/design-system/SKILL.md · The design system for everything UZE draws or prints - the workspace TUI (src/ui/), the CLI's output and help…
git:20261019.4e31f58 · audit A · 3 stars
harness-watch SKILL.md skill
uze-sh/uze · .agents/skills/harness-watch/SKILL.md · Surveying what the supported harnesses (Claude Code, Codex, OpenCode, Antigravity CLI) shipped since UZE last looked…
git:20261014.fd0b4a7 · audit A · 3 stars
journey-author SKILL.md skill
uze-sh/uze · .agents/skills/journey-author/SKILL.md · Writing, changing or debugging a product journey (journeys/) — use whenever you are adding a scenario for a user-facing…
git:20261017.1d0b3a6 · audit A · 3 stars
openspec-apply-change SKILL.md skill
uze-sh/uze · .agents/skills/openspec-apply-change/SKILL.md · Implement tasks from an OpenSpec change. Use when the user wants to start implementing, continue implementation, or…
v1.0 · audit A · 3 stars
openspec-archive-change SKILL.md skill
uze-sh/uze · .agents/skills/openspec-archive-change/SKILL.md · Archive a completed OpenSpec change in the experimental workflow. Use when the user wants to finalize and archive a…
v1.0 · audit A · 3 stars
openspec-explore SKILL.md skill
uze-sh/uze · .agents/skills/openspec-explore/SKILL.md · Enter OpenSpec explore mode - a thinking partner for exploring ideas, investigating problems, and clarifying…
v1.0 · audit A · 3 stars
openspec-propose SKILL.md skill
uze-sh/uze · .agents/skills/openspec-propose/SKILL.md · Propose a new OpenSpec change with all artifacts generated in one step. Use when the user wants to quickly describe…
v1.0 · audit A · 3 stars
openspec-sync-specs SKILL.md skill
uze-sh/uze · .agents/skills/openspec-sync-specs/SKILL.md · Sync delta specs from an OpenSpec change to main specs. Use when the user wants to update main specs with changes from…
v1.0 · audit A · 3 stars
openspec-update-change SKILL.md skill
uze-sh/uze · .agents/skills/openspec-update-change/SKILL.md · Update an OpenSpec change by revising its existing planning artifacts and keeping them coherent with one another. Use…
v1.0 · audit A · 3 stars
AGENTS.md AGENTS.md file
uze-sh/uze · AGENTS.md
git:20261017.1d0b3a6 · audit A · 3 stars
analyze SKILL.md skill
uze-sh/uze · conformance/_fixtures/marketplace/plugins/flow/skills/analyze/SKILL.md · Conformance fixture for a skill unavailable from slash commands.
git:20260906.db42e8c · audit A · 3 stars

Every file in uze-sh/uze

Other files named architect

architect SKILL.md skill
cursor/plugins · harness/pstack/claude-code/skills/architect/SKILL.md · Sketch types, signatures, and module structure before code, then stay in the loop while implementation fills in. Use…
git:20261016.182f2ce · audit A · 13,494 stars
architect SKILL.md skill
cursor/plugins · pstack/skills/architect/SKILL.md · Sketch types, signatures, and module structure before code, then stay in the loop while implementation fills in. Use…
git:20261010.00b14f1 · audit A · 13,494 stars
architect SKILL.md skill
michael-denyer/pstack-claude · plugins/pstack/skills/architect/SKILL.md · Sketch types, signatures, and module structure before code, then stay in the loop while implementation fills in. Use…
git:20261020.d56fdb0 · audit A · 3,263 stars
architect SKILL.md skill
backnotprop/pstack · skills/architect/SKILL.md · Sketch types, signatures, and module structure before code, then stay in the loop while implementation fills in. Use…
git:20261020.e44668c · audit A · 2,481 stars
architect SKILL.md skill
sipyourdrink-ltd/bernstein · templates/skills/architect/SKILL.md · System design - module boundaries, API contracts, ADRs.
git:20260521.b455a7c · audit A · 1,310 stars
architect SKILL.md skill
sethgammon/citadel · skills/architect/SKILL.md · Given a PRD, produces an implementation architecture: file tree, component breakdown, data model, and a phased build…
git:20260611.0f3f8e7 · audit A · 925 stars
architect SKILL.md skill
oliver-kriska/claude-elixir-phoenix · plugins/rewrite/skills/architect/SKILL.md · Design the idiomatic Elixir architecture for a rewrite: set the compatibility bar (ADR-000), consult phx specialists on…
git:20261016.60a2294 · audit A · 569 stars
architect SKILL.md skill
aiskillstore/marketplace · skills/0xsero/architect/SKILL.md · Design systems, plan implementations, review architecture decisions - Use when you need to plan a complex feature…
git:20260113.222b7de · audit A · 439 stars

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