skills.rest
KamiJeong
KamiJeongCOMMUNITY
Explore all skills by this author →
GitHub

speckit-docguard-diagnose

Diagnoses Spec Kit documentation validation failures and generates AI-ready remediation prompts.

Updated May 18, 2026
Search Tags:#documentation#validation#remediation#diagnose#spec kit#docguard
One-click install
npx skills add https://github.com/KamiJeong/tech-bridge-book --skill speckit-docguard-diagnose
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-docguard-diagnose
Source: https://github.com/KamiJeong/tech-bridge-book/tree/main/.agents/skills/speckit-docguard-diagnose
Command: npx skills add https://github.com/KamiJeong/tech-bridge-book --skill speckit-docguard-diagnose

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly diagnose documentation validation problems in a Spec Kit project and turn them into actionable AI-ready remediation prompts, so you can move from failing checks to clear fixes without manual guesswork.

Core Features & Use Cases

  • DocGuard diagnosis: Runs DocGuard against the current project or a specified directory to surface errors and warnings.
  • Remediation guidance: Produces an ordered fix plan so you know what to address first.
  • AI-ready prompts: Generates copy-paste prompts for an AI assistant, including optional multi-perspective debate prompts for deeper analysis.
  • Use case: A project maintainer can validate a Spec Kit repository, inspect the failure report, and immediately hand the generated prompt to an AI agent to repair documentation issues.

Quick Start

Use this skill to diagnose the current project’s documentation issues and generate a fix prompt for the failing checks.

Frequently Asked Questions about speckit-docguard-diagnose

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

FAQPage Schema
How do I diagnose documentation validation failures in a Spec Kit project?▼

To diagnose documentation validation failures, you can run a DocGuard check against your current project or a specified directory to surface errors and warnings. The skill then categorizes these issues and generates an ordered remediation plan.

How do I generate AI-ready prompts to fix documentation issues?▼

Generating AI-ready prompts involves diagnosing validation failures and outputting copy-paste fix instructions for an AI assistant. You can use optional debate-mode analysis to produce deeper, multi-perspective remediation prompts for automated repair workflows.

Does DocGuard diagnosis work with directories outside the current project?▼

DocGuard diagnosis works with alternate directories by allowing you to specify a target path during execution. This enables you to validate Spec Kit structures and generate fix prompts for projects located outside your current working directory.

What is the best way to repair failing guard checks in a .specify repository?▼

Repairing failing guard checks is best handled by diagnosing the failures to produce an ordered fix plan. This plan prioritizes issues and provides AI-ready remediation prompts so you can hand the guidance directly to an AI agent for documentation repair.

Do I need the DocGuard CLI installed to diagnose Spec Kit documentation issues?▼

You need the DocGuard CLI installed because the diagnosis requires its execution to apply guard checks to .specify structures. The CLI surfaces the validation failures that this skill categorizes and turns into actionable remediation prompts.

Related Skills

Explore More Content & Communication Skills→
KamiJeongKamiJeong

speckit-docguard-review

Diagnose DocGuard validation failures and generate AI-ready remediation prompts.

Community
Intermediate
nagashima-torunagashima-toru

verify

Run Maven verify to detect architecture test failures and dependency issues.

Community
Intermediate
WayneSHCWayneSHC
1

speckit-checklist

Generate custom checklists to validate feature requirements in spec-kit projects.

Community
Advanced
docs-plusdocs-plus
88

scaffold-exercises

Generate standardized exercise directory structures with required subfolders and stub files.

Official
Intermediate