gsd-tools
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 / Use
npx skills add a5c-ai/babysitter --skill gsd-toolsInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of gsd-tools
gsd-tools scores 92/100 on our quality scale, 899th of 4,698 Development & Engineering skills we index (top 20%).
Its SKILL.md is 7.7 KB long, well organised into 18 sections with 10 code examples: a thorough specification that gives an agent plenty to work with.
With 1,809 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so gsd-tools is actively maintained.
- Our last check on 2026-10-27 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
gsd-tools compared with similar skills
All 4 of these similar skills score higher than gsd-tools; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| gsd-tools (this skill)by a5c-ai | 92 | 1.8k | 2mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install gsd-tools?
- Run
npx skills add a5c-ai/babysitter --skill gsd-tools. The install tabs above show the steps for each supported agent. - Which AI agents does gsd-tools work with?
- It is written for Zed, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is gsd-tools safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is gsd-tools still maintained?
- The repository was last updated about 2 months ago, so gsd-tools is actively maintained.
Skill content
View source on GitHubname: gsd-tools description: 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). allowed-tools: Bash(*) Read Write Edit Glob Grep metadata: author: babysitter-sdk version: "1.0.0" category: gsd-core backlog-id: SK-GSD-001 graph: domains: [domain:software-engineering] skillAreas: [skill-area:agentic-loops, skill-area:orchestration-loop] workflows: [workflow:feature-development] topics: [topic:developer-experience] roles: [role:tech-lead, role:backend-engineer]
- Load and manage
.planning/config.jsonconfiguration - Generate deterministic slugs from descriptions (kebab-case, deduplication)
- Format timestamps for GSD artifact headers and frontmatter
- Resolve paths within the
.planning/directory structure - Parse and normalize phase numbers (integer and decimal)
- Manage sequential quick task numbering in
.planning/quick/ - Initialize and validate
.planning/directory structure - Detect project state (new project, existing project, mid-phase, etc.)
Capabilities
1. Configuration Loading
Load and parse .planning/config.json with defaults:
{
"profile": "balanced",
"autoCommit": true,
"autoVerify": true,
"planCheckerEnabled": true,
"maxPlanRevisions": 2,
"waveParallelization": true,
"contextMonitor": true,
"contextWarningThreshold": 70,
"contextCriticalThreshold": 85,
"summaryVariant": "standard",
"tddEnabled": false,
"questioningDepth": "adaptive"
}
Read config:
cat .planning/config.json
If config does not exist, create with defaults. Merge user overrides with defaults (user values take precedence).
2. Slug Generation
Generate kebab-case slugs from descriptions:
Input: "Add user authentication with OAuth2"
Output: "add-user-authentication-with-oauth2"
Input: "Fix bug #123 in payment processing"
Output: "fix-bug-123-in-payment-processing"
Rules:
- Lowercase all characters
- Replace spaces and special characters with hyphens
- Remove consecutive hyphens
- Trim leading/trailing hyphens
- Maximum 60 characters (truncate at word boundary)
- Check for duplicates in target directory, append
-2,-3if needed
3. Timestamp Formatting
Format timestamps for GSD artifacts:
Header: "2026-03-02T14:30:00Z"
Frontmatter: "2026-03-02"
Filename: "20260302-143000"
Display: "Mar 2, 2026 2:30 PM"
4. Path Operations
Resolve paths within .planning/ structure:
Phase directory: .planning/phase-{N}/
Plan file: .planning/phase-{N}/PLAN-{M}.md
Summary file: .planning/phase-{N}/SUMMARY.md
Quick task: .planning/quick/{NNN}-{slug}/
Debug session: .planning/debug/{slug}.md
Codebase docs: .planning/codebase/
Research docs: .planning/research/
Milestone archive: milestones/v{X}.{Y}/
5. Phase Number Parsing
Parse integer and decimal phase numbers:
"72" -> { major: 72, minor: null, display: "72" }
"72.1" -> { major: 72, minor: 1, display: "72.1" }
"72.2" -> { major: 72, minor: 2, display: "72.2" }
Decimal phases are inserted phases (e.g., urgent work between phase 72 and 73).
6. Quick Task Numbering
Sequential numbering for quick tasks:
.planning/quick/001-fix-login-bug/
.planning/quick/002-add-rate-limiting/
.planning/quick/003-update-readme/
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
Readto 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
Globto check for duplicates in target directory - Append deduplication suffix if needed
- Return final slug
Initializing Planning Directory
- Use
Bashto create directory structure withmkdir -p - Use
Writeto createconfig.jsonwith defaults if missing - Use
Read+Globto detect existing state - Return initialization status
Process Integration
This skill is used by all GSD processes as the first initialization step:
new-project.js- Initialize.planning/, create configplan-phase.js- Resolve phase paths, load config for planner settingsexecute-phase.js- Load config for executor settings, resolve task pathsquick.js- Generate quick task number and slug, resolve quick task pathdebug.js- Generate debug session slug, resolve debug pathprogress.js- Detect project state, load configcomplete-milestone.js- Resolve milestone archive pathadd-tests.js- Resolve phase paths for test generationresearch-phase.js- Resolve research output paths
Output Format
{
"operation": "init|config|slug|path|state",
"status": "success|error",
"result": {
"config": {},
"slug": "generated-slug",
"path": "/resolved/path",
"state": "NO_PROJECT|INITIALIZED|MID_PHASE|..."
},
"metadata": {
"planningDir": ".planning/",
"configPath": ".planning/config.json",
"timestamp": "2026-03-02T14:30:00Z"
}
}
Configuration
| Setting | Default | Description |
|---------|---------|-------------|
| profile | balanced | Model profile (quality/balanced/budget) |
| autoCommit | true | Auto-commit after each task |
| autoVerify | true | Auto-verify after phase execution |
| planCheckerEnabled | true | Run plan checker before execution |
| maxPlanRevisions | 2 | Max plan revision cycles |
| waveParallelization | true | Enable wave-based parallel execution |
| contextMonitor | true | Enable context window monitoring |
| summaryVariant | standard | Summary template variant |
Error Handling
| Error | Cause | Resolution |
|-------|-------|------------|
| Config parse error | Malformed config.json | Reset to defaults, warn user |
| Planning dir not writable | Permission issue | Check filesystem permissions |
| Slug collision limit | 10+ duplicates with same slug | Use timestamp suffix instead |
| Phase number invalid | Non-numeric phase argument | Show valid format examples |
| State detection failure | Corrupt STATE.md | Suggest health command to repair |
Constraints
- Never modify files outside
.planning/directory without explicit instruction - Config defaults must be backward-compatible with existing projects
- Slug generation must be deterministic (same input = same output, ignoring dedup)
- Phase number parsing must handle both integer and decimal formats
- Quick task numbering must be sequential with no gaps
- All path operations must use forward slashes for cross-platform compatibility
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
