skills.rest
Reading-Advantage-Thailand
Reading-Advantage-ThailandOFFICIAL
Explore all skills by this author →
GitHub

spec-authoring

Generate multi-file technical specification proposals and analyze pull request feedback.

Updated Sep 11, 2024
Search Tags:#workflow#documentation#github#specification#ai#gemini#pr
One-click install
npx skills add https://github.com/Reading-Advantage-Thailand/www-reading-advantage --skill spec-authoring-reading-advantage-thailand
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-authoring
Source: https://github.com/Reading-Advantage-Thailand/www-reading-advantage/tree/main/.claude-old/skills/spec-authoring
Command: npx skills add https://github.com/Reading-Advantage-Thailand/www-reading-advantage --skill spec-authoring-reading-advantage-thailand

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, significantly reducing the time and effort required for the spec-driven development workflow.

Core Features & Use Cases

  • Draft Generation: Automatically generates multi-file draft proposals (proposal.md, spec-delta.md, tasks.yml) for new features using the Gemini CLI.
  • Feedback Analysis: Synthesizes review comments from Spec PRs into actionable summaries, guiding efficient updates.
  • Use Case: When proposing a new "User Profile Page" feature, use this skill to generate the initial proposal documents and then to analyze feedback from the product manager on the draft PR.

Quick Start

Use the spec-authoring skill to propose a new feature called "User Authentication System".

Frequently Asked Questions about spec-authoring

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

FAQPage Schema
How do I automate technical specification generation for feature proposals?▼

Automating technical specification generation uses AI-powered CLI tools to create multi-file draft proposals, including high-level overviews, detailed technical deltas, and task breakdowns in YAML format, streamlining spec-driven development workflows.

What is the best way to analyze pull request feedback for specification updates?▼

Analyzing pull request feedback for specification updates involves synthesizing review comments from Spec PRs into actionable summaries, which guides efficient refinement of the proposal documents.

Do I need the Gemini CLI and gh installed to generate spec documents?▼

Yes, you need the Gemini CLI and gh installed, as the AI-powered specification generation and pull request feedback analysis rely on these dependencies to automate the creation and refinement of proposal documents.

Can I create a complete feature proposal with task breakdowns in YAML format?▼

Yes, you can create a complete feature proposal with task breakdowns in YAML format, as the workflow generates multi-file draft proposals containing proposal.md, spec-delta.md, and tasks.yml for new features.

How does AI synthesize actionable updates from GitHub PR review comments?▼

AI synthesizes actionable updates from GitHub PR review comments by analyzing the feedback on specification pull requests, extracting key points, and guiding the efficient modification of technical specification documents.

What files are included in a multi-file draft proposal for spec-driven development?▼

A multi-file draft proposal for spec-driven development includes a high-level overview in proposal.md, detailed technical deltas in spec-delta.md, and structured task breakdowns in tasks.yml to comprehensively document new features.

Related Skills

Explore More Software Engineering Skills→
zzafergokzzafergok
1

gemini-skill

Access Google Gemini models via CLI or API for reasoning and multimodal tasks.

Community
Advanced
Chronote-ggChronote-gg
4

pr-review-recycle

Automate addressing automated PR review feedback from Copilot, Greptile, and Codex.

Official
Advanced
xotongxotong

github-code-review

Coordinate specialized AI agents to review GitHub pull requests.

Community
Advanced
AgentPMTAgentPMT

project-task-manager

Generate hierarchical task breakdowns from high-level project objectives.

Official
Advanced