Sandbox
Sign in
@luoling8192/software-design-philosophy-skill
Skills#Claude Code#Codex#Coding#Code review

Software design skill for Claude Code and Codex

This is a reusable skill that brings Ousterhout-style design advice into agent-led development. It is meant to shape reviews and decisions around architecture, module boundaries, APIs, naming, comments, and error handling.

342 stars•18 forks•Updated 2mo ago
Who it's for

Builders who want their agent to use a consistent software design philosophy during coding and review.

What it delivers

You can ask your agent for design guidance without re-explaining the same principles each time.

What it does

Code review guidance

Provides design philosophy checks during reviews.

Architecture discussion support

Helps weigh architecture and module decomposition decisions.

API and refactoring guidance

Offers input on API design, refactoring, naming, and commenting.

Error handling strategy

Gives design-oriented advice for error handling choices.

How to get it

  1. 1Run
    claude install-skill luoling8192/software-design-philosophy-skill
  2. 2Run
    codex skills add luoling8192/software-design-philosophy-skill
  3. 3Run
    npx skills add luoling8192/software-design-philosophy-skill

README

software-design-philosophy

A reusable agent skill based on John Ousterhout's A Philosophy of Software Design.

What it does

This skill provides design philosophy guidance during:

  • Code reviews
  • Architecture discussions
  • API design
  • Module decomposition decisions
  • Refactoring
  • Naming and commenting improvements
  • Error handling strategy

Installation

Claude Code

claude install-skill luoling8192/software-design-philosophy-skill

Codex

codex skills add luoling8192/software-design-philosophy-skill

Skills.sh (Vercel)

npx skills add luoling8192/software-design-philosophy-skill

License

MIT

Files in the repo

Repository payload•4 top-level entries
  • codex-skill.md
  • LICENSE
  • README.md
  • SKILL.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

obra/
superpowers
obra/superpowersSkills

An agentic skills framework & software development methodology that works.

285k
1 add
Graphify-Labs/graphifySkills

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

117k
1 add
Vincentwei1021/
anything2explainer
Vincentwei1021/anything2explainerSkills

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666
career-ops-hq/career-opsSkills

Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

71k