skill CX Codex

software-design-principles — Claude Code skill: install and rules

Q: How to install software-design-principles in Claude Code?

Run `npx skills add databricks-solutions/consort --skill software-design-principles -a claude-code`. The file will be placed at `~/.claude/skills/software-design-principles/SKILL.md`.

A Markdown engineering guide for code review, module planning, and refactoring. It enforces clean boundaries, non-functional requirements, and layered design across pull requests.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add databricks-solutions/consort --skill software-design-principles -a claude-code

Open on GitHub

What software-design-principles does

This skill contains no executable scripts or background services. It acts as a reference document for agents and developers during architectural design. The guidelines define conventions for SOLID patterns and directional dependency rules.

Before any pull request merges, the instructions mandate mapping architectural concerns. Teams assign authentication and domain logic to specific layers. Refactoring must preserve external tests. Database schema changes require deleting deprecated fields from migrations and ORM models in the same step.

The skill relies entirely on Markdown text. Adherence to these architectural rules depends on engineer discipline during code reviews.

What it helps with

map cross-cutting requirements to distinct architectural layers
verify inward module dependencies during pull request reviews
keep database schema migrations synchronized with backend models
distinguish superseded assertions from actual software regressions

Example prompts for the agent

Review this pull request against software-design-principles and map our architectural concerns.
Plan a refactor for the authorization service with inward-pointing dependencies.
Help remove the deprecated database column across models and migrations.

How to install software-design-principles

1Skills CLI (Vercel)

npx skills add databricks-solutions/consort --skill software-design-principles -a claude-code

2Manually: put the files in place

~/.claude/skills/software-design-principles/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/software-design-principles/

1Skills CLI (Vercel)

npx skills add databricks-solutions/consort --skill software-design-principles -a codex

2Manually: put the files in place

.agents/skills/software-design-principles/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add databricks-solutions/consort --skill software-design-principles -a cursor

2Manually: put the files in place

.cursor/skills/software-design-principles/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install databricks-solutions/consort software-design-principles

2Manually: put the files in place

.github/skills/software-design-principles/SKILL.md

1Skills CLI (Vercel)

npx skills add databricks-solutions/consort --skill software-design-principles -a gemini-cli

2Platform CLI

gemini skills install https://github.com/databricks-solutions/consort --path skills/software-design-principles

Manually: put the files in place

.devin/skills/software-design-principles/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add databricks-solutions/consort --skill software-design-principles -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about software-design-principles

How to install software-design-principles in Claude Code?

Run npx skills add databricks-solutions/consort --skill software-design-principles -a claude-code. The file will be placed at ~/.claude/skills/software-design-principles/SKILL.md.

What does software-design-principles do?

It defines engineering conventions covering layered architecture, refactoring rules, and cross-cutting concerns. The assistant consults this guide when designing APIs or inspecting changes.

Does software-design-principles contain runnable scripts?

No, it provides documentation files in Markdown. The skill is read as context rather than invoked as a command-line tool.

improve-codebase-architecture Matt Pocock This skill scans a codebase for architectural friction, then builds a visual HTML report with refactoring candidates. Use it before a deeper architecture review. 1,163,035installs tdd Matt Pocock Guides the red-green TDD loop: ensures tests are written first, keep them at public interfaces, and avoid coupling to implementation details. 1,141,062installs triage Matt Pocock This skill moves issues and external PRs through triage states, verification, and agent briefs. It fits maintainers managing an issue queue. 990,453installs codebase-design Matt Pocock This skill helps design modules with small interfaces and hidden complexity. Use it when refactoring code, choosing a seam, or making tests easier to write. 850,344installs code-review Matt Pocock Reviews changes from a chosen reference point against repository standards and the originating spec. Use it for a branch, PR, or work in progress. 789,521installs implement Matt Pocock Implements work from a specification or tickets, following a test-driven flow and ending with review and a commit. Use it when a coding task needs a defined delivery routine. 774,700installs

From the same set4

ui-ux-design-principles A canon for user-experience decisions: a review checklist, hard rules and reference notes. Useful when you build a surface or review someone else's. CX Codex +1 ★ 36repo stars consort consort coordinates spec review and test-driven build cycles for Lakebase-paired projects. Use it to guide feature work through explicit gates and experiments. CX Codex +1 ★ 36repo stars architectural-design-principles Reference guide for system-level architecture rules: layering, dependency direction, ports and adapters, twelve-factor principles for cloud apps. Turns architectural constraints into executable tests, not just documents. CX Codex +1 ★ 36repo stars