skills.rest
mistakenot
mistakenotCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

request-grok-review

Runs Grok CLI code reviews on task planning docs and resolves resulting comments.

Updated Apr 17, 2026
Search Tags:#code review#grok#task planning#review workflow#cli automation#comment resolution
One-click install
npx skills add https://github.com/mistakenot/skills --skill request-grok-review-mistakenot
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: request-grok-review
Source: https://github.com/mistakenot/skills/tree/main/plugins/planning-workflow/skills/request-grok-review
Command: npx skills add https://github.com/mistakenot/skills --skill request-grok-review-mistakenot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Getting a second opinion on task planning documents before execution requires manual copy-pasting into external tools and tracking feedback by hand. This Skill automates sending task docs to Grok CLI for review and ensures every comment it leaves gets formally resolved. ## Core Features & Use Cases - Headless Grok Review: Invokes Grok CLI in unattended mode with bypassed permissions to review task planning docs in docs/tasks/. - Comment Detection and Verification: Counts review threads in both Markdown (UNRESOLVED(P1) style) and HTML (<pd-thread>) formats, then verifies author replies exist after resolution. - Mandatory Comment Resolution: Automatically invokes resolve-comments after a successful review, enforcing append-only thread handling per the review format conventions. - Use Case: Before executing task 042, run this Skill to have Grok critique the plan, then automatically resolve each P1/P2/P3 comment so the doc is execution-ready. ## Quick Start Ask the agent to request a Grok review of task 042 and resolve any comments it leaves.

Frequently Asked Questions about request-grok-review

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

FAQPage Schema
How do I get Grok to review my task planning docs?▼

Run Grok CLI in headless mode with the --single flag pointing at the /review-task command for your task folder. This Skill handles the full invocation, including locating the task directory by numeric ID and capturing the output log.

How do I run Grok CLI unattended without permission prompts?▼

Pass both --permission-mode bypassPermissions and --always-approve so Grok can read and edit task docs without prompting. Note that --single takes the prompt as its immediate value, so no flags may appear between it and the prompt text.

What comment formats does the Grok review support?▼

Two formats are supported: Markdown HTML comments like UNRESOLVED(P1) with REVIEW and AUTHOR roles, and HTML <pd-thread> elements with status, priority, and anchor attributes. Both are append-only, meaning threads are never deleted or rewritten.

Why did the Grok review produce no comments?▼

If Grok exits non-zero or leaves zero comments, the Skill stops and reports failure rather than proceeding to resolution. Inspect the log file at /tmp/grok-<TASK_ID>-review.log to diagnose the cause.

Can I resolve Grok review comments by editing them directly?▼

No, comment handling is append-only per the review format conventions. You must invoke the resolve-comments skill, which appends AUTHOR replies and updates thread status instead of editing or deleting existing threads.

Related Skills

Explore More Software Engineering Skills→
bamechobamecho
1

design

Generate plan packages with risk assessment and task decomposition.

Community
Advanced
6BNBN6BNBN
134

executing-plans

Execute implementation plans in batches with human review checkpoints.

Community
Intermediate
hanamizukihanamizuki
127

second-opinion

Review plans, specs, and design docs with an adversarial perspective.

Community
Advanced
microsoftmicrosoft
19

migrating-adal-to-msal

Convert Azure AD authentication code from ADAL to MSAL.

Official
Advanced