skills.rest
ascerra-fullsend-rehearsal
ascerra-fullsend-rehearsalOFFICIAL
Explore all skills by this author →
GitHub

spec-refine

Integrate comments and questions into Markdown spec and Q&A files.

Updated May 31, 2026
Search Tags:#documentation#technical documentation#specification management#review feedback#specification refinement
One-click install
npx skills add https://github.com/ascerra-fullsend-rehearsal/fullsend --skill spec-refine
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-refine
Source: https://github.com/ascerra-fullsend-rehearsal/fullsend/tree/main/skills/spec-refine
Command: npx skills add https://github.com/ascerra-fullsend-rehearsal/fullsend --skill spec-refine

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The Skill helps organize and improve specifications for technical topics, consolidating feedback and ensuring up-to-date documentation.

Core Features & Use Cases

  • Feedback Consolidation: Merges feedback from various sources into a cohesive spec document.
  • Topic Directory Update: Ensures the spec and Q&A files reflect current discussion and decisions.
  • Self-Review: Performs a quality check to ensure the spec's accuracy and completeness.

Quick Start

To update a spec topic, run the 'spec-refine' skill on a directory in 'docs/plans/' that has existing 'spec.md' and 'qna.md' files.

Frequently Asked Questions about spec-refine

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

FAQPage Schema
How do I consolidate review comments into a technical specification?▼

Consolidating review comments into a technical specification is done by merging feedback and integrating questions into existing spec and Q&A Markdown files to update the documentation.

What is the best way to refine spec documentation from a topic directory?▼

Refining spec documentation from a topic directory involves processing existing Markdown files to aggregate review comments, updating the spec, and performing a self-review for quality assurance.

Does spec refinement work with standard Markdown files?▼

Spec refinement works specifically with Markdown files, requiring existing spec.md and qna.md files within a designated topic directory in docs/plans/ to process feedback and update documentation.

How do specification management tools handle Q&A files during a review?▼

Specification management tools handle Q&A files during a review by aggregating questions and comments, then updating the qna.md file alongside the main spec to reflect current decisions.

When do I need to perform a self-review on software development specifications?▼

A self-review on software development specifications is needed after merging feedback to ensure the updated documentation maintains accuracy, completeness, and reflects the latest organizational decisions.

Can I update multiple specification files at once in a topic directory?▼

Updating multiple specification files at once in a topic directory is supported by processing both spec.md and qna.md files simultaneously to reconcile comments and document updates.

Related Skills

Explore More Software Engineering Skills→
mattjeffersonmattjefferson
4

he-bootstrap

Initialize a repository with Harness Engineering directory structure and baseline documentation files.

Community
Basic
RheasilviaRheasilvia

code-wiki

Generate markdown wikis and Mermaid diagrams from software repositories.

Community
Advanced
nanorepublicananorepublica
61

Global Conventions

Apply global coding conventions during editing, generation, and review of Claude Code project files.

Community
Basic
VoDaiLoczVoDaiLocz
24

to-issues

Convert project plans and specifications into structured issue trackers.

Community
Advanced