🧩
QualityPython

Code Structure

by michaelshimeles

Code Structure is a Quality skill for Claude Code, published by michaelshimeles in skills.

538 stars92 forkson michaelshimeles/skillsAdded 2026/09/03Repository updated 2026/09/02
agent-skillsai-agentsclaude-codecode-reviewcodexcursordeveloper-workflowgreptile
Install in seconds
Install Code Structure
Copy Code Structure into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/michaelshimeles/skills/tree/main/code-structure ~/.claude/skills/code-structure

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/michaelshimeles/skills.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
code-structure/SKILL.md in michaelshimeles/skills
Installs to
~/.claude/skills/code-structure
Collection
One of 6 skills cataloged from this repository
Category
Quality1478 skills

What Code Structure does

Code Structure explains how to split orchestration logic from shared operational mechanics in a service layer. Use it when repeated workflows need the same low-level operations or when refactoring duplicated blocks across actions.

Code Structure is cataloged under Quality on DirSkills. Code Structure comes from a repository tagged agent-skills, ai-agents, claude-code, code-review and codex.

Documentation

README

Service Layer Architecture

Overview

Two-layer separation: Actions orchestrate domain rules (the "why/when"), while a service layer centralizes reusable operational mechanics (the "how").

This prevents duplicated code, inconsistent behavior, and bugs fixed in one path but not others.

When to Use

  • Multiple callers need the same low-level operation (sandbox creation, email sending, payment processing)
  • You're copy-pasting operational logic between action files
  • A bug fix in one workflow doesn't propagate to others doing the same thing
  • Adding a new feature that shares mechanics with existing flows

Don't use when: Logic is truly domain-specific and used by only one caller.

Core Pattern

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Code Structure

  • What else does michaelshimeles publish alongside Code Structure?

    Code Structure is one of 6 skills that DirSkills catalogs from michaelshimeles/skills, the repository it ships in. Its siblings there include Before and After Screenshot, Evidence-Driven Testing and Greploop. Each one is a separate skill with its own page in this directory, installs the same way Code Structure does, and is maintained by michaelshimeles in that same repository. The rest of the collection is listed on the michaelshimeles/skills page.

  • How does Code Structure compare to other Quality skills?

    Code Structure ranks #1187 by stars among the 1478 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Code Structure against them. Open each page to compare what they document and how they install.