a5c-ai/babysitter / library/methodologies/gsd/skills/gsd-tools
gsd-tools
VerifiedCentral 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).
README.md
View on GitHub# gsd-tools
Central utility skill for GSD operations. Provides config parsing, slug generation, timestamps, path operations, and planning directory initialization.
## Quick Start
This skill is automatically invoked at the start of every GSD process. It provides foundational primitives that all other skills and agents depend on.
### Load Configuration
```bash
# Read existing config
cat .planning/config.json
# Config is auto-created with defaults if missing
```
### Generate a Slug
```
Input: "Add OAuth2 authentication"
Output: "add-oauth2-authentication"
```
### Resolve Paths
```
Phase directory: .planning/phase-72/
Quick task: .planning/quick/001-fix-login/
Debug session: .planning/debug/payment-race-condition.md
```
### Detect Project State
Returns one of: `NO_PROJECT`, `INITIALIZED`, `MID_PHASE`, `PHASE_COMPLETE`, `MILESTONE_READY`, `BLOCKED`.
## Examples
### Initialize a New Planning Directory
```bash
mkdir -p .planning
# gsd-tools creates config.json with defaults
# gsd-tools creates STATE.md skeleton
```
### Parse Phase Numbers
```
"72" -> major: 72, minor: null
"72.1" -> major: 72, minor: 1
```
### Quick Task Numbering
Scans `.planning/quick/` for existing directories, finds highest number, returns next sequential number (zero-padded to 3 digits).
## Troubleshooting
### Config not loading
- Check `.planning/config.json` exists and is valid JSON
- Run `gsd health` to diagnose planning directory issues
- Delete `config.json` to reset to defaults
### Slug collisions
- Slugs are deduplicated with `-2`, `-3` suffixes
- If 10+ collisions occur, a timestamp suffix is used instead
- Check target directory for unexpected files
### Planning directory issues
- Ensure `.planning/` is not gitignored (it should be tracked)
- Check write permissions on the directory
- Run `gsd health` for full diagnostic report
### Phase number parsing errors
- Integer phases: `72`, `73`, `74`
- Decimal phases (inserted): `72.1`, `72.2`
- Negative numbers and zero are not valid phase numbers
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |