gaia-fix-story

Fix open validation findings in story files and re-validate until ready-for-dev.

2|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/gaiastudio-ai/gaia-public --skill gaia-fix-story
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gaia-fix-story
Source: https://github.com/gaiastudio-ai/gaia-public/tree/main/plugins/gaia/skills/gaia-fix-story
Command: npx skills add https://github.com/gaiastudio-ai/gaia-public --skill gaia-fix-story

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Fixes open validation findings in a story file by applying targeted edits and re-running validation to reach ready-for-dev.

Core Features & Use Cases

  • Reads Val findings, rewrites affected sections, and preserves all required frontmatter fields.
  • Re-validates using gaia-val-validate to confirm clean state and transition toward ready-for-dev.
  • Automates the legacy fix-story workflow (Cluster 7) as a native Claude Code conversion, ensuring end-to-end consistency across iterations.

Quick Start

Provide a story key to process, then run /gaia-fix-story <story-key> to repair findings and re-validate until ready-for-dev.

Frequently Asked Questions about gaia-fix-story

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

FAQPage Schema
How do I fix validation findings in a story file and get it to ready-for-dev?

To fix validation findings in a story file, you apply targeted edits to the affected sections and re-run validation iteratively until the story reaches a ready-for-dev state.

How does story frontmatter consistency validation work during status transitions?

Story frontmatter consistency validation works by enforcing exact status transitions and preserving all mandated frontmatter fields while coordinating re-validation across multiple cycles.

What is the best way to automate fixing story artifacts tracked in implementation docs?

The best way to automate fixing story artifacts is to provide a story key and run an automated script that rewrites affected sections and verifies a clean state before transitioning status.

Why does my story file fail validation after applying frontmatter edits?

Story file validation may fail if the applied edits do not preserve all required frontmatter fields or if the status alignment does not follow the exact enforced status transitions.

Do I need a specific validation tool to re-validate story artifacts before development?

Yes, you need a validation tool like gaia-val-validate to verify a clean state and confirm that all frontmatter consistency and status alignment issues are resolved before transitioning to ready-for-dev.

Can I use automated story validation across multiple fix cycles without manual intervention?

Yes, you can use automated story validation across multiple cycles because the process iteratively applies targeted edits and re-runs validation until a clean state is reached automatically.