kata-artifact-self-review

Evaluate agent-produced artifacts for completeness and submission readiness.

Updated Sep 3, 2025
One-click install
npx skills add https://github.com/guardiatechnology/design-system --skill kata-artifact-self-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kata-artifact-self-review
Source: https://github.com/guardiatechnology/design-system/tree/main/.claude/skills/kata-artifact-self-review
Command: npx skills add https://github.com/guardiatechnology/design-system --skill kata-artifact-self-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents agents from submitting incomplete or inconsistent artifacts by running a pre-human self-audit for placeholders, contradictions, ambiguity, structure, and tone.

Core Features & Use Cases

  • Placeholder scan: Detects unfinished markers like TBD/TODO/FIXME, template bracket text, and empty headings and records where they occur and what to do next.
  • Consistency checks: Verifies internal alignment between the stated law/objective, rules/workflow, declared inputs, and produced outputs.
  • Ambiguity and scope control: Flags vague quantifiers (e.g., many/several/fast) and checks that the artifact stays within the expected scope for a Kata/lexis-style document.
  • Multilingual equivalence verification: Confirms that section order, numbered rules, tables, and code tags remain equivalent across languages when applicable.
  • Returns a decision-ready report: Produces an APPROVED or RETURNED decision with categorized findings for auditability.

Quick Start

Ask the AI to run the self-review on your artifact titled lex-hard-gate-pattern.md and return an APPROVED or RETURNED decision with a structured report of findings.

Frequently Asked Questions about kata-artifact-self-review

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

FAQPage Schema
How do I run a self-review on a technical spec before human review?▼

To run a self-review on a technical spec, you need an automated pre-check that evaluates completeness, internal consistency, and submission readiness. This process detects placeholders, contradictions, and scope drift, returning an APPROVED or RETURNED decision with categorized findings.

What is artifact self-review and when do I need it for PRD or ADR documents?▼

Artifact self-review is an automated pre-human audit for PRD, ADR, or Lexis-style documents. You need it to prevent submitting incomplete artifacts by detecting placeholders, vague quantifiers, and structural gaps before a human evaluator reviews the content.

How do I check multilingual consistency in a technical document?▼

To check multilingual consistency in a technical document, verify that section order, numbered rules, tables, and code tags remain equivalent across languages. An automated self-review confirms this equivalence while detecting tone, terminology issues, and multilingual mismatches.

Does self-review software detect placeholders and scope drift in release plans?▼

Yes, self-review software detects placeholders like TBD or TODO and checks for scope drift in release plans. It scans for unfinished markers, template bracket text, and empty headings, verifying that the artifact stays within the expected document scope.

Can I use artifact auditing for Kata-style templates with numbered criteria?▼

You can use artifact auditing for Kata-style templates with numbered criteria. The self-review evaluates internal alignment between stated objectives, rules, declared inputs, and produced outputs, returning an explicit decision for submission readiness.

What are the limitations of automated consistency checks for technical writing?▼

Automated consistency checks for technical writing are limited to detecting quantifiable ambiguity, structural gaps, and template mismatches. They cannot replace human evaluation but instead produce a structured report returning an APPROVED or RETURNED decision to guide the human reviewer.