ship-pil

Verify PIL script and plist edits, draft Linear evidence, and create PRs.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/GetFresh-Ventures/gxd-ceo-ai-kit --skill ship-pil
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship-pil
Source: https://github.com/GetFresh-Ventures/gxd-ceo-ai-kit/tree/main/skills/ship-pil
Command: npx skills add https://github.com/GetFresh-Ventures/gxd-ceo-ai-kit --skill ship-pil

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

End-to-end verification and governance for PIL changes, automatically validating edits, checking gate health, drafting Linear evidence, and opening a PR to close related issues after changes.

Core Features & Use Cases

  • Verification pipeline: validates edits to pil_*.py scripts and LaunchAgent plist deliveries, checks heartbeats, and ensures PR readiness.
  • Evidence and governance: automatically drafts a Linear evidence block summarizing changes and links to related issues.
  • Automation cycle: triggers PR creation and status checks to move work forward while maintaining auditable records.

Quick Start

Run ship-pil after modifying any pil_*.py script or LaunchAgent plist to automatically verify changes and prepare evidence for Linear and a PR.

Frequently Asked Questions about ship-pil

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

FAQPage Schema
How do I automate pull request creation and verification for Python script changes?

Automate pull request creation and verification by running ship-pil after modifying pil_*.py scripts to validate edits, draft Linear evidence, and open a PR to close related issues.

What is the best way to generate Linear evidence blocks for LaunchAgent plist deliveries?

Generate Linear evidence blocks for LaunchAgent plist deliveries by running ship-pil, which automatically drafts a governance summary linking changes to related issues during delivery-gate checks.

Do I need GitHub authentication to run delivery-gate checks and heartbeat validation?

Yes, GitHub authentication is a required precondition for delivery-gate checks and heartbeat validation, ensuring the automation cycle can trigger PR creation and status checks successfully.

Can I check heartbeat freshness before opening a pull request for PIL changes?

Yes, ship-pil enforces heartbeat freshness as a strict precondition during verification, ensuring delivery gate health is confirmed before drafting evidence and opening a pull request for PIL changes.

Why does my verification pipeline fail during delivery-gate checks for LaunchAgent plists?

Verification pipelines fail during delivery-gate checks when preconditions are unmet, such as missing GitHub authentication, stale heartbeat freshness, or unhealthy gate status blocking PR creation.