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.