{"id":51137339,"url":"https://github.com/sirius-zuo/design-pattern-skill","last_synced_at":"2026-06-25T19:02:53.184Z","repository":{"id":352449201,"uuid":"1213222596","full_name":"sirius-zuo/design-pattern-skill","owner":"sirius-zuo","description":"An agentic skill that reviews your project's architecture for design pattern applicability","archived":false,"fork":false,"pushed_at":"2026-05-15T05:47:52.000Z","size":179,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-15T07:41:03.915Z","etag":null,"topics":["agentic-skill","claude-code","cursor","design-patterns","gof-patterns","guidance","skill-md"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sirius-zuo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-17T06:54:20.000Z","updated_at":"2026-05-15T05:47:51.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sirius-zuo/design-pattern-skill","commit_stats":null,"previous_names":["sirius-zuo/design-pattern-skill"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sirius-zuo/design-pattern-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sirius-zuo%2Fdesign-pattern-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sirius-zuo%2Fdesign-pattern-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sirius-zuo%2Fdesign-pattern-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sirius-zuo%2Fdesign-pattern-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sirius-zuo","download_url":"https://codeload.github.com/sirius-zuo/design-pattern-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sirius-zuo%2Fdesign-pattern-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34788255,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-25T02:00:05.521Z","response_time":101,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-skill","claude-code","cursor","design-patterns","gof-patterns","guidance","skill-md"],"created_at":"2026-06-25T19:02:52.329Z","updated_at":"2026-06-25T19:02:53.179Z","avatar_url":"https://github.com/sirius-zuo.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/Design-Pattern-Skill-banner.jpg\" alt=\"Design-Pattern-Skill\" width=\"1280\"\u003e\n\u003c/p\u003e\n\n\n# Design-Pattern-SKILL\n\nA Claude Code skill that reviews your project's architecture for design pattern applicability. It works in two modes:\n\n- **Design Doc Review** — validates a design document or architecture spec against known patterns before you start coding\n- **Code Review** — analyzes an existing codebase for pattern improvement opportunities\n\nCovers 35+ patterns across GoF Creational, Structural, Behavioral, Modern (Repository, CQRS, Circuit Breaker, etc.), and Architectural (Hexagonal, Clean Architecture, Microservices, etc.) categories, with language-specific guidance for Java, Go, Python, and Rust.\n\n## Installation\n\nThe skill is built as a Claude Code native skill, but the pattern knowledge files can be wired into any AI coding agent that supports custom instructions or context files. Clone the repo first, then follow the instructions for your agent.\n\n```bash\ngit clone git@github.com:sirius-zuo/design-pattern-skill.git\n```\n\n---\n\n### Claude Code\n\n**Prerequisites:** [Claude Code](https://claude.ai/code) installed and configured.\n\n```bash\n# Copy the skill to your Claude Code skills directory\ncp -r design-pattern-skill/design-pattern-review ~/.claude/skills/design-pattern-review\n\n# Create the skill metadata file\ncat \u003e ~/.claude/skills/design-pattern-review/.skill-meta.json \u003c\u003c 'EOF'\n{\n  \"sourceType\": \"local\",\n  \"source\": \"local\",\n  \"skillName\": \"design-pattern-review\",\n  \"path\": \"~/.claude/skills/design-pattern-review\",\n  \"scope\": \"global\"\n}\nEOF\n```\n\nThe skill is immediately active. Invoke it with `/design-pattern-review`.\n\n---\n\n### Cursor\n\nAdd a rule file that instructs Cursor to use the pattern knowledge when reviewing architecture.\n\nCreate `.cursor/rules/design-pattern-review.mdc` in your project root:\n\n```markdown\n---\ndescription: Review architecture and code for design pattern opportunities\nglobs:\nalwaysApply: false\n---\n\nWhen asked to review architecture or suggest design patterns, follow the process in:\n\u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/SKILL.md\n\nUse the pattern knowledge from:\n- \u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/patterns/creational.md\n- \u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/patterns/structural.md\n- \u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/patterns/behavioral.md\n- \u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/patterns/modern.md\n- \u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/patterns/architectural.md\n\nOutput the report using the template in:\n\u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/report-template.md\n```\n\nReplace `\u003cpath-to-cloned-repo\u003e` with the absolute path where you cloned this repo.\n\nThen trigger it in Cursor chat: `@design-pattern-review.mdc Review this codebase for design pattern opportunities.`\n\n---\n\n### GitHub Copilot\n\nAdd instructions to `.github/copilot-instructions.md` in your project root (create it if it doesn't exist):\n\n```markdown\n## Design Pattern Review\n\nWhen asked to review architecture or suggest design patterns, read and follow the instructions at:\n\u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/SKILL.md\n\nReference the pattern knowledge files in:\n\u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/patterns/\n\nOutput findings using the report template at:\n\u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/report-template.md\n```\n\nThen ask Copilot in chat: `Review this project for design pattern opportunities following the design-pattern-review instructions.`\n\n---\n\n### Windsurf\n\nCreate `.windsurfrules` in your project root (or append to it if it exists):\n\n```markdown\n## Design Pattern Review\n\nWhen asked to review architecture or suggest design patterns, follow the process defined in:\n\u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/SKILL.md\n\nUse the pattern reference files in:\n\u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/patterns/\n\nFormat output using:\n\u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/report-template.md\n```\n\nThen ask in Cascade chat: `Review this codebase for design pattern opportunities.`\n\n---\n\n### OpenAI Codex CLI\n\nAdd instructions to `AGENTS.md` in your project root (create it if it doesn't exist):\n\n```markdown\n## Design Pattern Review\n\nWhen asked to review architecture or suggest design patterns, read and follow:\n\u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/SKILL.md\n\nReference the pattern files in:\n\u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/patterns/\n\nFormat the output report using:\n\u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/report-template.md\n```\n\nThen run: `codex \"Review this project for design pattern opportunities\"`\n\n---\n\n### Aider\n\nPass the skill files as context when starting an aider session:\n\n```bash\naider \\\n  --read \u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/SKILL.md \\\n  --read \u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/patterns/creational.md \\\n  --read \u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/patterns/structural.md \\\n  --read \u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/patterns/behavioral.md \\\n  --read \u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/patterns/modern.md \\\n  --read \u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/patterns/architectural.md \\\n  --read \u003cpath-to-cloned-repo\u003e/design-pattern-skill/design-pattern-review/report-template.md\n```\n\nThen in the aider session: `/ask Review this codebase for design pattern opportunities following the SKILL.md instructions.`\n\n## Usage\n\nRun the skill from within Claude Code:\n\n```\n/design-pattern-review\n```\n\n### Auto-detection\n\nBy default, the skill detects the appropriate mode automatically:\n\n- If design/architecture documents are found (`docs/**/*.md`, `ARCHITECTURE.md`, `DESIGN.md`, etc.) → **Design Doc Review Mode**\n- If no design docs are found → **Code Review Mode**\n\n### Flags\n\n| Flag | Description |\n|------|-------------|\n| `--design` | Force design document review mode |\n| `--code` | Force code review mode |\n| `--scope \u003cpath\u003e` | Limit the review to a specific directory |\n\n### Examples\n\n```\n# Auto-detect mode (recommended)\n/design-pattern-review\n\n# Review only the design documents\n/design-pattern-review --design\n\n# Review only the codebase\n/design-pattern-review --code\n\n# Review a specific module\n/design-pattern-review --scope src/auth/\n\n# Review both (run twice with explicit flags)\n/design-pattern-review --design\n/design-pattern-review --code\n```\n\n## Output\n\nThe skill produces a structured markdown report with:\n\n- **Project Summary** — detected language(s), review mode, scope\n- **Patterns Currently in Use** — identified patterns with an assessment (well implemented, misapplied, partially applied)\n- **Recommended Patterns** — opportunities with location, impact, and priority\n- **Detailed Recommendations** — for each opportunity: the problem, why the pattern fits, how to apply it, and trade-offs\n- **Anti-Patterns Observed** — misapplied patterns with recommended alternatives\n\n## Pattern Coverage\n\n| Category | Patterns |\n|----------|----------|\n| Creational (GoF) | Abstract Factory, Builder, Factory Method, Prototype, Singleton |\n| Structural (GoF) | Adapter, Bridge, Composite, Decorator, Facade, Flyweight, Proxy |\n| Behavioral (GoF) | Chain of Responsibility, Command, Interpreter, Iterator, Mediator, Memento, Observer, State, Strategy, Template Method, Visitor |\n| Modern | Repository, Dependency Injection, Circuit Breaker, Event Sourcing, CQRS, Saga, Retry/Backoff, Pub/Sub |\n| Architectural | MVC/MVP/MVVM, Hexagonal/Ports \u0026 Adapters, Clean Architecture, Layered Architecture, Microservices, Event-Driven Architecture, Pipe \u0026 Filter |\n\n## Repository Structure\n\n```\ndesign-pattern-review/\n  SKILL.md                # Main skill definition\n  patterns/\n    creational.md         # Creational pattern detection rules\n    structural.md         # Structural pattern detection rules\n    behavioral.md         # Behavioral pattern detection rules\n    modern.md             # Modern pattern detection rules\n    architectural.md      # Architectural pattern detection rules\n  report-template.md      # Report output template\n```\n\n## Scope\n\nThis skill **recommends** — it does not refactor code. Each recommendation includes trade-offs so you can make an informed decision. It is a first-pass automated check and is not a substitute for human architectural review.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsirius-zuo%2Fdesign-pattern-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsirius-zuo%2Fdesign-pattern-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsirius-zuo%2Fdesign-pattern-skill/lists"}