Home / lstr-1 / skills · orchestrator/skills/architecture/SKILL.md · GitHub

architecture skillA

architecture is agent-read markdown (skill) from lstr-1/skills: Use when the user asks to improve architecture, find refactoring opportunities, surface deepening opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable. Surfaces shallow modules and hypothetical seams using a precise vocabulary (Module / Interface / Implementation / Depth / Seam / Adapter / Leverage / Locality from LANGUAGE.md)..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Improve Codebase Architecture

> **Port note — `unverified` runtime.** This skill references runtime modules under
> `scripts/lib/*.mjs`. Those modules are NOT present in the source plugin directory `sex/`
> and were NOT ported. Every such reference is `unverified`: the agent MUST probe for the
> module at runtime and continue in degraded mode when it is absent. Do NOT assume the module
> exists. Affected modules in this skill: `scripts/lib/language-mappers/index.mjs`.

Surface architectural friction and propose **deepening opportunities** — refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability.

## Glossary

Use these terms exactly in every suggestion. Consistent language is the point — don't drift into "component," "service," "API," or "boundary." Full definitions in [LANGUAGE.md](LANGUAGE.md).

- **Module** — anything with an interface and an implementation (function, class, package, slice).
- **Interface** — everything a caller must know to use the module: types, invariants, error modes, ordering, config. Not just the type signature.
- **Implementation** — the code inside.
…

Read the whole file at its exact version.

How to install

Latest version
mdr add lstr-1/skills/architecture@v0.1.0
Exact content
mdr add lstr-1/skills/architecture@sha256:8236f95dc262154d

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
v0.1.0 latest2026-09-22 a6ca51a 7,179 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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 (7179 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

lstr-1/skills · 2 stars · license none · pushed 2026-09-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_sathgjz57aikwscs
GET https://markdownregistry.com/api/v1/resolve?ref=lstr-1/skills/architecture
GET https://markdownregistry.com/api/v1/blob/8236f95dc262154d54bdb2dcd0b393bd8f7837296c73b42f9df48ffbd3e6440c

Your agent 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.

More from lstr-1/skills

create-skill skill
lstr-1/skills · create-skill/SKILL.md · Use when the user wants to create, design, or generate a new AI agent skill (SKILL.md) from a problem description. This…
v0.1.0 · audit A · 2 stars
monitor-startup-dach skill
lstr-1/skills · monitor-startup-dach/SKILL.md · Fetch the top-25 posts from r/StartupDACH/hot.json, classify each into six deterministic German intent clusters…
v0.1.0 · audit A · 2 stars
nlm-meta-study skill
lstr-1/skills · nlm-meta-study/SKILL.md · Create scientific meta-studies on any topic using Gemini Notebook (NotebookLM). Invoke for systematic reviews…
v0.1.0 · audit A · 2 stars
orchestrator skill
lstr-1/skills · orchestrator/SKILL.md · Orchestriert den vollständigen Session-Lebenszyklus (Bootstrap → Start → Plan → Wave → End) als Prosa-Workflow mit…
v0.1.0 · audit A · 2 stars
autopilot skill
lstr-1/skills · orchestrator/skills/autopilot/SKILL.md · Use this skill when running an autonomous session-orchestration loop. Chains session-start → session-plan →…
v0.1.0 · audit A · 2 stars
bootstrap skill
lstr-1/skills · orchestrator/skills/bootstrap/SKILL.md · Use this skill when scaffolding the minimum repository structure required by orchestrator. Invoked automatically by the…
v0.1.0 · audit A · 2 stars
brainstorm skill
lstr-1/skills · orchestrator/skills/brainstorm/SKILL.md · Use when you have a feature idea but the scope or UX is still ambiguous — runs a lightweight Socratic design dialogue…
v0.1.0 · audit A · 2 stars
claude-md-drift-check skill
lstr-1/skills · orchestrator/skills/claude-md-drift-check/SKILL.md · Use when detecting drift between CLAUDE.md (or AGENTS.md, the Codex CLI alias) / _meta narrative and live repository…
v0.1.0 · audit A · 2 stars
convergence-monitoring skill
lstr-1/skills · orchestrator/skills/convergence-monitoring/SKILL.md · Monitor iterative improvement loops for convergence. Three signals — shrinking diff, pass-rate plateau, velocity —…
v0.1.0 · audit A · 2 stars
daily skill
lstr-1/skills · orchestrator/skills/daily/SKILL.md · Use this skill when creating today's daily note in the Meta-Vault (03-daily/YYYY-MM-DD.md) with valid…
v0.1.0 · audit A · 2 stars
debug skill
lstr-1/skills · orchestrator/skills/debug/SKILL.md · Use when encountering any bug, test failure, build break, or unexpected behavior — runs a 4-phase systematic debugging…
v0.1.0 · audit A · 2 stars
discovery skill
lstr-1/skills · orchestrator/skills/discovery/SKILL.md · Use this skill when running systematic quality discovery and issue detection. Runs modular probes adapted to the…
v0.1.0 · audit A · 2 stars

Every file in lstr-1/skills

Other files named architecture

architecture skill
sickn33/agentic-awesome-skills · plugins/agentic-awesome-skills-claude/skills/architecture/SKILL.md · Architectural decision-making framework. Requirements analysis, trade-off evaluation, ADR documentation. Use when…
git:20260708.a07936c · audit A · 46,848 stars
architecture skill
davepoon/buildwithclaude · plugins/cc-best/skills/architecture/SKILL.md · Architecture design skill with ADR records, system design checklists, scalability assessment, and architecture patterns
git:20260307.6b5172a · audit A · 3,530 stars
architecture rules
sipyourdrink-ltd/bernstein · .cursor/rules/architecture.mdc · Architecture (entry points)
git:20260901.719ea1e · audit A · 1,263 stars
architecture rules
autonomous-ai/autonomous-os · .cursor/rules/architecture.mdc · Architecture and coding conventions for AI Lamp OpenClaw
git:20260324.7a91f3b · audit A · 357 stars
architecture skill
sd0xdev/sd0x-harness · skills/architecture/SKILL.md · Architecture design and documentation. Produces 3-architecture.md with component diagrams, data flow, integration…
git:20260905.3d84d94 · audit A · 189 stars
architecture skill
romiluz13/cc10x · plugins/cc10x/skills/architecture/SKILL.md · Greenfield architecture design: map functionality flows, draw components, design APIs, classify dependencies, plan…
git:20260719.e6f5c51 · audit A · 164 stars
architecture skill
geekfujiwara/codeappsdevelopmentstandard · .github/skills/architecture/SKILL.md · Power Platform ソリューションの全体アーキテクチャを設計する。Copilot Studio / Power Automate / Code Apps / Power Pages / AI Builder…
git:20260914.d1130c4 · audit A · 67 stars
architecture skill
kanevry/session-orchestrator · .agents/skills/architecture/SKILL.md · Use when the user asks to improve architecture, find refactoring opportunities, surface deepening opportunities…
git:20260906.9b0a555 · audit A · 52 stars

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