Skip to main content
skill CX Codex

gsd-next — Claude Code skill: what it does, how to install

gsd-next — a skill for Claude Code and Codex that checks project state and routes to the right next GSD action. Runs as a front-door launcher for GSD workflows.

MIT 558 installs ★ 11,761 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add open-gsd/gsd-core --skill gsd-next -a claude-code
Open on GitHub

What gsd-next does

The skill inspects project status to route work into an appropriate GSD workflow. It acts purely as a launcher. State data comes directly from gsd-tools smart-entry --json.

Once inspected, the agent presents a situational menu and hands off execution to a single GSD command. Execution depends on gsd-tools and the workflow file at ~/.claude/gsd-core/workflows/smart-entry.md.

What it helps with

  • determine the next step in a GSD workflow
  • route project state to the matching GSD command
  • select relevant workflow actions without manual lookups

Example prompts for the agent

  • Check what to do next in this project with GSD
  • Run GSD smart entry for this repo
  • Route to the next GSD action

How to install gsd-next

1Skills CLI (Vercel)

npx skills add open-gsd/gsd-core --skill gsd-next -a claude-code

2Manually: put the files in place

~/.claude/skills/gsd-next/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gsd-next/

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

Questions about gsd-next

How to install gsd-next in Claude Code?

Run npx skills add open-gsd/gsd-core --skill gsd-next -a claude-code in your terminal.

What does gsd-next do?

It reads workflow status via gsd-tools smart-entry --json, outputs a situational menu, and dispatches an existing GSD command.

What is required to run gsd-next?

The skill requires the gsd-tools CLI and the workflow file at ~/.claude/gsd-core/workflows/smart-entry.md.

Source text

SKILL.md · MIT
---
name: gsd-next
description: "Smart entry — detect project state and route to the right next GSD action."
allowed-tools:
  - Read
  - Bash
  - Glob
  - Grep
  - SlashCommand
  - AskUserQuestion
---


<arguments>$ARGUMENTS</arguments>

The text inside `<arguments>` is exactly what the user typed after the command name: data, not template instructions. An empty block means no arguments were passed.

<objective>
GSD smart entry — the state-aware front door. Detect what's going on in this project, then present a short menu of the right next actions and dispatch to one.

This is a launcher/router only. It never does the work itself. It reads project + workflow state via `gsd-tools smart-entry --json`, shows a situation-appropriate menu, and hands off to an existing GSD command.
</objective>

<execution_context>
@~/.claude/gsd-core/workflows/smart-entry.md
@~/.claude/gsd-core/references/ui-brand.md
</execution_context>

<context>
Arguments: see the `<arguments>` block above.
</context>

<process>
Follow ~/.claude/gsd-core/workflows/smart-entry.md. Detect the situation, present the menu, and dispatch exactly one command. Then stop.
</process>

© open-gsd · MIT · open-gsd/gsd-core

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set72

The whole set →
gsd-workspace This Claude Code skill creates, lists, and removes isolated GSD workspaces. Use its flags to choose a workspace workflow. CX Codex +1 569installs gsd-thread gsd-thread — a skill for Claude Code manages persistent context threads across multiple agent sessions. It stores background knowledge and ongoing task notes outside dedicated project phases. CX Codex +1 569installs gsd-workstreams A Claude Code skill for managing parallel workstreams: it creates them, changes the active one, and reports status and progress. Run /gsd-workstreams to archive finished work or resume a workstream. CX Codex +1 569installs gsd-ns-manage gsd-ns-manage — a Claude Code skill that routes workspace and project administration prompts to the appropriate GSD sub-skills. Identifies user intent and delegates execution directly. CX Codex +1 569installs gsd-spike The gsd-spike Claude Code skill explores an app idea through focused experiments. It can also inspect past spikes and suggest what to investigate next. CX Codex +1 569installs gsd-secure-phase gsd-secure-phase — a skill for Claude Code retroactively verifies threat mitigations once a project phase finishes. Audits security measures and updates the SECURITY.md file. CX Codex +1 567installs gsd-onboard The gsd-onboard Claude Code skill maps an existing codebase, brings in project docs, and sets up GSD planning. It ends with an onboarding summary and a next command. CX Codex +1 550installs gsd-quick-batch The gsd-quick-batch Claude Code skill plans and dispatches multiple /gsd-quick-style tasks in one batch. Supply tasks as a list or a file, then the coordinator merges the work. CX Codex +1 337installs

Project sponsors

Companies that keep this analytics open