new

Create a curdx-flow spec directory with validated state and research output.

4|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/curdx/curdx-flow --skill new-curdx
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: new
Source: https://github.com/curdx/curdx-flow/tree/main/plugins/curdx-flow/skills/new
Command: npx skills add https://github.com/curdx/curdx-flow --skill new-curdx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns a single spec name and goal into a structured, durable spec folder that Claude Code can continue across restarts while enforcing validation and capturing the original goal.

Core Features & Use Cases

  • Creates a new spec directory with consistent state: Generates the spec folder, .curdx-state.json, .progress.md, and updates .current-spec and .gitignore entries.
  • Captures and validates inputs before execution: Enforces kebab-case spec names, supports optional --skip-research, and validates --specs-dir against configured roots.
  • Starts research with a dedicated agent and stops for review: Runs research-analyst to produce research.md, then stops to let the user verify findings before requirements begin.

Quick Start

Run /curdx-flow:new user-auth Add OAuth2 login and then review the generated research.md before continuing.

Frequently Asked Questions about new

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a spec directory with resumable state for Claude Code?▼

To create a spec directory with resumable state, provide a spec name and goal to initialize a structured folder containing .curdx-state.json and .progress.md, allowing Claude Code to safely resume delivery across restarts.

How do I start the research phase for requirements planning and skip it if needed?▼

To start the research phase for requirements planning, the Skill triggers an agent-driven research-analyst to output research.md. You can skip this phase by passing the optional --skip-research flag during spec creation.

Does spec creation enforce kebab-case names and validate the specs directory?▼

Yes, spec creation enforces kebab-case name validation for the provided spec name and validates the --specs-dir argument against configured roots to ensure multi-directory support and safe state initialization.

What is the workflow after the research phase generates research.md?▼

After the research phase generates research.md, the workflow halts execution. This stop mechanism lets you review and verify the research findings before beginning the requirements planning phase.

Can I use this for multi-directory spec discovery workflows?▼

Yes, you can use this for multi-directory spec discovery and planning workflows. It validates the target specs directory against configured roots and safely initializes state for controlled generation.