skills.rest
pcortes
pcortesCOMMUNITY
Explore all skills by this author →
GitHub

feature-spec-moderator

Classify peer feedback on engineering specs into ACCEPT, REJECT, DEFER, or PARTIAL decisions.

Updated Aug 23, 2026
Search Tags:#automation#software design#technical writing#quality improvement#spec revision#feedback integration#review process
One-click install
npx skills add https://github.com/pcortes/swarm-attack --skill feature-spec-moderator
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: feature-spec-moderator
Source: https://github.com/pcortes/swarm-attack/tree/main/default-skills/feature-spec-moderator
Command: npx skills add https://github.com/pcortes/swarm-attack --skill feature-spec-moderator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the iterative process of refining engineering specifications based on critic feedback. It automatically applies suggested changes, updates quality scores, and determines if a spec is ready for approval or needs further debate, saving significant time in the review cycle and ensuring high-quality documentation.

Core Features & Use Cases

  • Automated Spec Revision: Incorporates critic feedback to improve spec clarity, coverage, architecture, and risk sections.
  • Progress Tracking: Updates quality scores and tracks issues addressed versus remaining, providing a clear overview of spec improvement.
  • Approval Workflow Management: Determines if a spec meets predefined approval thresholds or requires further iteration, detecting stalemates.
  • Use Case: A feature spec receives feedback about missing rate limiting for an API. This Skill automatically revises the spec to include the suggested rate limiting details, updates the quality scores, and prepares it for the next review round, accelerating the approval process.

Quick Start

Revise the engineering specification at 'specs/user-auth/spec-draft.md' using the feedback provided in 'specs/user-auth/spec-review.json', then generate a new rubric assessment.

Frequently Asked Questions about feature-spec-moderator

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

FAQPage Schema
How do I automate spec revision based on peer feedback?▼

Spec revision automates incorporating critic feedback into engineering specifications by classifying suggestions into ACCEPT, REJECT, DEFER, or PARTIAL, updating quality scores, and determining approval readiness—eliminating manual review cycles and ensuring specs meet predefined thresholds.

What's the best way to manage feedback on technical specifications?▼

This skill streamlines feedback management by automatically applying valid suggestions, rejecting scope creep, maintaining PRD alignment, and tracking progress through quality score updates—accelerating approval workflows and detecting review stalemates.

Can I use spec review to ensure startup simplicity and scope control?▼

Yes. The skill critically evaluates feedback against startup engineering principles, accepting valid changes while rejecting scope creep, and provides concise decisions with rationale to maintain product focus during iterative spec refinement.

How does automated feedback classification improve spec quality?▼

Feedback classification into ACCEPT, REJECT, DEFER, and PARTIAL categories with summarized rationale enables clear decision-making on each suggestion, improves spec clarity and coverage, and accelerates the approval process by eliminating ambiguous feedback loops.

What metrics track spec improvement through the review cycle?▼

Quality scores update automatically as feedback is incorporated, tracking issues addressed versus remaining issues—providing visibility into spec progress and indicating when approval thresholds are met or further iteration is needed.

When should I defer feedback instead of accepting or rejecting it?▼

Defer feedback that lacks sufficient context, conflicts with current priorities, or requires architectural decisions beyond the current spec scope—deferring maintains review momentum while flagging items for future consideration or debate.

Related Skills

Explore More Software Engineering Skills→
Bhavya-DhootBhavya-Dhoot

aras-coherence-reviser

Revise LaTeX manuscripts by integrating reviewer feedback and improving coherence.

Community
Advanced
opsMachineopsMachine
1

diagnose

Inspect codebases and draft bug specifications for GitHub issues.

Official
Advanced
pradyumnasagarpradyumnasagar
6

roadmap-author

Guide authors through creating and validating ORS SKILL.md files.

Community
Intermediate
the-agency-aithe-agency-ai
39

PR Respond

Fetch unresolved GitHub pull request review comments and post threaded replies.

Official
Basic