skills.rest
bodangren
bodangrenCOMMUNITY
Explore all skills by this author →
GitHub

spec-authoring

Generate and refine technical specification drafts from feature names and review comments.

11|3|Updated Oct 21, 2025
Search Tags:#workflow#pull request#specification#ai#drafting#gemini cli
One-click install
npx skills add https://github.com/bodangren/git-workflow --skill spec-authoring-bodangren
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-authoring
Source: https://github.com/bodangren/git-workflow/tree/main/.claude/skills/spec-authoring
Command: npx skills add https://github.com/bodangren/git-workflow --skill spec-authoring-bodangren

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, gemini, and includes scripts (resource) components.

What problem does it solve?

This Skill streamlines the creation and refinement of feature specifications by leveraging AI to generate initial drafts and synthesize review feedback, significantly accelerating the spec-driven development workflow.

Core Features & Use Cases

  • Draft Generation: Automatically creates multi-file draft proposals (proposal.md, spec-delta.md, tasks.yml) from a feature name.
  • Feedback Synthesis: Analyzes Pull Request comments and provides actionable summaries for updating specifications.
  • Use Case: When starting a new feature, use the propose command to generate a complete set of draft documents. After a review, use the update command with the PR number to get AI-driven suggestions for incorporating feedback.

Quick Start

Use the spec-authoring skill to propose a new feature called "User Profile Management".

Frequently Asked Questions about spec-authoring

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

FAQPage Schema
How do I automate drafting technical specifications with AI?▼

Automating technical specification drafting uses AI-powered tools like the Gemini CLI to generate multi-file proposals, spec deltas, and task lists from a feature name, accelerating the spec-as-code workflow.

How do I synthesize pull request review comments for specification updates?▼

Synthesizing pull request review comments involves analyzing PR feedback using AI to produce actionable summaries, which are then used to iteratively update and refine the technical specification documents.

What files are generated when creating a new feature specification?▼

Creating a new feature specification generates a complete set of draft documents including proposal.md, spec-delta.md, and tasks.yml to establish the initial technical proposal and actionable work items.

Do I need the Gemini CLI and gh installed to manage spec PRs?▼

Yes, managing the spec PR workflow requires both the gh command line tool and the Gemini CLI to be installed, as these dependencies drive the automated proposal drafting and review synthesis processes.

What is the spec-as-code workflow for feature development?▼

The spec-as-code workflow treats feature specifications as versioned documents, automating initial draft generation and using AI to synthesize pull request comments for iterative spec refinement.

Related Skills

Explore More Software Engineering Skills→
tile-aitile-ai
346

tilelang-github-operations

Install GitHub CLI and create pull requests via authenticated workflows.

Official
Advanced
forztfforztf
9

openspec-proposal-creation-cn

Generate OpenSpec change proposals with proposal.md, tasks.json, and spec-delta.md.

Community
Advanced
lklimeklklimek
1

review-loop

Automate the GitHub pull request peer review cycle with iterative feedback resolution.

Community
Advanced
Luney-IndustriesLuney-Industries
4

address-pr-comments

Categorize GitHub pull request comments and generate action plans.

Official
Advanced