botoolagent-jsonreview

Validate dev.json against prd.md and apply deterministic fixes.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Botool-Dev-Team/BotoolAgent --skill botoolagent-jsonreview
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: botoolagent-jsonreview
Source: https://github.com/Botool-Dev-Team/BotoolAgent/tree/main/skills/BotoolAgent/JSONReview
Command: npx skills add https://github.com/Botool-Dev-Team/BotoolAgent --skill botoolagent-jsonreview

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill audits the structure of dev.json, ensures sessions cover all tasks, and validates alignment with prd.md, then cleans up inconsistencies by applying safe, automatic repairs instead of only emitting warnings.

Core Features & Use Cases

  • Structure validation of dev.json against required fields (project, branchName, description, devTasks).
  • Automatic session assignment to orphan development tasks, preserving dependency and phase constraints.
  • PRD-cross-check to identify missing coverage and auto-generate new DT entries when needed.
  • Use Case: In a multi-team project, run the review to produce a consistent, executable plan and updated dev.json ready for execution.

Quick Start

Run /botoolagent-jsonreview <projectId> to start the review and auto-fix process for the active project.

Frequently Asked Questions about botoolagent-jsonreview

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

FAQPage Schema
How do I validate dev.json against a PRD file?

Validating dev.json against a PRD file requires cross-checking required fields, session assignments, and task coverage. This skill identifies gaps between dev.json and prd.md, applying deterministic fixes to ensure complete session coverage and alignment.

What is the best way to auto-fix orphan development tasks in dev.json?

Auto-fixing orphan development tasks in dev.json involves automatically assigning sessions while preserving dependency and phase constraints. This skill performs safe write-backs to dev.json, cleaning up inconsistencies by applying deterministic repairs instead of only emitting warnings.

Can I automatically generate missing development task entries from a markdown PRD?

You can automatically generate missing development task entries from a markdown PRD. The skill performs a PRD-cross-check to identify missing coverage and auto-generates new dev task entries when needed, returning a structured review and logging changes.

How do I ensure safe write-back to dev.json without losing project data?

Ensuring safe write-back to dev.json requires applying deterministic fixes that preserve project data and maintain compatibility with the root copy. This skill audits the structure, applies automatic repairs, and logs all changes while ensuring no data loss.

Does dev.json validation check for required fields like branchName and description?

Yes, dev.json validation checks for required fields like branchName and description. The structure validation ensures all required fields including project, branchName, description, and devTasks are present and correctly aligned before applying any automatic repairs.

Why does dev.json session coverage show inconsistencies in a multi-team project?

Dev.json session coverage shows inconsistencies in multi-team projects when tasks lack proper session assignments or PRD alignment. Running a review identifies these gaps and auto-fixes them to produce a consistent, executable plan and updated dev.json ready for execution.