Where are the refinement files stored?

Refinement files are automatically created and committed within the project's memory directory using a standardized naming convention including timestamps and claims.

How does it handle human vs. AI comments differently?

Human comments generate specific questions for the user to answer, while AI annotations provide reasoning and multiple choice options to accept, reject, or modify the suggestion.

What happens if I don't provide feedback in a refinement file?

Items without feedback are skipped or deferred using a specific marker to be addressed later, ensuring that only confirmed changes are applied to the specification.

What are the two modes supported by the refine skill?

The skill supports Standard Mode, which creates a separate refinement file for asynchronous feedback, and Inline Mode for live, interactive resolutions in the terminal.

Eidos Spec Refinement

Name: Eidos Spec Refinement
Author: agenticnotetaking

byagenticnotetaking

•

Productivity & Workflow

Synchronizes intent and implementation by resolving inline annotations and AI-generated comments within Eidos specification files.

Eidos Spec Refinement streamlines the process of resolving ambiguities in specification files by identifying and processing {{comments}} and {{AI ...}} annotations. It offers two distinct workflows: a Standard Mode that creates dedicated refinement artifacts for asynchronous feedback, ensuring a persistent record of decisions, and an Inline Mode for rapid, interactive resolution of minor issues. By automating the extraction and tracking of these markers, the skill ensures that specifications remain accurate and up-to-date throughout the development lifecycle without losing context.

Key Features

01Intelligent grouping of related comments to minimize developer context switching

02Creation of timestamped refinement files to serve as persistent feedback surfaces

0336 GitHub stars

04Support for Inline Mode to resolve trivial comments and AI suggestions interactively

05Automated extraction of human comments and AI annotations with surrounding context

06Automatic synchronization of spec files based on resolved feedback and deferred items

Use Cases

01Collaborating on AI-generated suggestions to improve technical documentation and claims

02Resolving complex architectural questions in a spec file before beginning implementation

03Cleaning up legacy comments and TODOs within a Spec-Driven Development workflow

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add agenticnotetaking/eidos refine

For use in Claude.ai and ChatGPT

Download Skill