ai-architecture-advisor SKILL.md skillA

ai-architecture-advisor from vasilyu1983/ai-agents-public is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add vasilyu1983/ai-agents-public/ai-architecture-advisor@v1.7

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

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
vasilyu1983/ai-agents-public
Path
skills/universal/ai-architecture-advisor/SKILL.md
Versions recorded
1
Latest version
v1.7, committed Oct 5, 2026
Size
27,124 bytes
Repository stars
101
License
MIT

Chooses among AI/ML approaches: classical ML, LLM, RAG, fine-tuning, agents, embeddings, MoE or SSM. Use when picking or scaling an architecture, or self-host vs API.

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

# AI Architecture Advisor

The **front-door decision skill** for "I have problem X — what should I build with?" It owns
the **choice** — which approach fits, when to promote complexity (and when *not* to), how to
transfer knowledge, how to scale — then **hands off** to the deep skill that owns the depth. It
spans the whole modeling space in one place so you can compare options that normally live in
separate skills side by side:

```text
tabular GBDT  ·  deep net  ·  Transformer/LLM  ·  RAG  ·  fine-tuning  ·  agents
multimodal/omni  ·  embeddings & retrieval  ·  recsys/ranking  ·  model architecture (dense/MoE/SSM/diffusion)
```

No theory dumps — decision tables, elimination logic, tradeoffs, and a pointer to the deep skill.

**The architect's move is to ask before answering.** The amateur hears "build an AI feature"
and reaches for the model they know ("we'll fine-tune Kimi"). The architect first asks: *what
data type? what volume? what task? what's the success metric? do you even need a Transformer?*
The skill that distinguishes an architect is the willingness to say **"for this, CatBoost wins,"**
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add vasilyu1983/ai-agents-public/ai-architecture-advisor@sha256:329e9df2124879d1

The line at the top of this page pins the label v1.7, 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_hqdrm72xlcfcppjh.svg)](https://markdownregistry.com/a/art_hqdrm72xlcfcppjh)

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

Versions

The registry has recorded 1 version of this file, committed on Oct 5, 2026.

versioncommittedcommitsizeaudit
v1.7 latest2026-10-05 5db538c 27,124 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 (27124 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

vasilyu1983/ai-agents-public · 101 stars · license MIT · pushed 2026-10-16 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_hqdrm72xlcfcppjh
GET https://markdownregistry.com/api/v1/resolve?ref=vasilyu1983/ai-agents-public/ai-architecture-advisor
GET https://markdownregistry.com/api/v1/blob/329e9df2124879d1167262b3a2745ce971935baacf7cf8b0937b7c865a752c7d

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 vasilyu1983/ai-agents-public

AGENTS.md AGENTS.md file
vasilyu1983/ai-agents-public · AGENTS.md
git:20261005.5db538c · audit A · 101 stars
AGENTS.md@agents AGENTS.md file
vasilyu1983/ai-agents-public · agents/AGENTS.md
git:20261005.5db538c · audit A · 101 stars
AGENTS.md@hooks AGENTS.md file
vasilyu1983/ai-agents-public · hooks/AGENTS.md
git:20261005.5db538c · audit A · 101 stars
agents-hooks SKILL.md skill
vasilyu1983/ai-agents-public · skills/universal/agents-hooks/SKILL.md · Configures Claude Code hooks and Codex hooks.json/notify. Use when adding PreToolUse guards, Stop hooks, managed hooks…
v1.6 · audit A · 101 stars
agents-mcp SKILL.md skill
vasilyu1983/ai-agents-public · skills/universal/agents-mcp/SKILL.md · Configures and hardens Claude Code and Codex MCP servers. Use when connecting databases, APIs, SaaS, building servers…
v1.7 · audit A · 101 stars
agents-memory SKILL.md skill
vasilyu1983/ai-agents-public · skills/universal/agents-memory/SKILL.md · Owns instruction files: AGENTS.md, CLAUDE.md, personal and repo rules. Use when writing, pruning, auditing them…
v1.6 · audit A · 101 stars
agents-skills-feedback-loop SKILL.md skill
vasilyu1983/ai-agents-public · skills/universal/agents-skills-feedback-loop/SKILL.md · Adds per-skill learnings loops for dated patterns, mistakes, and domain facts. Use when wiring skill memory…
v1.6 · audit A · 101 stars
agents-skills SKILL.md skill
vasilyu1983/ai-agents-public · skills/universal/agents-skills/SKILL.md · Creates and audits agent skills: SKILL.md, references, scripts, runtime metadata. Use when writing, validating, or…
v1.2 · audit A · 101 stars
agents-subagents SKILL.md skill
vasilyu1983/ai-agents-public · skills/universal/agents-subagents/SKILL.md · Chooses subagent, team, workflow, or debate and launches it on Claude Code or Codex. Use when delegating, running agent…
v1.6 · audit A · 101 stars
agents-swarm-orchestration SKILL.md skill
vasilyu1983/ai-agents-public · skills/universal/agents-swarm-orchestration/SKILL.md · Designs and runs agent hives and multi-agent waves. Use when setting hive roles, code gates, dependency-graph fan-out…
v1.9 · audit A · 101 stars
ai-agents SKILL.md skill
vasilyu1983/ai-agents-public · skills/universal/ai-agents/SKILL.md · AI agent architecture, graph and loop composition, protocol choice, evaluation, and observability. Use when scoping or…
v1.3 · audit A · 101 stars
ai-bot-builder SKILL.md skill
vasilyu1983/ai-agents-public · skills/universal/ai-bot-builder/SKILL.md · Builds production AI bots with Python for support, sales, and custom domains. Use when designing conversation flows…
v1.3 · audit A · 101 stars

Every file in vasilyu1983/ai-agents-public

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