architecture-optimization agent skill by wondelai
Guides a slow, tangled codebase toward being measurably fast, cleanly bounded, and readable, orchestrating eight skills phase by phase with questions at each decision.
At a glance
| Publisher | wondelai |
|---|---|
| Repository | wondelai/skills (65 listed skills) |
| Category | Code Review and Code Quality |
| License | MIT |
| Last commit | September 10, 2026 (repository) |
| SKILL.md | 270 lines, 4,356 words |
| Bundled files | 3 files, including references |
| Quality score | 76/100 · C Passes all seven graded checks |
| Security scan | Not scanned |
| README badge | Get the listing badge and raise the score |
Before you install
Read from the skill's files at the directory's October 19, 2026 snapshot: what ships with it, what its code reads, and the terms it is published under.
- Bundled scripts: none.
- License: MIT, an open-source or open-content license.
Install architecture-optimization
The skills CLI works with Claude Code, Codex, Cursor and other agents; the other routes copy the folder by hand.
npx skills add https://github.com/wondelai/skills/tree/main/architecture-optimizationtmp="$(mktemp -d)"
git clone --depth 1 https://github.com/wondelai/skills.git "$tmp/repo"
mkdir -p .claude/skills
cp -R "$tmp/repo/"architecture-optimization .claude/skills/
rm -rf "$tmp"python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
--repo wondelai/skills \
--path architecture-optimizationwondelai/skills is third-party code. Read SKILL.md and any bundled scripts before you install it.
How the author describes it
Guided journey from a working codebase grown slow and tangled to one measurably fast, cleanly bounded, and readable. Orchestrates eight skills phase by phase - working-with-legacy-code, clean-architecture, software-design-philosophy, refactoring-patterns, system-design, ddia-systems, release-it, pragmatic-programmer - every phase carries its method inline so it runs standalone, asking the user questions at every decision point and recording results in the project docs/ folder (PERFORMANCE.md, ARCHITECTURE.md, ARCHITECTURE-OPTIMIZATION-PLAN.md) so the journey resumes across sessions. Use when the user wants to make an app faster, untangle drifted boundaries, fix slow endpoints and queries, or says 'it works but it is slow and getting worse'. For an untested prototype, improve-code-quality; for an aged codebase you fear to touch, remove-technical-debt; for greenfield structure, design-code-architecture; for marketing-site page speed, improve-website. For one framework in isolation, invoke that skill directly.
From the description field of SKILL.md. Agents read this line to decide when to load the skill.
Sections in SKILL.md
- Core Principle
- Journey Map
- Operating Rules
- Intake
- Phases
- Phase 1 — Pin it and measure it (working-with-legacy-code) — GATE
- Phase 2 — Re-draw the drifted boundaries (clean-architecture)
- Phase 3 — Deepen the modules (software-design-philosophy)
- Phase 4 — Refactor the hot paths (refactoring-patterns)
- Phase 5 — Attack the measured bottleneck (system-design)
- Phase 6 — Fix the data layer (ddia-systems)
- Phase 7 — Keep it fast when things fail (release-it)
- Phase 8 — Lock in budgets and habits (pragmatic-programmer)
- Optional Phases
- Common Mistakes
- Completing the Journey
Files in the skill folder
SKILL.mdreferences/artifact-templates.mdreferences/methods.md
Suede Skill Check: 76/100 · C
Report snapshot · · graded-v2
The rubric totals 100 points; published scores are capped at 99. Security scan: not scanned.
Source revision: c172996495be. Report version 7fd0810330b7. Badge URLs follow the latest listing; save the report to keep this version.
Download report · Request a fresh review
What to review next
- Description length: 1 of 5 points. 5 for 150–600 characters; 3 for 100–900; 1 for 50–1,024.
- Boundary clause: 0 of 4 points. 4 when the description says when not to use the skill (“Not for …”, “Do not use …”, “Use … instead”).
- Instruction depth: 4 of 7 points. 7 for a SKILL.md body of 500–3,000 words; 4 for 250–4,500; 1 for 100 or more.
Add declarations and bundled files when they describe the skill’s actual needs. Update the source, then request a fresh review with the changed commit or PR.
architecture-optimization passes the required frontmatter check and all seven graded checks, which cover the SKILL.md format, a declared license and a commit in the last year. Those checks earn 56 of the score’s points; the rest come from description quality, instruction depth, bundled files, maintenance and curated-list citations. How the score works.
See the checks and points
| Check | Result |
|---|---|
| Frontmatter parses and declares a name and a description | Pass |
| Name uses lowercase letters, digits and hyphens, 64 characters or fewer | Pass |
| Name matches the skill's folder name | Pass |
| Description is between 50 and 1,024 characters | Pass |
| Description says when an agent should use the skill | Pass |
| SKILL.md body is 500 lines or fewer | Pass |
| A license is declared in the frontmatter or the repository | Pass |
| Repository has a commit in the last 12 months | Pass |
| Score component | Points |
|---|---|
| Structural checks | 56 of 56 |
| Description length | 1 of 5 |
| Boundary clause | 0 of 4 |
| Example request | 3 of 3 |
| Instruction depth | 4 of 7 |
| Reference files | 3 of 3 |
| Bundled scripts | 0 of 2 |
| Recent maintenance | 6 of 9 |
| Curated-list citations | 3 of 7 |
| Tool permissions declared | 0 of 2 |
| Compatibility declared | 0 of 2 |
Show the listing and raise the score
architecture-optimization is listed with 76/100 · C. This badge links to its Suede listing. Skills scoring 80–99 add a numeric and a letter quality shield; the largest open points for architecture-optimization are boundary clause (4), description length (4) and instruction depth (3). Send your repository and the points you want to raise, then request a fresh review after updating the skill.
[](https://skills.suedeai.ai/directory/wondelai/skills/architecture-optimization/)<a href="https://skills.suedeai.ai/directory/wondelai/skills/architecture-optimization/"><img src="https://skills.suedeai.ai/directory/badge.svg" alt="Suede Skills Directory: listed" height="20"></a>Where this skill is cited
wondelai/skills appears in 2 curated lists: BehiSecc/awesome-claude-skills, karanb192/awesome-claude-skills.