project-specify

Create or update project specifications from natural language descriptions.

2|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/telum-ai/speck --skill project-specify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-specify
Source: https://github.com/telum-ai/speck/tree/main/.cursor/skills/project-specify
Command: npx skills add https://github.com/telum-ai/speck --skill project-specify

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you define and document your project's scope, whether you're starting from scratch or working with an existing codebase. It ensures all critical aspects of the project are considered and clearly articulated.

Core Features & Use Cases

  • Greenfield Project Scoping: Guides users through defining a new project from a natural language description, identifying missing information, and suggesting recipes.
  • Brownfield Project Scoping: Analyzes existing code and documentation to pre-fill project specifications, highlighting areas that need further validation or strategic input.
  • Play Level Detection: Automatically infers the project's complexity (Sprint, Build, Platform) to tailor the specification process.
  • Use Case: A product manager wants to kick off a new feature. They describe the feature, and this Skill helps generate a comprehensive PRD, identifying necessary clarifications and potential architectural considerations.

Quick Start

Use the project-specify skill to create a new project specification from the description "Build a customer feedback portal".

Frequently Asked Questions about project-specify

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

FAQPage Schema
How do I create a project specification from a natural language description?

To create a project specification, you provide a natural language description of your initiative. The skill processes this input, infers complexity levels, detects applicable recipes, and interactively guides you through gap-filling to generate a comprehensive project.md document.

Can I generate a project specification for an existing codebase?

Yes, you can generate a specification for a brownfield project. The skill analyzes existing code and documentation artifacts to pre-fill the project specification, highlighting areas that require further validation or strategic domain expertise input.

What is the difference between greenfield and brownfield scoping in product development?

Greenfield scoping defines a new project from scratch by suggesting recipes from a natural language description. Brownfield scoping analyzes existing artifacts to pre-fill specifications, requiring validation rather than initial generation for product development.

How does play level detection work for project documentation?

Play level detection automatically infers project complexity as Sprint, Build, or Platform during documentation generation. This inference tailors the specification process, ensuring the resulting project.md matches the architectural scale and requirements of the initiative.

Do I need a detailed PRD to start scoping a new feature?

No, you do not need a detailed PRD to start scoping. You can supply a basic natural language description of the feature, and the skill will interactively guide gap-filling and domain expertise checks to produce the comprehensive specification.

What are the limitations of automated project scoping for complex platforms?

Automated scoping relies on natural language input and existing artifacts, meaning complex platform architectures may require significant interactive gap-filling. The skill highlights areas needing strategic input but cannot invent domain expertise absent from initial descriptions.