consort — Claude Code skill: spec-first, test-driven development
consort coordinates spec review and test-driven build cycles for Lakebase-paired projects. Use it to guide feature work through explicit gates and experiments.
npx skills add databricks-solutions/consort --skill consort -a claude-codeWhat consort does
consort routes work through a design phase and a build phase. The design process drafts and reviews a feature spec, then prepares a test list; /design and /build invoke those stages. Human decisions pause the workflow at its gates.
During build work, tests stay unchanged unless the test list is renegotiated, and experiments belong to a story-specific branch. The accepted experiment is merged with its migrations into the feature branch. Tests run against a real Lakebase database on a paired branch, so this workflow depends on that database setup.
What it helps with
- draft and review a feature spec before implementation
- prepare a test list for a story
- run RED → GREEN → REVIEW → REFACTOR build cycles
- compare competing approaches within a story
- check database schema changes against a parent branch
Example prompts for the agent
- Draft a feature spec and pause at the review gate.
- Prepare the test list for this story and wait for my approval.
- Start the build cycle from the approved spec with
/build.
How to install consort
1Skills CLI (Vercel)
npx skills add databricks-solutions/consort --skill consort -a claude-code2Manually: put the files in place
~/.claude/skills/consort/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/consort/
1Skills CLI (Vercel)
npx skills add databricks-solutions/consort --skill consort -a codex2Manually: put the files in place
.agents/skills/consort/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add databricks-solutions/consort --skill consort -a cursor2Manually: put the files in place
.cursor/skills/consort/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install databricks-solutions/consort consort2Manually: put the files in place
.github/skills/consort/SKILL.md1Skills CLI (Vercel)
npx skills add databricks-solutions/consort --skill consort -a gemini-cli2Platform CLI
gemini skills install https://github.com/databricks-solutions/consort --path skills/consortManually: put the files in place
.devin/skills/consort/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add databricks-solutions/consort --skill consort -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about consort
How do I install consort in Claude Code?
Run npx skills add databricks-solutions/consort --skill consort -a claude-code. The skill file is at ~/.claude/skills/consort/SKILL.md.
What does consort do?
It coordinates spec review, test-list creation, and test-driven build cycles through human decision gates. It also sets rules for tests and story-level experiments.
Where do consort's build tests run?
They run against a real Lakebase database on a paired branch. Build work uses story-scoped experiments, and an accepted experiment is merged with its migrations into the feature branch.
