skills.rest
yoshisada
yoshisadaCOMMUNITY
Explore all skills by this author →
GitHub

kiln-pi-apply

Generate propose-don't-apply diff reports from GitHub retrospective PI blocks.

Updated Mar 26, 2026
Search Tags:#automation#github#audit#diff#report#pi#prompt-improvement
One-click install
npx skills add https://github.com/yoshisada/ai-repo-template --skill kiln-pi-apply
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kiln-pi-apply
Source: https://github.com/yoshisada/ai-repo-template/tree/main/plugin-kiln/skills/kiln-pi-apply
Command: npx skills add https://github.com/yoshisada/ai-repo-template --skill kiln-pi-apply

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Consolidates unresolved Prompt Improvement (PI) proposals from open GitHub retrospective issues into a single, reviewable propose-don't-apply diff report that is written to .kiln/logs/pi-apply-<timestamp>.md. It never edits source files in plugin-kiln/skills or plugin-kiln/agents, ensuring a safe, auditable feedback loop.

Core Features & Use Cases

  • Parse each PI block (File, Current, Proposed, Why PI) from open retro issues.
  • Classify blocks as actionable, already-applied, stale, or parse errors; include audit records for non-actionable items.
  • Render diffs for actionable blocks and compute a stable pi-hash for all records; emit a consolidated report for maintainer review.
  • Produce a deterministic, timestamped report at .kiln/logs/pi-apply-<timestamp>.md with no source edits.
  • Handle empty backlog and malformed blocks gracefully; maintain schema stability and safety discipline.

Quick Start

Run kiln-pi-apply to generate the propose-don't-apply diff report from open retro issues.

Frequently Asked Questions about kiln-pi-apply

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

FAQPage Schema
How do I consolidate GitHub retrospective issues into a single diff report?▼

This tool consolidates GitHub retrospective issues into a single diff report by fetching open issues, extracting PI blocks, and generating a propose-don't-apply report at .kiln/logs/pi-apply-<timestamp>.md without modifying source files.

What is a propose-don't-apply diff report for prompt improvement proposals?▼

A propose-don't-apply diff report is a deterministic timestamped audit file that renders diffs for actionable prompt improvement proposals and computes a stable pi-hash for all records, ensuring a safe auditable feedback loop for maintainers.

How do I parse File, Current, Proposed, and Why PI blocks from GitHub issues?▼

Parsing File, Current, Proposed, and Why PI blocks from GitHub issues is handled automatically by running the kiln-pi-apply tool, which classifies extracted blocks as actionable, already-applied, stale, or parse errors.

Can I filter GitHub retrospective issues by date when generating a PI report?▼

Filtering GitHub retrospective issues by date when generating a PI report is supported through the optional --since date flag, which restricts fetched issues to a specific timeframe for deterministic output.

Does the kiln-pi-apply diff report modify source files in the repository?▼

The diff report does not modify source files in the repository; it maintains safety discipline by emitting a consolidated report file under .kiln/logs and never editing skills or agents directories.

Related Skills

Explore More Software Engineering Skills→
terzigoluterzigolu
37

pr-comments

Fetch GitHub PR review comments and output them as structured JSON.

Community
Intermediate
yoshisadayoshisada

kiln-hygiene

Audit repositories against the Kiln structural-hygiene rubric and write a review preview to .kiln/logs.

Community
Advanced
yocxy2yocxy2

spec

Convert vague product requirements into structured GitHub issues and development worktrees.

Community
Advanced
masa-codehubmasa-codehub

managing-pull-requests

Automate GitHub pull request creation, rebasing, labeling, and review triggers.

Community
Advanced