GS

Sets up new projects by gathering context and creating project documentation.

Install

mkdir -p .claude/skills/gsd-new-project-gustavosareto && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/13127" && unzip -o skill.zip -d .claude/skills/gsd-new-project-gustavosareto && rm skill.zip

Installs to .claude/skills/gsd-new-project-gustavosareto

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Initialize a new project with deep context gathering and PROJECT.md
67 charsno explicit “when” trigger
Beginner

Key capabilities

  • Gather deep context through questioning
  • Conduct optional domain research
  • Define project requirements
  • Establish a phase structure (roadmap)
  • Create .planning/PROJECT.md with project context
  • Create .planning/STATE.md for project memory

How it works

The skill guides through a unified flow of questioning, optional research, requirements definition, and roadmap creation to initialize a new project.

Inputs & outputs

You give it
GSD_ARGS (optional), with an idea document via @ reference in --auto mode
You get back
.planning/PROJECT.md, .planning/config.json, .planning/research/, .planning/REQUIREMENTS.md, .planning/ROADMAP.md, .planning/STATE.md

When to use gsd-new-project

  • Starting a new project
  • Setting up project documentation
  • Context gathering for new work

About this skill

<codex_skill_adapter>

A. Skill Invocation

  • This skill is invoked by mentioning $gsd-new-project.
  • Treat all user text after $gsd-new-project as {{GSD_ARGS}}.
  • If no arguments are present, treat {{GSD_ARGS}} as empty.

B. AskUserQuestion → request_user_input Mapping

GSD workflows use AskUserQuestion (Claude Code syntax). Translate to Codex request_user_input:

Parameter mapping:

  • headerheader
  • questionquestion
  • Options formatted as "Label" — description{label: "Label", description: "description"}
  • Generate id from header: lowercase, replace spaces with underscores

Batched calls:

  • AskUserQuestion([q1, q2]) → single request_user_input with multiple entries in questions[]

Multi-select workaround:

  • Codex has no multiSelect. Use sequential single-selects, or present a numbered freeform list asking the user to enter comma-separated numbers.

Execute mode fallback:

  • When request_user_input is rejected (Execute mode), present a plain-text numbered list and pick a reasonable default.

C. Task() → spawn_agent Mapping

GSD workflows use Task(...) (Claude Code syntax). Translate to Codex collaboration tools:

Direct mapping:

  • Task(subagent_type="X", prompt="Y")spawn_agent(agent_type="X", message="Y")
  • Task(model="...") → omit (Codex uses per-role config, not inline model selection)
  • fork_context: false by default — GSD agents load their own context via <files_to_read> blocks

Parallel fan-out:

  • Spawn multiple agents → collect agent IDs → wait(ids) for all to complete

Result parsing:

  • Look for structured markers in agent output: CHECKPOINT, PLAN COMPLETE, SUMMARY, etc.
  • close_agent(id) after collecting results from each agent </codex_skill_adapter>

<runtime_note> Copilot (VS Code): Use vscode_askquestions wherever this workflow calls AskUserQuestion. They are equivalent — vscode_askquestions is the VS Code Copilot implementation of the same interactive question API. </runtime_note>

<context> **Flags:** - `--auto` — Automatic mode. After config questions, runs research → requirements → roadmap without further interaction. Expects idea document via @ reference. </context> <objective> Initialize a new project through unified flow: questioning → research (optional) → requirements → roadmap.

Creates:

  • .planning/PROJECT.md — project context
  • .planning/config.json — workflow preferences
  • .planning/research/ — domain research (optional)
  • .planning/REQUIREMENTS.md — scoped requirements
  • .planning/ROADMAP.md — phase structure
  • .planning/STATE.md — project memory

After this command: Run /gsd-plan-phase 1 to start execution. </objective>

<execution_context> @C:/Users/gusta/OneDrive/Documentos/gerenciador-de-quadras/.codex/get-shit-done/workflows/new-project.md @C:/Users/gusta/OneDrive/Documentos/gerenciador-de-quadras/.codex/get-shit-done/references/questioning.md @C:/Users/gusta/OneDrive/Documentos/gerenciador-de-quadras/.codex/get-shit-done/references/ui-brand.md @C:/Users/gusta/OneDrive/Documentos/gerenciador-de-quadras/.codex/get-shit-done/templates/project.md @C:/Users/gusta/OneDrive/Documentos/gerenciador-de-quadras/.codex/get-shit-done/templates/requirements.md </execution_context>

<process> Execute the new-project workflow from @C:/Users/gusta/OneDrive/Documentos/gerenciador-de-quadras/.codex/get-shit-done/workflows/new-project.md end-to-end. Preserve all workflow gates (validation, approvals, commits, routing). </process>

When not to use it

  • When the user wants to skip questioning, research, requirements, or roadmap generation
  • When the user does not need a new project initialized

Limitations

  • The skill expects an idea document via @ reference in --auto mode
  • The skill requires running $gsd-plan-phase 1 to start execution after initialization

How it compares

This skill provides a structured, unified workflow for new project initialization, including context gathering and documentation generation, which is more complete than simply creating a project directory.

Compared to similar skills

gsd-new-project side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
gsd-new-project (this skill)04moNo flagsBeginner
pmbok-project-management389moNo flagsIntermediate
project-planner329moReviewIntermediate
spec-kit-workflow118moNo flagsIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

pmbok-project-management

jgtolentino

Comprehensive PMP/PMBOK project management methodologies and best practices. Use this skill when users need guidance on project management processes, templates, knowledge areas, process groups, tools, techniques, or certification preparation. Covers all 10 PMBOK Knowledge Areas and 5 Process Groups with practical templates, frameworks, and industry-standard approaches. Includes risk management, stakeholder engagement, schedule management, cost control, quality assurance, and resource planning.

38183

project-planner

adrianpuiu

Comprehensive project planning and documentation generator for software projects. Creates structured requirements documents, system design documents, and task breakdown plans with implementation tracking. Use when starting a new project, defining specifications, creating technical designs, or breaking down complex systems into implementable tasks. Supports user story format, acceptance criteria, component design, API specifications, and hierarchical task decomposition with requirement traceability.

32115

spec-kit-workflow

jmanhype

Guides specification-driven development workflow. Automatically invoked when discussing new features, specifications, technical planning, or implementation tasks. Ensures proper workflow phases (specify → clarify → plan → checklist → tasks → analyze → implement).

11111

product-manager-toolkit

davila7

Comprehensive toolkit for product managers including RICE prioritization, customer interview analysis, PRD templates, discovery frameworks, and go-to-market strategies. Use for feature prioritization, user research synthesis, requirement documentation, and product strategy development.

3280

planning-agent

parcadei

Planning agent that creates implementation plans and handoffs from conversation context

531

pdd

mikeyobrien

Transforms a rough idea into a detailed design document with implementation plan. Follows Prompt-Driven Development — iterative requirements clarification, research, design, and planning.

66

Search skills

Search the agent skills registry