software-design-expert-learn

Review session code with git diff and APOSD criteria.

1|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/Joaovsales/coding-agent-workflow --skill software-design-expert-learn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: software-design-expert-learn
Source: https://github.com/Joaovsales/coding-agent-workflow/tree/main/.agents/skills/software-design-expert-learn
Command: npx skills add https://github.com/Joaovsales/coding-agent-workflow --skill software-design-expert-learn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured, end-of-session design review to help engineers understand design trade-offs and improve code review skills by examining the work produced in the current session.

Core Features & Use Cases

  • Guided design critique: highlight strengths and weaknesses in design decisions across the session's code.
  • APOSD-aligned evaluation: apply core principles such as depth, information hiding, and change amplification to each module reviewed.
  • Actionable improvements: output concrete refactoring suggestions and risk warnings to guide future work.

Quick Start

Provide a concise, actionable design-review of the current session's code and propose concrete improvements.

Frequently Asked Questions about software-design-expert-learn

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review code quality and design trade-offs from my current session?

To review code quality, you can use a session diff to evaluate design trade-offs and generate structured critique. This process applies APOSD principles like depth and information hiding to highlight strengths, weaknesses, and actionable improvements.

What is an APOSD-aligned design review?

An APOSD-aligned design review evaluates code using principles like depth, information hiding, and change amplification. It examines your session diff to identify design weaknesses and provides concrete refactoring suggestions to improve overall module architecture.

How do I get actionable refactoring suggestions from a git diff?

To get actionable refactoring suggestions from a git diff, run an end-of-session design review. This evaluates the diff against software design principles to output concrete improvement recommendations and risk warnings for future work.

Can I use this to improve my code review skills?

Yes, you can improve your code review skills by walking through a guided design critique. It analyzes session code to highlight design trade-offs, helping you understand the reasoning behind structural improvements and apply APOSD principles.

When do I need an end-of-session design review?

You need an end-of-session design review when you want to assess the code produced during a work session. It is applicable for understanding design trade-offs, evaluating code quality against APOSD principles, and planning concrete refactoring steps.

Does this design review work without external dependencies?

Yes, the design review works without external dependencies. It relies on your session's git diff and applies APOSD-based evaluation criteria internally to generate structured critique and actionable improvement recommendations.