Does it integrate with my existing version control?

Spec Refiner integrates deeply with GitHub by posting questions and refinement summaries directly to issue comments, keeping documentation synced with project discussions.

How does Spec Refiner handle unanswered questions?

If a user skips specific questions or provides partial answers, the skill applies best-effort reasoning to make informed decisions, which are then clearly documented in the final report and spec file.

What happens if the spec is already high quality?

If the AI determines the specification is already comprehensive and well-defined, it will return a 'skipped' status to avoid unnecessary cycles and noise.

Can I use Spec Refiner on any markdown file?

Yes, while it is optimized for the 'fractary-spec' format, it can critically analyze and refine any technical specification file provided in the workspace.

Spec Refiner

Name: Spec Refiner
Author: fractary

$fractary$ byfractary

•

生产力与工作流

Hardens software specifications through critical analysis, interactive user clarification, and automated documentation updates.

Spec Refiner is a specialized workflow skill for Claude Code that transforms raw or incomplete specifications into robust, actionable technical documents. It goes beyond simple editing by performing a critical analysis of requirements to identify gaps, ambiguities, and technical risks. The skill engages in a structured Q&A process with the user, integrates results directly into GitHub issues for team visibility, and maintains a versioned changelog within the specification file itself, ensuring that implementation starts with a clear and verified foundation.

主要功能

01Iterative refinement rounds to mature complex technical documentation

02Interactive CLI-based Q&A using the AskUserQuestion tool for specific feedback

032 GitHub stars

04Automated GitHub issue integration for persistent decision tracking

05Critical gap analysis to identify requirement ambiguities and technical risks

06Automatic changelog management and in-place specification updates

使用场景

01Resolving technical ambiguities in specs provided by stakeholders

02Maintaining a clear audit trail of requirement changes within GitHub

03Hardening initial project requirements before starting implementation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add fractary/claude-plugins spec-refiner

For use in Claude.ai and ChatGPT

主要功能

01Iterative refinement rounds to mature complex technical documentation

02Interactive CLI-based Q&A using the AskUserQuestion tool for specific feedback

032 GitHub stars

04Automated GitHub issue integration for persistent decision tracking

05Critical gap analysis to identify requirement ambiguities and technical risks

06Automatic changelog management and in-place specification updates

使用场景

01Resolving technical ambiguities in specs provided by stakeholders

02Maintaining a clear audit trail of requirement changes within GitHub

03Hardening initial project requirements before starting implementation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add fractary/claude-plugins spec-refiner

For use in Claude.ai and ChatGPT