skills.rest
slusset
slussetCOMMUNITY
Explore all skills by this author →
GitHub

pr-review

Validate IDD traceability and front-matter on PR diffs.

1|Updated Feb 8, 2026
Search Tags:#certification#traceability#ci-cd#code-review#pull-request#front-matter#idd
One-click install
npx skills add https://github.com/slusset/intention-driven-design --skill pr-review-slusset
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pr-review
Source: https://github.com/slusset/intention-driven-design/tree/main/skills/pr-review
Command: npx skills add https://github.com/slusset/intention-driven-design --skill pr-review-slusset

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

PR review is the gate that ensures alignment between intent and implementation. This Skill automates IDD compliance checks at the PR boundary to catch drift in traceability, front-matter consistency, and capability scope before merging.

Core Features & Use Cases

  • Deterministic front-matter validation on new/modified files (presence of id and type, plus required links).
  • Traceability and orphan artifact checks across stories, features, contracts, and endpoints.
  • Capability scope validation to ensure changes are reflected in relevant capabilities.
  • Layered PR review flow: fast deterministic checks plus optional semantic review for deeper drift detection.
  • Use Case: integrate as a GitHub Action on PRs to prevent merges when critical IDD gaps exist.

Quick Start

Provide the PR diff to this skill to run deterministic checks and receive a compliance report.

Frequently Asked Questions about pr-review

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

FAQPage Schema
How do I enforce traceability compliance on a pull request diff?▼

To enforce traceability compliance on a pull request diff, provide the diff to run deterministic checks validating front-matter and traceability across stories, features, contracts, and endpoints before merging.

What is IDD compliance checking in a CI/CD pipeline?▼

IDD compliance checking in a CI/CD pipeline validates front-matter consistency and capability scope on modified files to prevent intent and implementation drift before merging.

Can I integrate automated code review checks as a GitHub Action?▼

Yes, you can integrate automated code review checks as a GitHub Action to prevent merges when critical IDD gaps exist and generate actionable PR comments.

Does PR review support semantic drift detection or only deterministic validation?▼

PR review supports both deterministic validation for required front-matter fields and optional semantic review to surface deeper alignment gaps and generate actionable PR comments.

What do I need to provide to run front-matter validation on changed artifacts?▼

You need to provide the PR diff to run front-matter validation, which checks for the presence of id and type fields plus required links to identify orphan artifacts across changed files.

Related Skills

Explore More Software Engineering Skills→
sayalinvidiasayalinvidia

mcore-cicd

Configure and validate Megatron-LM CI/CD pipelines and PR labeling rules in GitLab.

Community
Intermediate
westnwestn
1

review

Identify structural issues in diffs and PR context before merging.

Community
Advanced
murphytruemanmurphytrueman
155

cicd-integration

Generate CI/CD pipeline configurations for design system quality checks.

Community
Advanced
stephendolanstephendolan
2

writing-documentation

Review Markdown documentation for structure, formatting, and consistency.

Community
Basic