gsd-settings — Claude Code skill: setup and use
The gsd-settings Claude Code skill configures GSD workflow options and a model profile. It opens an interactive settings flow for GSD.
MIT 572 installs ★ 11,761 updated 2026-11-16
npx skills add open-gsd/gsd-core --skill gsd-settings -a claude-codeWhat gsd-settings does
The skill checks for a GSD configuration, reads its current values, then asks about the model profile and workflow switches. The options include research, plan checks, a verifier, drift guard, TDD, code review, worktrees, and compact content.
It merges the answers into the configuration, writes the result, and displays confirmation with quick command references. The settings flow depends on ~/.claude/gsd-core/workflows/settings.md.
What it helps with
- set a model profile for GSD
- toggle workflow stages on or off
- save selected GSD options to the configuration
- view quick references for settings commands
Example prompts for the agent
- Configure the GSD workflow options and model profile.
- Turn off plan checks and adjust the other GSD switches.
- Ask me about GSD settings, then save my choices.
How to install gsd-settings
1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-settings -a claude-code2Manually: put the files in place
~/.claude/skills/gsd-settings/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gsd-settings/
1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-settings -a codex2Manually: put the files in place
.agents/skills/gsd-settings/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-settings -a cursor2Manually: put the files in place
.cursor/skills/gsd-settings/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install open-gsd/gsd-core skills/gsd-settings2Manually: put the files in place
.github/skills/gsd-settings/SKILL.md1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-settings -a gemini-cli2Platform CLI
gemini skills install https://github.com/open-gsd/gsd-core --path skills/gsd-settingsManually: put the files in place
.devin/skills/gsd-settings/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-settings -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 gsd-settings
How do I install gsd-settings in Claude Code?
Run npx skills add open-gsd/gsd-core --skill gsd-settings -a claude-code. The skill file is installed at ~/.claude/skills/gsd-settings/SKILL.md.
What does gsd-settings do?
It guides an interactive setup for the GSD model profile and workflow switches, then writes the resulting configuration.
Which GSD options can gsd-settings configure?
Options include research, plan checks, a verifier, drift guard, TDD, code review, worktrees, and compact content.
Source text
SKILL.md · MIT
--- name: gsd-settings description: "Configure GSD workflow toggles and model profile" allowed-tools: - Read - Write - Bash - Grep - AskUserQuestion --- <objective> Interactive configuration of GSD workflow agents and model profile via multi-question prompt. Routes to the settings workflow which handles: - Config existence ensuring - Current settings reading and parsing - Interactive multi-question prompt covering model profile and workflow toggles (research, plan_check, verifier, drift guard, TDD, code review, worktrees, compact content, and more — see `gsd-core/workflows/settings.md` for the current set) - Config merging and writing - Confirmation display with quick command references </objective> <execution_context> @~/.claude/gsd-core/workflows/settings.md </execution_context> <process> Execute end-to-end. </process>
© open-gsd · MIT · open-gsd/gsd-core