Central utility skill for GSD operations. Provides config parsing, slug generation, timestamps, path operations, and orchestrates calls to other specialized skills. Acts as the unified entry point that the original gsd-tools.cjs provided via its lib/ modules (commands, config, core, init).
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
Central utility skill for GSD operations. Provides config parsing, slug generation, timestamps, path operations, and orchestrates calls to other specialized skills. Acts as the unified entry point that the original gsd-tools.cjs provided via its lib/ modules (commands, config, core, init).
Scan existing directories, find highest number, increment by 1. Zero-pad to 3 digits.
7. Planning Directory Initialization
Ensure .planning/ directory exists with required structure:
.planning/
config.json
PROJECT.md (if new-project has run)
REQUIREMENTS.md (if new-project has run)
ROADMAP.md (if new-project has run)
STATE.md (always present after init)
quick/ (created on demand)
debug/ (created on demand)
codebase/ (created on demand)
research/ (created on demand)
8. Project State Detection
Detect current project state for routing:
const states = {
NO_PROJECT: "No .planning/ directory or no PROJECT.md",
INITIALIZED: ".planning/ exists with PROJECT.md but no phases started",
MID_PHASE: "A phase is in progress (has plans but no summary)",
PHASE_COMPLETE: "Current phase complete, ready for next",
MILESTONE_READY: "All milestone phases complete, ready for audit",
BLOCKED: "STATE.md has active blockers"
};
Tool Use Instructions
Reading Configuration
Use Read to load .planning/config.json
Parse JSON and merge with defaults
Return merged configuration object
Generating Slugs
Accept description string as input
Apply slug transformation rules
Use Glob to check for duplicates in target directory
Append deduplication suffix if needed
Return final slug
Initializing Planning Directory
Use Bash to create directory structure with mkdir -p
Use Write to create config.json with defaults if missing
Use Read + Glob to detect existing state
Return initialization status
Process Integration
This skill is used by all GSD processes as the first initialization step:
