Spec Authoring FAQs

Question 1

What is the Spec Authoring skill for Claude Code?

Accepted Answer

The Spec Authoring skill is a specialized AI capability designed to automate the creation of high-quality technical specifications. It uses the Gemini CLI to generate drafts and synthesize feedback from GitHub Pull Requests, streamlining the spec-driven development process.

Question 2

What specific files does this skill generate?

Accepted Answer

The 'propose' command generates a comprehensive three-file draft: a 'proposal.md' for high-level overviews, a 'spec-delta.md' for technical requirements and design decisions, and a 'tasks.md' for preliminary implementation tracking.

Question 3

What are the prerequisites for using Spec Authoring?

Accepted Answer

To use this skill effectively, your project should follow the SynthesisFlow structure (using docs/specs/ and docs/changes/ directories). You also need the GitHub (gh) CLI and the Gemini CLI installed and authenticated on your local system.

Question 4

When should I use this skill?

Accepted Answer

Use this skill whenever you are proposing a new feature or a significant architectural change. It is ideal for generating first drafts of proposals, technical spec-deltas, and implementation task lists, as well as when you need to quickly process large amounts of PR review feedback.

Question 5

How does it improve the developer workflow?

Accepted Answer

It significantly reduces the 'blank page' problem by providing a multi-file starting point for new features. Additionally, it automates the tedious process of manual feedback synthesis, turning scattered PR comments into a clear, actionable plan for updates.

Spec Authoring

Spec Authoring

Key Features

Use Cases

Key Features

Use Cases