to-spec

Generate project issue tracker-ready specs from conversations and codebase context.

80|21|Updated Dec 2, 2025
One-click install
npx skills add https://github.com/alfredoperez/speckit-companion --skill to-spec-alfredoperez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: to-spec
Source: https://github.com/alfredoperez/speckit-companion/tree/main/examples/todo-matt-skills/.claude/skills/to-spec
Command: npx skills add https://github.com/alfredoperez/speckit-companion --skill to-spec-alfredoperez

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill turns your existing conversation into a detailed spec, facilitating seamless communication and project planning.

Core Features & Use Cases

  • Synthetic Spec Creation: Generate project issue tracker-ready specs from discussion context.
  • Contextual Codebase Understanding: Utilizes the current codebase state and domain glossary.
  • Test Seam Sketching: Offers guidance on test seams and existing module usage.
  • Template-Based Writing: Guides users through structured spec writing with templates.

Quick Start

Generate a spec from the current conversation using /to-spec.

Frequently Asked Questions about to-spec

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

FAQPage Schema
How do I generate project specifications from chat conversations for issue tracking?

To generate project specifications from chat, the skill synthesizes existing conversations and codebase insights into structured spec templates. It formulates precise requirements suitable for direct integration into issue trackers and project management workflows.

Can I create issue tracker-ready specs using my current codebase context?

Yes, you can create issue tracker-ready specs using your current codebase context. The skill analyzes the existing codebase state and domain glossary to formulate accurate project requirements directly from your development environment.

What is the best way to write AI-assisted specs for project planning?

The best way to write AI-assisted specs for project planning is using structured template generation. The skill guides you through synthetic spec creation, formulating requirements from discussion context while sketching test seams for existing modules.

How does test seam analysis work during specification generation?

Test seam analysis during specification generation works by evaluating your current codebase modules. The skill sketches test seams and offers guidance on existing module usage, ensuring your generated specs align with actual code architecture.

Do I need a specific template format to turn conversations into specs?

You do not need a specific external template format to turn conversations into specs. The skill provides built-in template-based writing, guiding you through structured spec creation tailored for AI-assisted development workflows.

When should I not use automated spec generation for issue tracking?

You should not use automated spec generation for issue tracking when your conversation lacks sufficient technical context. The skill relies on existing discussion and codebase insights to synthesize requirements, so unstructured chats yield incomplete specifications.