assess-architecture SKILL.md skillB
assess-architecture from joebew42/aido is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add joebew42/aido/assess-architecture@git:20261108.7e14cbbPins git:20261108.7e14cbb in mdr.lock. Pin the fingerprint instead.
- Audit grade
- B, 16 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- joebew42/aido
- Path
plugins/aido/skills/assess-architecture/SKILL.md- Versions recorded
- 5
- Latest version
- git:20261108.7e14cbb, committed Nov 8, 2026
- First version recorded
- Nov 2, 2026
- Size
- 5,551 bytes
- Repository stars
- 5
- License
- MIT
Assesses the current repository's architecture area by area for evidence-backed systemic refactorings (duplicated knowledge, misplaced ownership, reinvented abstractions, crossed boundaries) and saves the findings the user picks as refactoring ideas, for a later planned change to pull in. Invoked when the user wants to assess the architecture, find refactoring opportunities across the codebase, or runs /aido:assess-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
# Assess the Architecture
Review the repository's design area by area, apart from any feature. Park the findings the user picks
as refactoring opportunities. `/aido:1-plan` offers them when a planned change can include them, so
each refactoring is made as part of a working feature.
This skill reads the repository and never edits it. It writes only the opportunity files the user
explicitly picked, which live outside the repository.
Load `${CLAUDE_PLUGIN_ROOT}/guidelines/language.md` and follow it in everything you write for a person.
## Step 0: Load Context
- find `<repo-name>` and the index directory, as **Index Location and Shape** in
`${CLAUDE_PLUGIN_ROOT}/guidelines/architecture-index.md` defines them
- load:
- `${CLAUDE_PLUGIN_ROOT}/guidelines/systemic-refactoring.md`: what to look for, the evidence rule
and how to park an opportunity
- `${CLAUDE_PLUGIN_ROOT}/guidelines/code-standards.md`: its "Architecture" and "Code Quality" hold
the rules each finding is judged by
- `${CLAUDE_PLUGIN_ROOT}/guidelines/project-conventions.md`. Then gather the host repository's
conventions as it describes
- run `git fetch origin`
…Read the whole file at its exact version.
How to install
mdr add joebew42/aido/assess-architecture@sha256:15e78d25fdaa60ceThe line at the top of this page pins the label git:20261108.7e14cbb, 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.
[](https://markdownregistry.com/a/art_vv5cm5eehydjbecn)
0 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Nov 2, 2026 and Nov 8, 2026, about one every day.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261108.7e14cbb latest | 2026-11-08 | 7e14cbb | 5,551 B | B | view · diff |
| git:20261106.1a5f142 | 2026-11-06 | 1a5f142 | 5,976 B | B | view · diff |
| git:20261105.e3e5a3e | 2026-11-05 | e3e5a3e | 5,841 B | B | view · diff |
| git:20261104.0b5a9da | 2026-11-04 | 0b5a9da | 5,537 B | B | view · diff |
| git:20261102.dcf9d3c | 2026-11-02 | dcf9d3c | 4,975 B | B | view |
Audit of the latest version
- fail: Frontmatter declares a name
- pass: Frontmatter block present
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (5551 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
Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.
Source
joebew42/aido · 5 stars · license MIT · pushed 2026-11-08 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_vv5cm5eehydjbecn GET https://markdownregistry.com/api/v1/resolve?ref=joebew42/aido/assess-architecture GET https://markdownregistry.com/api/v1/blob/15e78d25fdaa60ceaa99c705b70e284feec8d4e8ed14ff4b1a78ced6576438fc
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.