klausborges/workflow-skills10 installs

improve-architecture

Q: How do I install this agent skill?

Run npx skills add https://github.com/klausborges/workflow-skills --skill improve-architecture.

Q: Is this agent skill safe to install?

Review the displayed partner audits, complete source, permissions, dependencies, and exact revision before installing.

Discover and shape architecture improvement or simplification opportunities in hard-to-understand, hard-to-test, shallow, scattered, or over-coupled code. Use when the opportunity or interface shape still needs discovery, not for an already-decided bounded change.

How do I install this agent skill?

npx skills add https://github.com/klausborges/workflow-skills --skill improve-architecture

view source ↗

Is this agent skill safe to install?

Gen Agent Trust Hubpass
This skill consists of instructional guidelines and heuristics for architectural analysis. It contains no executable code, scripts, or network-enabled operations.
Socketpass
No alerts
Snykpass
Risk: LOW · No issues

What does this agent skill do?

Improve Architecture

Find concrete architecture friction and shape only the decision still needed.

Use architecture-language.md, engineering-discipline.md, and the repo Glossary/ADRs when present.

Boundaries

Use this skill to discover opportunities or clarify an unresolved module/interface/seam choice.
Use review-work to judge architecture in a concrete change, PR, or Phase.
Send an already-chosen behavior-preserving simplification to simplify-work; send other decided implementation to implement-work. Do not force candidate selection, an interview, a Plan, or a handoff.
Review may recommend this skill but should not start it automatically.

Discovery

Start from caller-visible usage. Map the smallest useful call, component, data, or control-flow sketch needed to clarify modules, ownership, interfaces, and seams.
Identify evidence-backed friction: scattered knowledge, shallow pass-through layers, leaky details, avoidable branches or mutable state, hard-to-test behavior, change amplification, unclear ownership, or a data model that permits invalid states.
Present a small ranked set of candidates only when the user has not already selected the area.
For the chosen candidate, clarify only load-bearing constraints, migration, verification, and caller impact.
Return the smallest useful next artifact: recommendation, interface choice, bounded simplify-work or implement-work scope, Plan request, or handoff. Do not create a Plan or handoff by default.

Candidate summaries should name the area, observed friction, opportunity, benefits, risks, and evidence.

Interface or seam choice

When placement is genuinely unresolved, compare two or three materially different options by caller impact, hidden complexity, migration cost, testability, volatility, and ownership. Recommend one. Skip this branch when placement is obvious or unchanged.

Treat architecture vocabulary as heuristics. A single adapter can justify a seam when it isolates volatility, ownership, or testing; ask what boundary it protects. Prefer public or intentionally stable interfaces as behavioral test surfaces without exposing internals only for tests.

Do not propose broad rewrites, relitigate ADRs without new friction, or make ordinary feature work speak architecture jargon unnecessarily.

How can the creator link this skill?

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/klausborges/workflow-skills/improve-architecture">View improve-architecture on skillZs</a>